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