기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
이 설명서 주제는 Grafana 버전 10.x를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 9에서 작업 섹션을 참조하세요.
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 8에서 작업 섹션을 참조하세요.
탐색을 사용하여 추적 데이터 소스의 추적을 시각화할 수 있습니다.
지원되는 데이터 소스는 다음과 같습니다.
위에 나열된 데이터 소스에 대한 쿼리를 구성하는 방법에 대한 자세한 내용은 특정 데이터 소스에 대한 설명서를 참조하세요.
쿼리 편집기
데이터 소스의 쿼리 편집기를 사용하여 추적 데이터를 쿼리하고 검색할 수 있습니다.
각 데이터 소스에는 자체 쿼리 편집기가 있을 수 있습니다. Tempo 데이터 소스의 쿼리 편집기는 Jaeger 데이터 소스의 쿼리 편집기와 약간 다릅니다.
각 데이터 소스 쿼리에 대한 자세한 내용은 해당 설명서를 참조하세요.
추적 보기 설명
이 섹션에서는 추적 보기 대시보드의 요소를 설명합니다.
헤더
추적 보기의 헤더에는 다음과 같은 요소가 있습니다.
-
헤더 제목 - 루트 범위의 이름과 추적 ID를 표시합니다.
-
검색 - 검색된 텍스트가 포함된 범위를 강조 표시합니다.
-
메타데이터 - 추적에 대한 다양한 메타데이터.
미니맵
요약 보기 또는 추적 타임라인을 표시합니다. 미니맵 위로 포인터를 끌어 더 작은 시간 범위로 확대합니다. 확대/축소는 기본 타임라인도 업데이트하므로 더 짧은 기간을 쉽게 볼 수 있습니다. 확대된 상태에서 미니맵 위로 마우스를 가져가면 선택 재설정 버튼이 표시됩니다. 이 버튼을 누르면 확대 상태가 재설정됩니다.
범위 필터
범위 필터를 사용하여 추적 타임라인 뷰어에서 범위를 필터링할 수 있습니다. 필터를 더 많이 추가할수록 필터링된 범위가 더 구체적입니다.
다음 필터를 하나 이상 추가할 수 있습니다.
-
리소스 서비스 이름
-
범위 이름
-
지속 시간
-
태그(태그, 프로세스 태그 및 로그 필드 포함)
매칭한 범위만 표시하려면 매칭만 표시 토글을 선택합니다.
타임라인
추적 내 범위 목록을 표시합니다. 각 범위 행은 다음과 같은 구성 요소로 이루어집니다.
-
하위 확장 버튼 - 선택한 범위의 모든 하위 범위를 확장하거나 축소합니다.
-
서비스 이름 - 범위를 로깅하는 서비스의 이름.
-
작업 이름 - 이 범위가 나타내는 작업의 이름.
-
범위 기간 막대 - 추적 내 작업 기간의 시각적 표현.
범위 세부 정보
범위 행을 선택하면 다음을 포함하여 범위 세부 정보가 표시됩니다.
작업 이름
범위 메타데이터
태그 - 이 범위와 연결된 모든 태그.
프로세스 메타데이터 - 이 범위를 로깅하는 프로세스에 대한 메타데이터.
로그 - 이 범위 및 연결된 키 값으로 로깅된 로그 목록. Zipkin 로그의 경우 섹션에 Zipkin 주석이 표시됩니다.
로그에 대한 추적
추적 보기의 범위로부터 해당 범위와 관련된 로그로 직접 이동할 수 있습니다. 이는 Tempo, Jaeger 및 Zipkin 데이터 소스에서 사용할 수 있습니다. 각 데이터 소스를 구성하는 방법에 대한 지침은 관련 설명서를 참조하세요.
문서 아이콘을 선택하여 구성된 데이터 소스로 탐색에서 분할 보기를 열고 해당 범위에 대한 관련 로그를 쿼리합니다.
지표로 추적
참고
이 기능은 현재 베타에서 제공됩니다.
추적 보기의 범위로부터 해당 범위와 관련된 지표로 직접 이동할 수 있습니다. 이 기능은 Tempo, Jaeger 및 Zipkin 데이터 소스에서 사용할 수 있습니다. 구성에 대한 자세한 내용은 관련 설명서를 참조하세요.
프로파일로 추적
프로파일로 추적을 사용하면 Grafana의 기능을 사용해 추적과 프로파일을 연결하는 기능을 추가하여 다양한 신호의 상관관계를 파악할 수 있습니다.
노드 그래프
선택적으로 표시된 추적에 대한 노드 그래프를 확장할 수 있습니다. 데이터 소스에 따라 그래프에 추적의 범위를 노드로 표시하거나 현재 추적을 기반으로 한 서비스 그래프를 포함하여 몇 가지 컨텍스트를 추가할 수 있습니다.
서비스 그래프 보기
서비스 그래프 보기는 범위 지표(속도, 오류 비율 및 기간(RED)에 대한 추적 데이터)와 서비스 그래프를 시각화합니다. 요구 사항이 설정되면 이 사전 구성된 보기를 즉시 사용할 수 있습니다.
자세한 내용은 Tempo 데이터 소스 페이지를 참조하세요. Grafana Labs Tempo 설명서의 service graph view page
데이터 API
이 시각화를 올바르게 표시하려면 데이터 소스에서 반환할 데이터의 특정 형태가 필요합니다.
데이터 소스는 데이터 프레임을 반환하고 frame.meta.preferredVisualisationType = 'trace'를 설정해야 합니다.
데이터 프레임 구조
필수 필드
| 필드 이름 | 유형 | 설명 |
|---|---|---|
| traceID | 문자열 | 전체 추적의 식별자. 데이터 프레임에는 하나의 추적만 있어야 합니다. |
| spanID | 문자열 | 현재 범위의 식별자. SpanID는 추적당 고유해야 합니다. |
| parentSpanID | 문자열 | 추적 보기에서 하위 상위 관계를 생성하기 위한 상위 범위의 SpanID. 상위가 없는 루트에 대해 undefined일 수 있습니다. |
| serviceName | 문자열 | 이 범위가 속한 서비스의 이름. |
| serviceTags | TraceKeyValuePair[] | 서비스와 관련된 태그 목록. |
| startTime | 숫자 | 범위 시작 시간(밀리초 에포크 시간 단위). |
| 기간 | 숫자 | 범위 지속 시간(밀리초 단위). |
선택적 필드:
| 필드 이름 | 유형 | 설명 |
|---|---|---|
| 로그 | TraceLog[] | 현재 범위와 연결된 로그 목록. |
| tags | TraceKeyValuePair[] | 현재 범위와 연결된 태그 목록. |
| warnings | string[] | 현재 범위와 연결된 경고 목록. |
| stackTraces | string[] | 현재 범위와 연결된 스택 추적 목록. |
| errorIconColor | 문자열 | 범위에 error:
true 태그가 지정된 경우 오류 아이콘의 색상. |
유형에 대한 자세한 내용은 GitHub의 TraceSpanRow
