Tempo 데이터 소스 추가 설정

Tempo 데이터 소스 추가 설정 (Additional settings)

Tempo 데이터 소스 설정의 Additional settings 섹션에는 대부분의 사용자가 변경할 필요가 없는 옵션들이 들어 있어요. 이 설정들은 기본적으로 접혀 있으며, 아래 화살표로 펼쳐 확인할 수 있어요. 고급 HTTP 설정, Service Graph, Node graph, 검색, TraceID 쿼리, 태그 시간 범위 등을 다룹니다.

출처: Additional settings

본문

이 페이지는 다음 설정을 다룹니다.

  • Advanced HTTP settings: 쿠키 전달과 요청 시간 초과 구성
  • Service graph: Service Graph 시각화용 Prometheus 데이터 소스 연결
  • Node graph: 트레이스 뷰 위에 node graph 활성화
  • Tempo search: Explore에서 검색 옵션 표시·숨김
  • TraceID query: 성능을 위해 TraceID 조회를 시간 범위로 좁힘
  • Tags time range: 태그·태그 값 쿼리의 시간 창 제어
  • Tag limit: Tempo에서 검색할 최대 태그 수 설정
  • Span bar: 스팬 바에 기간 또는 커스텀 태그 표시
  • Private data source connect: 사설 네트워크의 데이터 소스에 연결

Advanced HTTP settings

Grafana Proxy는 전달된 쿠키를 삭제해요. Allowed cookies 필드를 사용해 데이터 소스로 전달해야 하는 쿠키를 이름으로 지정할 수 있어요. Timeout 필드는 HTTP 요청 시간 초과(초)를 설정해요.

Service graph

Service graph 설정은 Service Graph 데이터를 구성해요. Service Graph가 데이터를 표시하려면 Data source 설정에 Prometheus 데이터 소스를 연결해야 해요. 이것 없이 Service Graph 쿼리는 빈 결과를 반환해요. 연결된 Prometheus 데이터 소스는 Grafana Alloy 또는 Tempo metrics generator가 생성한 메트릭을 포함해야 해요. 전체 전제 조건과 트러블슈팅 단계는 Service Graph and Service Graph view를 참고하세요.

참고: 프로비저닝된 데이터 소스(예: Grafana Cloud Traces)를 복제했는데 복제된 데이터 소스 설정에 Service graph 섹션이 나타나지 않으면, 복제된 데이터 소스가 같은 Tempo 백엔드 URL과 인증을 구성했는지 확인하세요. Service graph 섹션은 데이터 소스가 Tempo에 성공적으로 연결될 수 있을 때만 나타나요.

Node graph

Node graph 설정은 기본적으로 활성화되지 않은 node graph 시각화를 활성화해요. 활성화하면 Grafana가 트레이스 뷰 위에 node graph를 표시해요.

Search 설정은 Tempo 검색을 구성해요. Tempo 인스턴스에 검색이 구성되어 있지 않다면, Hide search 설정으로 Explore에서 검색 쿼리 옵션을 숨길 수 있어요.

TraceID query

TraceID query 설정은 TraceID 쿼리가 실행되는 방식을 수정해요. 성능 문제나 시간 초과가 있을 때 시간 범위를 사용할 수 있는데, 검색을 정의된 범위로 좁히기 때문이에요. 이 설정은 기본적으로 비활성화돼 있어요.

이름 설명
Use time range in query TraceID 쿼리에 시간 범위 사용. 기본: disabled.
Time shift for start of search 검색 시작 시간 이동. 기본: 30m.
Time shift for end of search 검색 종료 시간 이동. 기본: 30m.

Tags time range

Tags time range 기능은 태그·태그 값 쿼리에 적용되는 시간 창을 지정해 태그 쿼리가 실행되는 방식을 제어해요. 쿼리를 제한할 다음 옵션 중 하나를 선택할 수 있어요.

이름 설명
Last 30 minutes 선택 범위의 마지막 30분
Last 3 hours 선택 범위의 마지막 3시간
Last 24 hours 선택 범위의 마지막 24시간
Last 3 days 선택 범위의 마지막 3일
Last 7 days 선택 범위의 마지막 7일

Tag limit

Tag limit 설정은 Tempo에서 검색할 태그와 태그 값의 최대 수를 수정해요. 기본값: 5000.

Span bar

Span bar 설정은 스팬 바 행에 추가 정보를 표시하게 도와줘요. 다음 세 가지 옵션 중 하나를 선택할 수 있어요.

이름 설명
None 스팬 바 행에 아무것도 추가하지 않음.
Duration (기본) 스팬 바 행에 스팬 기간을 표시.
Tag 스팬 바 행에 스팬 태그를 표시. 태그 값을 얻으려면 component 같은 태그 키도 지정해야 함.

Private data source connect

참고: 이 기능은 Grafana Cloud에서만 사용 가능해요.

private data source connect (PDC)를 사용해 보안 네트워크 내의 데이터를 Grafana Cloud로부터의 인바운드 트래픽으로 네트워크를 열지 않고 연결·쿼리할 수 있어요. PDC가 어떻게 동작하는지와 PDC 연결 설정 단계는 Private data source connect 및 Grafana private data source connect 구성 문서를 참고하세요. 드롭다운 목록에서 구성된 private data source를 선택해요. 변경하면 Test & save를 선택해 변경 사항을 보존해요. Manage private data source connect로 구성된 private data source를 구성·관리할 수 있어요.

다음 단계 (Next steps)

더 알아보기 (Learn more)