콘텐츠로 이동

인덱스


인덱스는 로그 필드, 메트릭 태그 등의 핵심 특징을 추출하여 특징 값과 원본 데이터를 연결함으로써 효율적인 검색을 지원하고 비효율적인 전체 스캔을 방지합니다.

여러 인덱스를 생성하고 관리하면 시스템은 사전에 설정된 필터 조건에 따라 로그 데이터를 해당 인덱스에 자동으로 보관합니다. 또한 각 인덱스의 데이터 저장 정책을 맞춤 설정하여 저장 비용을 효과적으로 통제하고 절감할 수 있어 데이터 관리 유연성과 경제성을 동시에 확보할 수 있습니다.

생성

Guance는 세 가지 인덱스 유형을 생성하거나 바인딩할 수 있습니다.

인덱스 유형
정의
핵심 특징 및 데이터 흐름
제어권 소유
로그 인덱스 Guance의 기본 로그 저장 단위입니다. 로그 데이터가 업로드되면 시스템이 사전 설정된 규칙(일치 조건, 필터 등)에 따라 자동으로 분류하여 일치하는 인덱스에 저장합니다. 규칙 기반 자동 분류

수집기 → Guance 통합 수신 → 규칙에 따라 분류 → 대상 인덱스에 쓰기
Guance 플랫폼 콘솔
(인덱스 규칙을 구성하여 제어)
네이티브 직접 쓰기 인덱스 수집기에서 대상 인덱스 이름을 직접 지정하는 쓰기 방식입니다. 데이터는 플랫폼의 기본 분류 규칙을 거치지 않고 지정된 인덱스에 직접 기록됩니다. 대상 지정 직접 쓰기

수집기(인덱스 이름 지정) → 대상 인덱스에 직접 쓰기
수집기 설정
(DataKit 등 수집단 설정에서 지정)
외부 인덱스 Guance가 제공하는 데이터 소스 간 조회 통합 기능입니다. 바인딩 승인을 통해 외부 데이터 소스(예: 자체 구축 ES)를 워크스페이스 내에서 통합 조회할 수 있는 논리적 인덱스로 매핑합니다. 외부 데이터 소스 바인딩 및 통합 조회

데이터는 외부에 저장되고, Guance는 조회 채널을 구축하여 검색합니다.
외부 데이터 소스 시스템
(데이터 소유권과 저장 관리는 모두 외부에 있음)

데이터가 Guance에 수집되면 시스템은 규칙에 따라 데이터를 인덱스로 분배하거나 다른 타사 시스템으로 전달하여 데이터 처리 효율을 높이고 데이터 다중 분배 요구를 충족합니다.

인덱스 관리

다음 작업을 통해 인덱스 목록을 관리할 수 있습니다.

인덱스 내보내기

해당 인덱스 유형 목록에서 오른쪽 상단의 "내보내기" 버튼을 클릭하면 해당 인덱스의 JSON 파일을 내보낼 수 있습니다.

인덱스 가져오기

로컬 인덱스 설정 파일 가져오기를 지원합니다.

로그 인덱스 매핑

로그 인덱스 매핑은 상세 데이터의 필드 값을 기반으로 상세 페이지의 연관 조회에 사용할 기본 로그 인덱스를 자동으로 선택하는 기능입니다.

주의

로그 인덱스 매핑은 상세 페이지의 연관 로그 조회에만 영향을 미치며 로그가 인덱스에 기록될 때의 일치 조건에는 영향을 주지 않습니다.

설정 진입

로그 > 인덱스로 이동하여 로그 인덱스 매핑을 클릭하면 필드 값과 기본 로그 인덱스 간의 매핑 관계를 생성하고 관리할 수 있습니다.

설정 방법

각 매핑에는 다음이 포함됩니다.

  • 일치 필드: 상세 데이터의 필드 이름(예: app_id, source, service, env, version)
  • 필드 값: 일치 여부를 판단하는 데 사용되는 필드 값
  • 기본 로그 인덱스: 필드 값이 일치할 때 조회할 로그 인덱스

설정 예시:

