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