기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
이 설명서 주제는 Grafana 버전 10.x를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 9에서 작업 섹션을 참조하세요.
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 8에서 작업 섹션을 참조하세요.
추적 시각화를 사용하면 인프라의 서비스를 통과할 때 요청을 따를 수 있습니다. 추적 시각화에서는 추적 데이터를 쉽게 해석할 수 있도록 다이어그램에 추적 데이터를 표시합니다.
추적 및 추적 사용 방법에 대한 자세한 내용은 다음 설명서를 참조하세요.
-
Grafana Labs Tempo 설명서의 Getting started with Tempo
.
추적 시각화를 사용하여 패널 추가
Grafana 스택에서 추적 데이터를 사용할 수 있으면 Grafana 대시보드에 추적 패널을 추가할 수 있습니다.
대시보드 변수, traceID
를 사용하여 지정된 추적 ID에 대한 특정 추적을 표시하도록 쿼리를 생성할 수 있습니다. 대시보드 변수에 대한 자세한 내용은 변수 설명서를 참조하세요.
사전 조건
시작하려면 다음이 필요합니다.
-
Amazon Managed Grafana 워크스페이스.
-
워크스페이스에 연결된 Tempo 데이터 소스.
대시보드에서 추적 데이터를 보고 분석하려면 대시보드에 추적 시각화를 추가하고 패널 편집기를 사용하여 쿼리를 정의해야 합니다. 쿼리는 시각화에 표시되는 데이터를 결정합니다. 패널 편집기에 대한 자세한 내용은 패널 편집기 설명서를 참조하세요.
이 절차에서는 대시보드 변수 및 템플릿을 사용하여 추적 ID를 입력한 다음, 이를 시각화할 수 있습니다. traceId
라는 변수를 사용하고 템플릿 쿼리로 추가합니다.
추적 시각화 쿼리를 추가하는 방법
-
워크스페이스에서 새 대시보드를 생성하거나 추적 시각화를 추가하려는 기존 대시보드로 이동하세요.
-
새 대시보드에서 시각화 추가를 선택하거나 기존 대시보드에서 패널 추가를 선택하세요.
-
적절한 추적 데이터 소스를 선택하세요.
-
패널 편집기의 오른쪽 상단에서 시각화 탭을 선택하고 추적을 선택하세요.
-
패널 옵션에서 추적 패널의 제목을 입력하세요. 패널 편집기에 대한 자세한 내용은 패널 옵션 구성 섹션을 참조하세요.
-
쿼리 편집기에서 TraceQL 쿼리 유형 탭을 선택하세요.
-
TraceQL 쿼리 필드에
${traceId}
를 입력하여 대시보드 변수를 생성하세요. 이 변수는 템플릿 쿼리로 사용됩니다. -
패널 편집기에서 적용을 선택하여 대시보드에 패널을 추가하세요.
-
대시보드 설정으로 이동하고 필요한 경우 레이블을 지정하여
traceId
라는 새 변수(이때 변수 유형은 사용자 지정임)를 추가하세요. 적용을 선택하여 대시보드에 변수를 추가하세요. -
추적 패널에 사용되는 데이터 소스에 유효한 추적 ID를 사용하고 대시보드 변수에서 ID를 편집하여 패널이 작동하는지 확인하세요.
테이블 시각화를 사용하여 TraceQL 추가
대시보드에 추적 시각화를 추가할 수 있지만 대시보드 변수로 추적 ID를 수동으로 추가해야 하는 작업은 번거롭습니다. 대신 TraceQL 쿼리를 사용하여 특정 유형의 추적을 검색한 다음, 일치하는 결과에서 적절한 추적을 선택할 수 있는 것이 더 유용합니다.
사전 조건
이 절차에서는 이전 절차를 완료했다고 가정합니다.
테이블 시각화를 사용하여 TraceQL을 추가하는 방법
-
추적 시각화를 추가한 동일한 대시보드에서 패널 추가를 선택하여 새 시각화 패널을 추가하세요.
-
이전 섹션에서 사용한 것과 동일한 추적 데이터 소스를 선택하세요.
-
패널 편집기의 오른쪽 상단에서 시각화 탭을 선택한 다음, 테이블을 선택하세요.
-
쿼리 편집기에서 TraceQL 탭을 선택하세요.
-
패널 옵션에서 추적 패널의 제목을 입력하세요.
-
적절한 TraceQL 쿼리를 추가하여 대시보드에서 시각화하려는 추적을 검색하세요. 예를 들어, 다음은
my-server
라는 서버의 간단한 정적 쿼리입니다.{ .service.name = "
my-server
" && .http.status_code=500 }TraceQL 쿼리를 템플릿 쿼리로 작성하여 다른 대시보드 변수가 있는 경우 이를 활용할 수 있습니다. 그러면 이러한 변수를 기반으로 동적 쿼리를 생성할 수 있습니다.
쿼리에서 결과가 반환되면 결과가 패널의 테이블에 렌더링됩니다.
추적 시각화의 결과에는 추적을 렌더링하는 탐색 페이지에 대한 링크가 포함됩니다. 선택한 경우 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 필드를 선택하면 탐색 페이지를 열어 추적을 시각화하는 옵션 또는 데이터 링크를 따르는 옵션이 제공됩니다. 하지만 다른 필드(예: Start time
, Name
또는 Duration
)를 선택하면 데이터 링크를 자동으로 따르고 traceId
대시보드 변수를 채운 후에 추적 패널에 관련 추적을 표시합니다.