콘텐츠로 이동

로그 상세 정보


로그 목록에서 단일 로그의 왼쪽 확장 아이콘을 클릭하면 현재 로그의 상세 페이지가 열리며 로그 발생 시간, 호스트, 소스, 서비스, 콘텐츠, 확장 필드, 컨텍스트 보기 등 다양한 정보를 확인할 수 있습니다.

전체 로그 보기

로그가 Guance에 업로드될 때 단일 로그 데이터가 1M를 초과하면 시스템이 1M 기준으로 로그를 여러 개로 분할합니다. 예를 들어 2.5M 로그는 각각 1M, 1M, 0.5M인 3개로 분할됩니다. 분할된 로그는 다음 필드를 통해 전체 여부를 확인할 수 있습니다.

필드
유형 설명
__truncated_id string 로그의 고유 식별자를 나타내며, 분할된 여러 로그는 동일한 __truncated_id를 사용합니다. ID 접두사는 LT_xxx입니다.
__truncated_count number 분할된 로그의 총 개수를 나타냅니다.
__truncated_number number 로그의 분할 순서를 나타내며 0부터 시작합니다. 0은 로그의 첫 번째 조각을 의미합니다.

로그 상세 페이지에서 현재 로그가 여러 개로 분할된 경우 페이지 오른쪽 상단에 전체 로그 보기 버튼이 표시됩니다. 이 버튼을 클릭하면 새 페이지가 열리고 로그의 분할 순서에 따라 모든 관련 로그가 나열됩니다. 또한 페이지에서는 이동 전에 선택한 로그를 색상으로 표시하여 상하위 로그를 빠르게 찾을 수 있도록 합니다.

Obsy Copilot 오류 분석

Guance는 오류 로그를 원클릭으로 해석하는 기능을 제공합니다. 대규모 언어 모델을 활용하여 로그에서 핵심 정보를 자동으로 추출하고, 온라인 검색 엔진 및 운영 지식 베이스와 결합하여 가능한 장애 원인을 빠르게 분석하고 초기 해결 방안을 제시합니다.

  1. 상태가 error인 모든 로그를 필터링합니다.

  2. 단일 데이터를 클릭하여 상세 페이지를 펼칩니다.

  3. 오른쪽 상단의 Obsy Copilot 오류 분석을 클릭합니다.

  4. 이상 분석이 시작됩니다.

오류 상세 정보

현재 로그에 error_stack 또는 error_message 필드 정보가 포함된 경우 시스템은 해당 로그와 관련된 오류 상세 정보를 제공합니다.

더 많은 로그 오류 정보를 확인하려면 로그 오류 추적을 참조하세요.

속성 필드

속성 필드를 클릭하여 빠르게 필터링하고 확인할 수 있으며, 로그와 관련된 호스트, 프로세스, 분산 추적, 컨테이너 데이터를 조회할 수 있습니다.

필드 설명
필드 값 필터링 해당 필드를 로그 탐색기에 추가하여 해당 필드와 관련된 모든 로그 데이터를 조회합니다.
필드 값 역필터링 해당 필드를 로그 탐색기에 추가하여 해당 필드를 제외한 기타 관련 로그 데이터를 조회합니다.
표시 열에 추가 해당 필드를 탐색기 목록에 추가하여 확인합니다.
복사 해당 필드를 클립보드에 복사합니다.
관련 컨테이너 보기 해당 호스트와 관련된 모든 컨테이너를 조회합니다.
관련 프로세스 보기 해당 호스트와 관련된 모든 프로세스를 조회합니다.
관련 분산 추적 보기 해당 호스트와 관련된 모든 분산 추적을 조회합니다.
관련 점검 데이터 보기 해당 호스트와 관련된 모든 점검 데이터를 조회합니다.

로그 내용

로그 내용은 message 유형에 따라 JSON과 텍스트 보기 모드를 자동으로 전환합니다. 로그 상세 정보는 인덱스 모드와 로그 필드에 따라 로그 내용을 표시합니다.

  • 로그에 message가 있는 경우 message 내용을 우선 표시하고, 내용 유형에 따라 JSON 또는 텍스트 모드로 전환합니다.
  • 전체 행 인덱스 로그에 message가 없는 경우 시스템은 현재 로그의 비즈니스 필드 조합을 사용하여 로그 내용을 표시합니다.
  • 시스템 필드는 전체 행 인덱스 로그 내용의 일부로 포함되지 않습니다.
  • 로그 내용은 펼치기와 접기를 지원하며, 기본적으로 펼쳐진 상태이고 접으면 한 줄만 표시됩니다.

로그 내용은 펼치기와 접기를 지원하며, 기본적으로 펼쳐진 상태이고 접으면 한 줄 높이만 표시됩니다.

source:bpf_net_l4_log 로그의 경우 JSON과 패킷 두 가지 보기 모드가 자동으로 제공됩니다. 패킷 모드에서는 클라이언트, 서버, 시간 등의 정보를 표시하며 절대 시간과 상대 시간 표시를 전환할 수 있습니다. 기본값은 절대 시간입니다. 전환된 설정은 로컬 브라우저에 저장됩니다.

