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