기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 트레이스
****
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.
추적 시각화를 사용하면 인프라의 서비스를 통과할 때 요청을 따를 수 있습니다. 추적 시각화에서는 추적 데이터를 쉽게 해석할 수 있도록 다이어그램에 추적 데이터를 표시합니다.
추적 및 추적 사용 방법에 대한 자세한 내용은 다음 설명서를 참조하세요.
+ [탐색에서 추적](v10-explore-tracing.md)
+ [Tempo 데이터 소스](tempo-data-source.md)
+ *Grafana Labs Tempo 설명서*의 [Getting started with Tempo](https://grafana.com/docs/tempo/latest/getting-started/).
## 추적 시각화를 사용하여 패널 추가
Grafana 스택에서 추적 데이터를 사용할 수 있으면 Grafana 대시보드에 추적 패널을 추가할 수 있습니다.
대시보드 변수, `traceID`를 사용하여 지정된 추적 ID에 대한 특정 추적을 표시하도록 쿼리를 생성할 수 있습니다. 대시보드 변수에 대한 자세한 내용은 [변수 설명서](v10-dash-variables.md)를 참조하세요.
**사전 조건**
시작하려면 다음이 필요합니다.
+ Amazon Managed Grafana 워크스페이스.
+ 워크스페이스에 연결된 [Tempo 데이터 소스](tempo-data-source.md).
대시보드에서 추적 데이터를 보고 분석하려면 대시보드에 추적 시각화를 추가하고 패널 편집기를 사용하여 쿼리를 정의해야 합니다. 쿼리는 시각화에 표시되는 데이터를 결정합니다. 패널 편집기에 대한 자세한 내용은 [패널 편집기 설명서](v10-panels-editor-overview.md)를 참조하세요.
이 절차에서는 대시보드 변수 및 템플릿을 사용하여 추적 ID를 입력한 다음, 이를 시각화할 수 있습니다. `traceId`라는 변수를 사용하고 템플릿 쿼리로 추가합니다.
**추적 시각화 쿼리를 추가하는 방법**
1. 워크스페이스에서 새 대시보드를 생성하거나 추적 시각화를 추가하려는 기존 대시보드로 이동하세요.
1. 새 대시보드에서 **시각화 추가**를 선택하거나 기존 대시보드에서 **패널 추가**를 선택하세요.
1. 적절한 추적 데이터 소스를 선택하세요.
1. 패널 편집기의 오른쪽 상단에서 **시각화** 탭을 선택하고 **추적**을 선택하세요.
1. **패널 옵션**에서 추적 패널의 **제목**을 입력하세요. 패널 편집기에 대한 자세한 내용은 [패널 옵션 구성](v10-panels-configure-panel-options.md) 섹션을 참조하세요.
1. 쿼리 편집기에서 **TraceQL** 쿼리 유형 탭을 선택하세요.
1. TraceQL 쿼리 필드에 `${traceId}`를 입력하여 대시보드 변수를 생성하세요. 이 변수는 템플릿 쿼리로 사용됩니다.
1. 패널 편집기에서 **적용**을 선택하여 대시보드에 패널을 추가하세요.
1. 대시보드 **설정**으로 이동하고 필요한 경우 레이블을 지정하여 `traceId`라는 새 변수(이때 변수 유형은 **사용자 지정**임)를 추가하세요. **적용**을 선택하여 대시보드에 변수를 추가하세요.
1. 추적 패널에 사용되는 데이터 소스에 유효한 추적 ID를 사용하고 대시보드 변수에서 ID를 편집하여 패널이 작동하는지 확인하세요.
## 테이블 시각화를 사용하여 TraceQL 추가
대시보드에 추적 시각화를 추가할 수 있지만 대시보드 변수로 추적 ID를 수동으로 추가해야 하는 작업은 번거롭습니다. 대신 TraceQL 쿼리를 사용하여 특정 유형의 추적을 검색한 다음, 일치하는 결과에서 적절한 추적을 선택할 수 있는 것이 더 유용합니다.
**사전 조건**
이 절차에서는 이전 절차를 완료했다고 가정합니다.
**테이블 시각화를 사용하여 TraceQL을 추가하는 방법**
1. 추적 시각화를 추가한 동일한 대시보드에서 **패널 추가**를 선택하여 새 시각화 패널을 추가하세요.
1. 이전 섹션에서 사용한 것과 동일한 추적 데이터 소스를 선택하세요.
1. 패널 편집기의 오른쪽 상단에서 **시각화** 탭을 선택한 다음, **테이블**을 선택하세요.
1. 쿼리 편집기에서 **TraceQL** 탭을 선택하세요.
1. **패널 옵션**에서 추적 패널의 **제목**을 입력하세요.
1. 적절한 TraceQL 쿼리를 추가하여 대시보드에서 시각화하려는 추적을 검색하세요. 예를 들어, 다음은 *my-server*라는 서버의 간단한 정적 쿼리입니다.
```
{ .service.name = "my-server" && .http.status_code=500 }
```
TraceQL 쿼리를 템플릿 쿼리로 작성하여 다른 대시보드 변수가 있는 경우 이를 활용할 수 있습니다. 그러면 이러한 변수를 기반으로 동적 쿼리를 생성할 수 있습니다.
쿼리에서 결과가 반환되면 결과가 패널의 테이블에 렌더링됩니다.
추적 시각화의 결과에는 추적을 렌더링하는 **탐색** 페이지에 대한 링크가 포함됩니다. 선택한 경우 `traceId` 대시보드 변수를 채우는 테이블의 추적에 다른 링크를 추가하여 동일한 대시보드에서 추적을 시각화할 수 있습니다.
패널에서 데이터 링크 세트를 생성하려면 다음 절차를 수행하세요.
**변수를 사용하여 추적에 다른 링크를 추가하는 방법**
1. 오른쪽 메뉴의 **데이터 링크**에서 **링크 추가**를 선택하세요.
1. 데이터 링크의 **제목**을 추가하세요.
1. 전체 대시보드가 렌더링될 때 브라우저의 주소 표시줄을 확인하여 대시보드 경로를 찾으세요. 동일한 Grafana 스택의 대시보드에 대한 링크이므로 대시보드 경로만 필요합니다.
예를 들어 경로가 다음과 같은 경우:
```
https://g-example.grafana-workspace.us-east-1.amazonaws.com/d/1234abcd5/my-dashboard?orgId=1
```
그러면 대시보드에 대한 경로는 다음과 같습니다.
```
/d/1234abcd5/my-dashboard?orgId=1
```
1. **URL** 필드에서 두 패널이 모두 포함된 대시보드를 직접 참조하세요. 이 자체 참조는 테이블에서 선택한 추적의 값을 사용하여 대시보드 변수를 채웁니다. 이전 단계의 대시보드 경로를 사용한 다음, TraceQL 테이블에서 선택한 결과를 사용하여 `traceId`의 값을 입력하세요. 추적 ID는 반환된 결과의 `traceID` 데이터 필드를 사용하여 공개되므로 대시보드 변수의 값으로 이를 사용합니다. 예제:
```
/d/1234abcd5/my-dashboard?orgId=1&var-traceId=${__data.fields["traceID"]}
```
1. **저장**을 선택하여 데이터 링크를 저장하세요.
1. 패널 편집기에서 **적용**을 선택하여 패널을 대시보드에 적용하세요.
1. 대시보드를 저장합니다.
이제 테이블 시각화에서 일치하는 추적 목록이 표시됩니다. **TraceID** 또는 **SpanID** 필드를 선택하면 **탐색** 페이지를 열어 추적을 시각화하는 옵션 또는 데이터 링크를 따르는 옵션이 제공됩니다. 하지만 다른 필드(예: `Start time`, `Name` 또는 `Duration`)를 선택하면 데이터 링크를 자동으로 따르고 `traceId` 대시보드 변수를 채운 후에 추적 패널에 관련 추적을 표시합니다.