로그 라벨과 필드

로그 라벨과 필드 (Labels and fields)

Grafana Logs Drilldown은 로그 라인에 붙어 있는 라벨(label)과 각 로그 라인에서 자동으로 추출된 필드(field)에 대해 로그 볼륨을 시각화해요. 이 문서는 Logs Drilldown의 Labels 탭과 Fields 탭을 사용해 로그를 필터링하고 라벨·필드의 값 분포를 탐색하는 방법을 설명합니다.

출처: Labels and fields

본문

참고: 라벨이나 필드에 표현되는 데이터 유형은 서로 다른 처리가 필요할 수 있어요. 예를 들어 bytes를 표현하는 필드는 다른 데이터 유형과 다르게 시각화돼요.

Logs Drilldown은 Loki가 로그 라인의 레벨을 할당하는 모든 로그 라인에 특별한 detected_level 라벨을 추가해요. 여기에는 debug, info, warn, error, fatal, critical, trace가 포함되며, 레벨을 결정할 수 없으면 unknown이 돼요.

라벨 시각화는 다음에 유용해요.

  • 예상치 못한 로그 볼륨 급증을 발견.
  • 서비스의 하락(dips)이나 중단(outages) 감지.
  • 라벨 전반의 로그 라인 분포 이해.
  • 로그 필터링이나 그룹화에 유용할 라벨 식별.

Label 또는 Field 그래프에서 Select 버튼을 클릭하면 값의 세분화(breakdown)에 접근하고, 그 과정에서 로그 볼륨이 시각화된 것을 볼 수 있어요. 이는 시스템의 특성 이해와 급증 또는 기타 변화를 발견하는 데 유용해요.

개별 로그 라인을 클릭하면 필터 옵션이 있는 필드와 라벨을 표시하는 Log Details 패널을 볼 수 있어요. 자세한 내용은 View logs 문서를 참고하세요.

Labels 탭 UI 개요

  • 상단 네비게이션 바는 Grafana 인터페이스 전체에서 공통돼요.
  • 다음 섹션은 모든 Logs Drilldown 페이지에서 공통이에요.

Labels 탭 UI:

  • Label filter: 메뉴에서 라벨 이름을 검색하거나 선택할 수 있게 해 줘요.
  • Grid / Rows: 라벨이 어떻게 표시되는지 선택할 수 있게 해 줘요.
  • Select or Include button: 클릭하면 라벨 값의 세분화에 접근하고 로그 볼륨이 시각화된 것을 볼 수 있어요.
  • Menu (three dots): 패널 메뉴를 열어 Grafana Explore로 이동하고 다른 옵션에 접근하게 해 줘요.

라벨로 로그 필터링:

  1. Grafana 메인 메뉴에서 Drilldown > Logs를 선택해요.
  2. 탐색하려는 서비스에서 Show logs를 클릭해요.
  3. 서비스 상세 페이지에서 Labels 탭을 클릭해요.
  4. 이 서비스에 대해 감지된 라벨을 찾아봐요.
  5. 흥미로운 라벨을 찾아 Select 버튼을 클릭해요.
  6. 각 라벨의 볼륨을 보여 주는 시각화 모음을 볼 수 있어요.
  7. 필터를 제거하려면 Label 검색 메뉴에서 All을 선택하거나 페이지 상단의 Filter 필드에서 선택 항목 옆의 x를 클릭해요.

Fields 탭 UI 개요

Fields 탭 UI:

  • Field filter: 메뉴에서 필드 이름을 검색하거나 선택할 수 있게 해 줘요.
  • Grid / Rows: 필드가 어떻게 표시되는지 선택할 수 있게 해 줘요.
  • Volume / Names: 필드 볼륨 그래프 표시와 필드 이름만 표시를 전환할 수 있게 해 줘요.
  • Extract fields from logs: 켜면 쿼리에 logfmt와 JSON 파서를 적용해 로그 라인에서 감지된 필드가 인덱스된 라벨과 구조적 메타데이터와 함께 나타나게 해 줘요.
  • Include or Add to filter button: 특정 필드 값으로 로그 결과를 필터링할 수 있게 해 줘요. 버튼 라벨은 필드 유형에 따라 달라져요.
  • Select button (value breakdown): 클릭하면 필드 값의 세분화에 접근하고 로그 볼륨이 시각화된 것을 볼 수 있어요.
  • Menu (three dots): 패널 메뉴를 열어 Grafana Explore로 이동하게 해 줘요.

필드로 로그 필터링:

  1. Grafana 메인 메뉴에서 Drilldown > Logs를 선택해요.
  2. 탐색하려는 서비스에서 Show logs를 클릭해요.
  3. 서비스 상세 페이지에서 Fields 탭을 클릭해요.
  4. 이 서비스에 대해 감지된 필드를 찾아봐요.
  5. 흥미로운 필드를 찾아 Select 버튼을 클릭해요.
  6. 필터를 제거하려면 Field 검색 메뉴에서 All을 선택하거나 페이지 상단의 Filter 필드에서 선택 항목 옆의 x를 클릭해요.

다음에 할 일 (What next?)

Log patterns가 다양한 유형의 로그 라인을 일괄 처리하는 데 어떻게 도움이 되는지 알아보세요.

더 알아보기 (Learn more)