로그

로그 (Logs)

*로그(Logs)*는 시스템이나 애플리케이션이 생성하는 이벤트·메시지의 구조화된 기록이에요. 보통 타임스탬프, 메시지, 로그 이벤트의 심각도 같은 컨텍스트 정보를 포함합니다. 로그 시각화는 Elastic, Influx, Loki처럼 로그를 지원하는 데이터 소스의 레코드를 표시해요. 기본적으로 타임스탬프, 로그 상태를 나타내는 색상 문자열, 로그 라인 본문, 그리고 정보 분석에 도움되는 접이식 로그 이벤트를 보여줍니다.

애플리케이션이나 시스템에 장애가 발생했을 때 무엇이, 언제, 왜 잘못됐는지 파악하는 데 유용해요.

출처: 문서

본문

로그는 시스템이나 애플리케이션이 생성하는 이벤트·메시지의 구조화된 기록이며, 시스템·앱의 상태 업데이트가 담긴 일련의 텍스트 레코드입니다. 일반적으로 타임스탬프, 메시지, 로그 이벤트 심각도 같은 컨텍스트 정보를 포함합니다.

로그 시각화는 Elastic, Influx, Loki처럼 로그를 지원하는 데이터 소스의 레코드를 표시합니다. 기본적으로 타임스탬프, 로그 상태 색상, 로그 라인 본문, 접이식 로그 이벤트를 보여줍니다.

로그 라인 세부정보가 열리면 다음 추가 옵션에 접근할 수 있습니다.

• Assistant에서 로그 라인 설명 (Explain log line in Assistant)
• 로그 라인으로 스크롤 (Scroll to log line)
• 로그 라인 표시/숨김 (Show or hide log line)
• 클립보드로 복사 (Copy to clipboard)
• 짧은 링크 복사 (Copy shortlink)
• 압축 보기로 전환 (Switch to condensed view)
• 오른쪽으로 고정 (Anchor to the right)

처음 세 옵션은 로그 라인 세부정보나 로그 라인 메뉴에서 접근할 수 있습니다.

보통 로그를 그래프 시각화와 함께 사용해 관련 프로세스의 로그 출력을 표시합니다. 앱·시스템에 웹사이트 중단, 코드 실패 같은 사고가 있으면 로그 시각화로 무엇이, 언제, 왜 잘못됐는지 파악할 수 있습니다.

지원 데이터 형식

로그 시각화는 Loki, Elastic, InfluxDB 같은 데이터 소스의 로그 유형 데이터셋에서 가장 잘 동작합니다. 선호하는 dataplane 로그 형식은 timestamp 시간 필드와 body 문자열 필드를 사용하며, 선택적으로 severity, id, labels 필드를 포함할 수 있습니다.

첫 필드가 시간형이고 그 뒤에 문자열·숫자·시간 필드가 오는 형식이면 다른 데이터 소스에서도 레거시 로그 데이터를 만들 수 있습니다. 앞의 시간 필드는 로그를 정렬·타임스탬프 처리하는 데 사용되며, 다른 시간 필드가 있으면 로그 레코드의 요소로 포함됩니다. 두 번째 필드는 시간·숫자·문자열 여부와 무관하게 로그 레코드 제목으로 사용됩니다. 보통 텍스트 필드로 여러 문자열 요소를 포함하지만, 메시지 레벨(lvl)이 있으면 그 값을 사용해 레코드에 색상을 추가합니다(Log levels integration 참고). 이후 필드는 각 로그 레코드 안에 접혀 표시됩니다.

시각화에 렌더링되는 로그 라인 수를 제한하려면 패널 Query options의 Max data points 설정을 사용할 수 있습니다. 설정하지 않으면 데이터 소스가 자체 기본 제한을 적용합니다.

예시

로그 레벨 (Log level)

Grafana는 첫 번째로 일치하는 level, detected_level, lvl, loglevel 라벨에서 로그 레벨을 결정하고 색상을 업데이트합니다. 이런 라벨이 없으면 콘텐츠가 지원 표현식과 일치하는지 확인합니다. 결정할 수 없으면 unknown 로그 레벨로 표시합니다. 지원 로그 레벨과 약어·표현식 매핑은 Log levels integration을 참고하세요.

구성 옵션

패널 옵션 (Panel options)

패널 편집기 창의 Panel options 섹션에서 패널 제목, 설명, 패널 링크 등 기본 옵션을 설정합니다.

로그 옵션 (Logs options)

더 알아보기 (Learn more)

• Grafana 대시보드 만들기
• Log levels integration
• Grafana Play에서 Logs 패널 체험