일치 필드 필드 값 기본 로그 인덱스
app_id KKHome com_kkhome_kksecurity
source df_rum_ios_log ios-security-log
service front-backend sm-test-front-backend

기존 "서비스 일치" 기능을 구성하려면 일치 필드를 service로 설정한 다음 서비스 이름과 해당 로그 인덱스를 입력하세요.

연관 조회

설정이 적용된 후 RUM, APM 등 데이터 상세 페이지에서 연관 로그를 확인하면 시스템이 현재 상세 데이터의 필드를 읽고 일치하는 모든 사용 가능한 로그 인덱스를 자동으로 선택합니다.

로그 수량 통계와 로그 목록 조회는 동일한 인덱스 일치 결과를 사용하므로 수량과 목록 내용이 항상 일치합니다.

필드 값 일치

필드 값은 다음 방식으로 구성할 수 있습니다.

  • 정확히 일치: 예: front-backend
  • 다중 값 일치: 여러 값을 영어 쉼표로 구분, 예: api,web
  • 와일드카드 일치:
    • *: 0개 이상의 임의 문자와 일치
    • ?: 임의의 한 문자와 일치

다중 규칙 일치

시스템은 모든 매핑 규칙을 확인하고 일치하는 모든 사용 가능한 로그 인덱스를 병합합니다.

  • 동일한 필드 값이 여러 매핑에 일치하면 해당 인덱스를 모두 조회합니다
  • 정확히 일치 규칙과 와일드카드 규칙이 동시에 일치하면 해당 인덱스를 모두 병합합니다
  • 여러 규칙이 동일한 인덱스를 가리키면 시스템이 자동으로 중복을 제거합니다
  • 로그 수량 통계와 로그 목록 조회는 동일한 인덱스 집합을 사용합니다

예시:

일치 필드 필드 값 기본 로그 인덱스
service api-* application-log
service api-order order-log

현재 서비스가 api-order인 경우 시스템은 application-log와 order-log를 동시에 조회합니다.

인덱스 상태 제어

  • 인덱스 비활성화: 이후 로그는 해당 인덱스로 유입되지 않으며 계속 다른 인덱스를 매칭하여 저장됩니다. 다른 인덱스가 일치하지 않으면 기본 default 인덱스에 저장됩니다
  • 인덱스 활성화: 이후 로그는 다시 해당 인덱스로 유입되어 저장됩니다

인덱스 설정 편집

생성된 로그 인덱스 설정을 편집할 수 있습니다.

주의

저장 정책을 변경하면 인덱스의 데이터가 삭제되므로 주의하시기 바랍니다.

인덱스 삭제

삭제할 인덱스의 삭제 아이콘을 클릭하고 확인 팝업에서 해당 인덱스의 이름을 입력한 다음 삭제를 확인합니다.

주의
  • 삭제 후 해당 인덱스의 로그 데이터도 함께 삭제됩니다. 다른 일치 인덱스가 없으면 이후 업로드되는 로그 데이터는 기본 인덱스 default에 저장됩니다
  • 삭제된 인덱스가 다른 워크스페이스에 조회 권한으로 승인된 경우, 삭제 후 해당 워크스페이스에서는 더 이상 이 인덱스를 조회할 수 없습니다
  • 로그 인덱스 삭제 후 필요에 따라 동일한 이름의 인덱스를 다시 생성할 수 있습니다

인덱스 정렬

편집 모드를 클릭하면 생성된 로그 인덱스의 순서를 위아래로 드래그하여 조정할 수 있습니다. 단일 선택 및 다중 선택을 지원하며 페이지를 넘나드는 순서 조정도 가능하여 하나 또는 여러 인덱스를 지정된 위치로 이동할 수 있습니다.

주의

로그는 가장 먼저 일치하는 인덱스로 유입됩니다. 인덱스 순서를 변경하면 로그의 흐름이 달라질 수 있습니다.

작업 감사

감사 아이콘을 클릭하면 해당 인덱스에 대한 모든 작업 로그를 확인할 수 있습니다.

문서 평가

이 페이지가 도움이 되었나요?