Logs Drilldown 테이블 보기
Logs Drilldown 테이블 보기 (Logs Drilldown table view)
Grafana Logs Drilldown의 Table 뷰는 표시되는 각 필드에 대해 열을 하나씩 가진 테이블로 로그를 표시해, 스프레드시트를 읽듯 구조화된 로그를 훑어볼 수 있게 해줘요. 로그 데이터를 훑고, 비교하고, 정렬하고 싶을 때 사용하면 좋아요.
출처: 문서
본문
Grafana Logs Drilldown의 Table 뷰는 표시되는 각 필드에 대해 열을 가진 테이블로 로그를 표시하므로, 스프레드시트처럼 구조화된 로그를 읽을 수 있어요. 로그 데이터를 훑고(scam), 비교하고, 정렬할 때 테이블 뷰를 사용하세요. 예를 들어 duration으로 정렬해 가장 느린 요청을 찾거나, 많은 로그 줄에서 상태 코드나 Pod 이름을 비교할 수 있어요.
테이블 뷰를 열려면 Logs Drilldown에서 서비스에 대해 Show logs 를 선택한 다음, 패널 헤더에서 Logs 와 JSON 옆의 Table 라디오 버튼을 선택합니다.
참고: Logs Table 시각화는 현재 public preview(공개 미리보기) 단계예요. Grafana Labs는 제한적 지원을 제공하며, 일반 제공(GA) 전에 호환성이 깨지는 변경이 발생할 수 있어요. 이 기능을 사용하려면 Grafana 설정 파일에서
logsTablePanelNG기능 토글을 활성화하거나 지원팀에 문의하세요. 기능 토글을 활성화하면 Table 뷰는 이 페이지에 설명된 네이티브 Grafana Logs Table 시각화로 로그를 렌더링합니다.
열 선택 및 구성 (Select and organize columns)
테이블 왼쪽의 사이드바를 사용해 어떤 필드가 열로 표시될지 선택합니다. 원하는 필드만 있는 테이블을 만들려면:
- 패널 헤더에서 Table 뷰를 선택합니다.
- Search fields by name 을 클릭하고 필드 이름 전체 또는 일부를 입력합니다.
- 필드의 체크박스를 선택해 열로 추가하고, 필요 없는 열의 체크박스를 해제합니다.
사이드바는 다음 컨트롤을 제공합니다:
| 작업 | UI 요소 | 설명 |
|---|---|---|
| 필드 찾기 | Search fields by name | 필드 이름을 입력해 사용 가능한 필드 목록 필터링 |
| 열 추가·제거 | Field checkbox | 필드 체크박스를 선택해 열로 추가, 해제해 제거 |
| 열 순서 변경 | Selected fields | 현재 열을 나열. 이 목록에서 필드를 끌어 열 순서 변경 |
| 사용 가능한 필드 찾기 | Suggested 및 Fields | Suggested는 유용할 가능성이 높은 필드, Fields는 그 외 모든 것을 나열. 필드 옆의 백분율은 표시된 로그 중 해당 필드가 포함된 비율 |
| 기본값 복원 | Reset | 기본 열(시간, 레벨, 로그 줄) 복원 |
테이블에 더 많은 공간을 주려면 Collapse sidebar 아이콘으로 사이드바를 접을 수 있어요. 사이드바, 열, 로그 세부 사이드바는 가장자리를 끌어 크기를 조정할 수도 있습니다. Logs Drilldown은 열 선택과 크기를 기억합니다.
로그 세부 정보 보기 (View log details)
각 행은 줄 시작 부분에 Show details 눈 아이콘이 있어요. Show details 를 선택하면 로그 세부 사이드바가 열리며, 필드 검색, 로그 줄 복사, 필드 값 필터링(포함·제외), 필드 통계 보기가 가능합니다. 설명은 View logs 문서를 참고하세요.
테이블 뷰에서:
- 로그 세부 정보는 항상 오른쪽 사이드바로 열리며, Close log details sidebar 아이콘이나 Escape 키로 크기를 조정하거나 닫을 수 있어요.
- 사이드바 상단의 복사 아이콘은 Copy log line message 와 Copy log contents as JSON 옵션이 있는 메뉴를 엽니다.
- 여러 행의 세부 정보를 열면 각 로그 줄에 대한 탭이 생성되어 비교할 수 있어요.
- 위·아래 화살표 키로 세부 뷰를 이전·다음 로그 줄로 이동할 수 있어요.
- 행에는 해당 로그 줄의 짧은 링크를 클립보드에 복사하는 Copy link to log line 아이콘도 있어요.
필터, 정렬, 줄 바꿈, 다운로드 (Filter, sort, wrap, and download)
테이블 뷰는 필터링에 열 자체를 사용하고, 패널 오른쪽 가장자리에 컨트롤 레일(controls rail)을 제공합니다.
레벨·값으로 필터링: 모든 열 헤더에는 Filter 아이콘이 있어 해당 열의 값 목록으로 필터링할 수 있어요. 로그 레벨로 필터링하려면 레벨 열(예: detected_level)의 Filter 아이콘을 사용하세요. 어떤 셀이든 위에 마우스를 올리고 Filter for value 또는 Filter out value 로 그 값을 쿼리에 추가하거나, 로그 세부 정보 내에서 필터링할 수도 있어요. Logs Drilldown 툴바의 Log levels 필터는 테이블 뷰에도 적용됩니다.
정렬: 열 헤더를 클릭하면 해당 열로 정렬되고, 다시 클릭하면 방향이 바뀝니다. 레일의 정렬 순서 컨트롤은 새 로그부터/오래된 로그부터를 전환하며 시간 열과 동기화됩니다.
텍스트 줄 바꿈: 레일의 wrap 컨트롤을 선택해 긴 로그 줄과 셀 값의 텍스트 줄 바꿈을 토글합니다.
다운로드: 레일의 Download logs 컨트롤로 표시된 로그를 txt, json, csv 로 내보낼 수 있어요. 내보내기에는 선택한 열이 포함됩니다. 대시보드에서는 Display download control 패널 옵션을 활성화하면 다운로드 컨트롤이 나타납니다.
기능이 이동한 위치 (Where features moved)
이전 Logs Drilldown 테이블 뷰나 Grafana Explore에서 왔다면, Logs 테이블 시각화에서 기능이 이동한 위치는 다음과 같아요:
| 작업 | 이전 테이블 뷰 | Logs 테이블 시각화 |
|---|---|---|
| 로그 줄 검사 | View log line 눈 아이콘이 원시 줄이 있는 Inspect value 대화상자 열기 | Show details 눈 아이콘이 전체 log details sidebar 열기 |
| 열 추가·제거 | 체크박스가 있는 Fields 사이드바 | 동일한 사이드바, 변경 없음 |
| 열 순서 변경 | Move left/Move right 열 메뉴(Logs Drilldown) | Selected fields 목록에서 필드 드래그 |
| 열 제거 | 열 메뉴의 Remove column(Logs Drilldown) | 사이드바에서 필드 체크박스 해제 |
| 값으로 필터링 | 셀 호버 아이콘 | 셀 호버 아이콘 + 모든 열 헤더의 Filter 아이콘 |
| 레벨로 필터링 | 레벨 열의 셀 필터 | 레벨 열 헤더의 Filter 아이콘, 셀 필터, 또는 Log levels 툴바 필터 |
| 긴 줄 줄 바꿈 | 사용 불가; 셀이 가로로 스크롤됨 | 레일의 Wrap 컨트롤, 또는 Wrap text 열 옵션 |
| 로그 다운로드 | Download logs 컨트롤 | 동일한 컨트롤, 동일한 txt, json, csv 형식 |
| 로그 줄 공유 | Copy link to log line 아이콘 | 동일한 아이콘, 변경 없음 |