AI 파싱 필드

로그 내용 영역의 AI 파싱 필드를 클릭하면 전체 로그를 파싱하거나, 팝업에서 원문 일부를 드래그하여 추출된 필드 이름, 유형, 필드 값을 미리 볼 수 있습니다. 유지할 필드를 확인한 후 새 탭에서 Pipeline 생성 페이지로 이동하여 미리 채워진 구성과 파싱 규칙을 계속 조정하고, 필요에 따라 테스트한 뒤 저장할 수 있습니다.

사용 전에 워크스페이스 AI 기능을 활성화하고 Pipeline 관리 권한이 있어야 합니다. 생성 결과는 초안으로만 제공되며, 저장한 후에야 Pipeline 구성에 따라 이후 로그가 처리됩니다. 전체 작업流程은 로그 상세 정보에서 필드 파싱 및 Pipeline 생성을 참조하세요.

로그 조각 선택

조각 작업을 지원하는 로그 내용에서는 중국어 또는 중국어-영어 혼합 조각을 클릭하여 메뉴를 통해 필터링, 역필터링 또는 복사를 실행할 수 있습니다. 조각을 클릭하면 메뉴만 열리며, 필터링 작업을 선택한 후에 쿼리가 업데이트됩니다.

선택 범위는 텍스트 형식과 표시 위치에 따라 달라집니다.

콘텐츠 유형 선택 규칙
일반 텍스트 공백과 일반적인 문장 부호로 구분됩니다. 중국어 쉼표, 마침표, 세미콜론, 콜론, 느낌표, 물음표, 모점, 괄호, 모서리 괄호, 서적명 부호 및 인용 부호 등이 구분 기호가 될 수 있으며, 영어 인용 부호, 물음표, 등호, 쉼표 및 괄호 등도 조각을 구분할 수 있습니다. 연속된 중국어는 단어 의미에 따라 자동으로 분할되지 않습니다.
식별자, 경로, IP, 시간 등 특정 형식 해당 형식에 따라 인식되며, 그 안의 _, -, /, : 등의 연결 기호는 선택 내용에 유지될 수 있어 무조건 기호에 따라 분할되지 않습니다.
URL 전체적으로 인식되며 URL 내부의 ?, =, &, # 등의 기호가 유지됩니다. 공백, 영어 인용 부호 또는 꺾쇠 괄호를 만나면 URL 인식이 종료됩니다.

예를 들어 일반 텍스트 用户登录失败,请重试。에서는 '用户登录失败' 또는 '请重试'를 선택할 수 있으며, 调用API失败 请稍后重试에서는 공백으로 구분된 '调用API失败'과 '请稍后重试' 두 조각을 각각 선택할 수 있습니다. URL https://example.com/search?q=日志&limit=10#result는 전체적으로 인식되며 내부의 쿼리 파라미터나 조각 식별자로 인해 분할되지 않습니다.

표시 위치에 따른 선택 차이

로그 상세 정보 본문에서 큰따옴표 또는 대괄호 안의 내용은 전체가 선택될 수 있으며, 선택 동작은 목록 hover 선택, JSON 표시와 완전히 일치하지 않을 수 있습니다. 작업 시 현재 선택 범위를 기준으로 하세요.

필터링을 실행하면 시스템은 현재 쿼리에 선택한 조각을 추가하고 기존 인덱스, 시간 범위, 워크스페이스 및 기타 필터 조건을 유지합니다. 일부 텍스트가 검색 하이라이트에 해당하는 경우에도 클릭하면 전체 조각이 선택됩니다.

JSON 필드를 통해 필터링을 실행하는 경우에도 해당하는 실제 필드 경로를 사용합니다. DQL, SLS 등 모드는 현재 진입 경로의 작업 제한 및 변환 확인 규칙을 계속 따릅니다.

JSON 검색

JSON 형식의 로그에서 key와 value 모두 JSON 검색을 수행할 수 있습니다. 클릭하면 탐색기 검색창에 @key:value 형식이 추가되어 검색됩니다.

다중 레벨 JSON 데이터의 경우 .으로 계층 관계를 나타냅니다. 예를 들어 @key1.key2:value는 key1 아래의 key2에 해당하는 값을 검색함을 의미합니다.

자세한 내용은 JSON 검색을 참조하세요.

확장 필드

  • 검색창에 필드 이름 또는 값을 입력하여 빠르게 검색하고 위치를 찾을 수 있습니다.

  • 필드 별칭을 선택하면 필드 이름 뒤에 별칭이 표시됩니다.

  • 확장 필드에 마우스를 올리고 드롭다운 아이콘을 클릭하면 해당 필드에 대해 다음 작업을 선택할 수 있습니다.

    • 필드 값 필터링

    • 필드 값 역필터링

    • 표시 열에 추가

    • 차원 분석: 클릭하면 분석 모드 > 시계열 차트로 이동합니다.

    • 복사

참고

