Grafana Logs Drilldown 시작하기
Grafana Logs Drilldown 시작하기 (Get started with Grafana Logs Drilldown)
Grafana Logs Drilldown이 무엇을 해주는지 확인하는 가장 좋은 방법은 직접 로그 데이터를 탐색해 보는 거예요. Grafana Cloud 계정이 있다면 Drilldown > Logs를 선택해 접근하거나, 자신의 Grafana 인스턴스에 Logs Drilldown을 설치할 수 있어요.
출처: 문서
본문
Grafana Logs Drilldown이 무엇을 해주는지 확인하는 가장 좋은 방법은 직접 로그 데이터를 탐색해 보는 거예요. Grafana Cloud 계정이 있다면 Drilldown > Logs를 선택해 접근하거나, 자신의 Grafana 인스턴스에 Logs Drilldown을 설치할 수 있어요.
가이드 투어 (Guided tour)
Logs Drilldown에서 로그 데이터를 탐색하는 동안 로그의 예기치 않은 스파이크를 주목해보세요. 또는 서비스 중 하나가 다운되어 로깅을 멈췄을 수도 있어요. 최근 릴리스 후 오류가 증가하고 있을 수도 있어요.
Logs Drilldown 투어를 진행하려면:
- 웹 브라우저에서 Grafana 스택을 열어요.
- Grafana 메인 메뉴에서 Drilldown > Logs를 선택해요. 이렇게 하면 선택한 Loki 인스턴스의 모든 서비스에 대한 시계열과 로그 시각화를 보여주는 Overview page가 열려요. (서비스가 없나요?)
- 여러 Loki 데이터 소스가 있다면 상단 도구 모음의 메뉴에서 Data source를 변경할 수 있어요. Logs Drilldown은 Loki 데이터 소스만 지원해요.
- 최근 시간 범위를 선택해요. 시간 범위는 두 가지 방식으로 수정할 수 있어요: 오른쪽 상단의 표준 시간 범위 선택기로, 또는 아무 시계열 시각화에서 시간 범위를 클릭·드래그해서요.
- 서비스는 로그 볼륨을 기준으로 표시돼요. 서비스 검색 필드로 이름으로 서비스를 찾을 수 있어요.
- 각 서비스 패널은 최근 로그 라인의 미리보기를 보여줘요. 로그 라인을 클릭해 메뉴를 열면 다음을 할 수 있어요:
- Show context: 발생한 전후 로그의 컨텍스트에서 로그 라인 보기
- Go to log line: 그 특정 로그 라인에 초점을 맞춘 서비스 세부 정보 페이지 열기
- Show similar logs: 선택한 것과 유사한 로그 라인으로 필터링된 서비스 세부 정보 페이지 열기
- 미리보기 로그 라인의 값을 클릭해 라인 필터로 추가하고 그 필터가 적용된 서비스 세부 정보 페이지를 열 수도 있어요.
- 서비스 이름 대신 라벨로 서비스를 보고 싶다면 (+) Add label을 클릭하고 메뉴에서 라벨을 선택하거나 라벨을 검색해요.
- Tip: 관리자는 로그 시각화에 표시할 기본 필드를 구성할 수 있어요. 자세한 내용은 Configure Logs Drilldown을 참고해요.
- 서비스의 로그를 탐색하려면 서비스 패널에서 Show logs를 클릭해요. Grafana가 Logs 탭에서 서비스 세부 정보 페이지를 열어요.
- Logs 탭에서 다음을 할 수 있어요:
- 로그 컨트롤(오른쪽의 확장/축소 버튼으로 펼칠 수 있음)을 사용해 정렬 순서 조정, 문자열·레벨별 필터링, 표시 옵션 변경 등을 수행. 자세한 내용은 View logs를 참고해요.
- 개별 로그 라인을 클릭해 Log Details 패널에서 필드·링크를 포함한 상세 정보 보기
- 무한 스크롤로 아래로 스크롤해 더 많은 로그 항목 로드
- 줄 바꿈 컨트롤을 사용해 비활성, 활성, JSON 형식 활성 중에서 선택해 로그 표시를 읽기 쉽게 조정
- 서비스 세부 정보 페이지에서 Labels 탭을 클릭해 각 라벨의 로그 볼륨 시각화를 봐요. (라벨이 없나요?)
- Labels 탭에서 라벨을 선택해 해당 라벨의 각 값에 대한 로그 볼륨을 보려면 Select 버튼을 클릭해요. Logs Drilldown은 특정 라벨과 필드가 있는 로그의 볼륨을 보여줘요. 자세한 내용은 Labels and Fields를 참고해요.
- 각 필드의 로그 볼륨 시각화를 보려면 Fields 탭을 선택해요. 라벨과 같은 방식으로 세부 사항을 파고들려면 필드에 대해 Select를 클릭해요.
- Patterns 탭을 클릭해 자동 감지된 각 패턴의 로그 볼륨을 봐요. 로그 패턴을 사용하면 유사한 로그 라인의 그룹으로 작업할 수 있어요. 시끄러운 로그 패턴을 숨기거나 가장 유용한 패턴에만 집중할 수 있어요. 자세한 내용은 Log Patterns를 참고해요.
- Logs 탭을 클릭해요. 두 패널 중 하나에서 메뉴 아이콘(세로 점 3개)을 클릭해 패널 메뉴를 열고 Explore를 선택해요. Grafana가 Logs Drilldown에서 만든 선택을 기반으로 한 쿼리와 함께 Explore 페이지를 표시해요. 패널 메뉴에는 Add to Dashboard 및 Create alert 같은 옵션도 포함돼요. 자세한 내용은 View logs를 참고해요.
추가 리소스 (Further resources)
- 시청: How to Use the Logs Drilldown App for Grafana
- 시청: All About Logs Drilldown for Grafana Loki (Loki Community Call October 2024)