특정 필드를 표시 열에 추가하면 목록에 아이콘 표시가 나타나 구분할 수 있습니다.

컨텍스트 로그

로그 서비스의 컨텍스트 조회 기능은 시간线索을 통해 이상 로그 발생 전후의 관련 기록을 추적하고 문제의 근본 원인을 빠르게 파악할 수 있도록 합니다.

  • 로그 상세 페이지에서 해당 데이터 내용의 컨텍스트 로그를 바로 확인할 수 있습니다.

  • 왼쪽 드롭다운 상자에서 인덱스를 선택하여 해당 데이터를 필터링할 수 있습니다.

  • 데이터 정렬

  • 현재 상세 페이지에서 바로 로그 탐색기 새 페이지로 이동

  • 표시 항목 설정

  • 설정

관련 로직 보충 설명

반환 데이터에 따라 스크롤할 때마다 50개 데이터가 로드됩니다.

반환된 데이터는 어떻게 조회하나요?

전제 조건: 로그에 log_read_lines 필드가 존재하는지 확인합니다. 존재하면 로직 a를 따르고, 존재하지 않으면 로직 b를 따릅니다.

a. 현재 로그의 log_read_lines 값을 가져와 log_read_lines >= {{log_read_lines.value-30}} and log_read_lines <= {{log_read_lines.value +30}} 필터에 적용합니다.

DQL 예시: 현재 로그 줄 수 = 1354170

그런 다음:

L::RE(`.*`):(`message`) { `index` = 'default' and `host` = "ip-172-31-204-89.cn-northwest-1" AND `source` = "kodo-log" AND `service` = "kodo-inner" AND `filename` = "0.log" and `log_read_lines` >= 1354140 and `log_read_lines` <= 1354200}  sorder by log_read_lines

b. 현재 로그 시간을 가져와 앞/뒤로推算하여 쿼리의 시작 시간과 종료 시간을 구합니다.

  • 시작 시간: 현재 로그 시간을 기준으로 5분 앞으로 이동

  • 종료 시간: 현재 로그를 기준으로 50개 데이터 뒤로 이동하여 50번째 데이터의 시간(·)을 가져옵니다. time = 현재 로그 시간이면 time+1 마이크로초를 종료 시간으로 하고, time ≠ 현재 로그 시간이면 time을 종료 시간으로 합니다.

로그 컨텍스트 페이지

를 클릭하면 로그 컨텍스트 페이지로 이동합니다. 다음 작업을 통해 현재 모든 데이터를 관리할 수 있습니다.

  • 검색창에 텍스트를 입력하여 데이터를 검색하고 위치를 찾습니다.

  • 측면의 버튼을 클릭하면 시스템 기본값인 자동 줄 바꿈을 콘텐츠 오버플로 모드로 전환할 수 있습니다. 이때 각 로그는 한 줄로 표시되며 필요에 따라 좌우로 스크롤하여 확인할 수 있습니다.

  • 맨 위/맨 아래로 이동

  • 위/아래로 100개 로드

  • 내보내기 아이콘을 클릭하여 현재 로그 컨텍스트 데이터를 내보냅니다.

연관 분석

시스템은 로그 데이터에 대한 연관 분석을 지원합니다. 오류 상세 정보, 확장 필드, 컨텍스트 로그 외에도 로그에 해당하는 호스트, 컨테이너, 네트워크 등을 한 번에 파악할 수 있습니다.

기본 제공 페이지

호스트, 컨테이너, Pod 등 기본 제공 페이지에 대해 다음 작업을 수행할 수 있습니다.

(‘호스트’ 기본 제공 페이지를 예로 듭니다.)

  • 현재 페이지의 표시 필드를 편집하면 시스템이 필드에 따라 해당 데이터를 자동으로 매칭합니다.

  • 메트릭 보기, 호스트 상세 페이지로 이동을 선택합니다.

  • 시간 범위 필터링

참고

워크스페이스 관리자만 기본 제공 페이지의 표시 필드를 수정할 수 있으며, 공통 필드를 구성하는 것이 좋습니다. 해당 페이지가 여러 탐색기에서 공유되는 경우 필드 수정 사항이 실시간으로 동기화되어 적용됩니다.

예를 들어 여기에서 'index' 필드를 구성하면 로그에 해당 필드가 있으면 정상적으로 표시되지만, 분산 추적 탐색기에 이 필드가 없으면 해당 값을 표시할 수 없습니다.

기본 제공 보기

시스템에서 기본으로 표시되는 보기 외에도 사용자 보기를 바인딩할 수 있습니다.

  1. 기본 제공 보기 바인딩 페이지로 이동합니다.

  2. 기본 연결 필드를 확인합니다. 필드를 유지하거나 삭제할 수 있으며, 새 key:value 필드를 추가할 수도 있습니다.

  3. 보기를 선택합니다.

  4. 바인딩을 완료하면 호스트 오브젝트 상세에서 바인딩된 기본 제공 보기를 확인할 수 있습니다. 점프 버튼 을 통해 해당 기본 제공 보기 페이지로 이동할 수 있습니다.

문서 평가

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