Tempo와 AI

Tempo와 AI

Tempo는 Model Context Protocol(MCP) 서버와 LLM 최적화 API 엔드포인트를 제공해서, AI 에이전트가 트레이스를 직접 검색·비교하고, 지표를 계산하고, 속성을 발견할 수 있게 해줘요. Grafana는 또한 에이전트를 더 넓은 관측가능성 플랫폼에 연결하는 커맨드라인 도구도 제공해요.

출처: Tempo and AI

본문

Model Context Protocol 서버

/api/mcp의 MCP 서버는 에이전트가 TraceQL로 트레이스를 검색하고, ID로 트레이스를 검색·비교하고, 스팬 데이터에서 지표를 계산하고, 사용 가능한 속성을 발견할 수 있게 해줘요. 이 서버는 TraceQL 문법 문서를 MCP 리소스로 제공하므로 에이전트가 훈련 데이터에 의존하는 대신 필요할 때 쿼리 문법을 조회할 수 있어요.

MCP 서버는 streamable-http 전송을 사용하며 다른 Tempo API 엔드포인트와 동일한 인증과 멀티테넌시를 지원해요.

경고: MCP 서버는 호출 에이전트에게 트레이싱 데이터를 반환하는데, 에이전트가 이를 LLM 프로바이더에 전달할 수 있어요. 에이전트를 이 엔드포인트에 연결하기 전에 트레이싱 데이터의 내용과 조직의 정책을 고려하세요.

로컬에서 시도하려면 MCP 서버 빠른 시작을 참고하세요.

LLM 최적화 API 응답

trace by ID v2와 tag values v2 엔드포인트는 Accept: application/vnd.grafana.llm 헤더를 받아들여요. 이는 불필요한 세부 정보를 제거하고 토큰 사용을 줄인 단순화된 JSON 형식을 반환하므로, 에이전트가 컨텍스트 창 안에서 더 큰 트레이스를 처리할 수 있어요.

주의: 단순화된 LLM 형식은 변경될 수 있으며 프로그램적 사용에 의존해서는 안 돼요.

이 헤더는 대화형 또는 실험적 에이전트 사용에 사용하세요. 안정적인 통합에는 MCP 서버를 사용하거나 표준 JSON 또는 protobuf 형식을 요청하세요.

AI 워크플로우에 관련된 Tempo 기능

이 Tempo 기능들은 AI 전용은 아니지만 에이전트가 트레이싱 데이터로 할 수 있는 일을 직접 개선해요.

일반 가용성(GA)의 TraceQL 지표

MCP 서버의 traceql-metrics-instant와 traceql-metrics-range 도구는 에이전트가 트레이스 데이터에서 직접 rate, error, duration 지표를 계산할 수 있게 해줘요. TraceQL 지표가 Tempo 3.0에서 실험 단계에서 GA로 이동했으므로, 이 도구들은 프로덕션 준비 완료 엔진을 질의해요.

태그 자동 완성을 위한 OR 조건

search tags v2와 search tag values v2 API는 OR 조건을 지원하므로 자동 완성 요청이 별도 요청을 하는 대신 단일 호출로 여러 값을 매칭할 수 있어요. 에이전트가 MCP 도구를 통해 사용 가능한 속성을 발견할 때 왕복이 적을수록 질의 가능한 것의 탐색이 더 빠르고 저렴해져요.

에이전트가 접근할 수 있는 것 제어

MCP 서버나 API 엔드포인트로 에이전트에 트레이스 데이터를 열기 전에 무엇이 가능한지 제어할 수 있어요. 트레이스에 개인 식별 정보나 보안 토큰이 포함돼 있다면 Tempo CLI를 사용해 먼저 오브젝트 스토리지에서 영향을 받는 트레이스를 제거해요.

Redact traces는 민감 데이터가 포함된 트레이스를 오브젝트 스토리지에서 제거해요. CLI에서 직접 특정 트레이스를 제거하려면 drop traces by ID를 참고하세요.

AI 워크플로우용 Grafana 도구

이 기능들은 Tempo 전용이 아니에요. Grafana 제품군에서 작업하면 갖게 되며 플랫폼 전반에 적용돼요. 그 AI 가치는 구성 가능성(composability)이에요: Tempo의 트레이스 데이터에서 시작한 에이전트가 바깥으로 확장해 Grafana 리소스에 조치하고, 다른 신호에 걸쳐 조사를 이어가고, 최신 문서를 조회할 수 있어요.

Grafana의 AI 기능에 대한 추가 정보는 AI and machine learning 문서를 참고하세요.

gcx

gcx는 대시보드, 데이터 소스, 알림 규칙, Synthetic Monitoring, SLO, Adaptive Telemetry 같은 Grafana Cloud 제품을 포함한 Grafana 리소스를 관리하는 CLI예요. Grafana Cloud, Grafana Enterprise, Grafana OSS(v12 이상)와 함께 동작해요.

에이전트는 Tempo MCP 서버와 함께 gcx를 사용해 트레이스에서 찾은 것에 조치할 수 있어요. 예를 들어 지연 문제를 식별한 후 에이전트는 터미널을 떠나지 않고 gcx로 관련 Prometheus 지표를 질의하거나 알림 규칙을 검사할 수 있어요.

Grafana Assistant CLI

Grafana Assistant는 Grafana Cloud에 내장된 LLM 기반 도구로, 자연어로 데이터를 질의하고 대시보드를 만들며 오류를 이해하는 데 도움을 줘요. Grafana Assistant가 활성화된 Grafana 인스턴스(예: Grafana Cloud 스택)가 필요해요.

assistant-cli는 Agent-to-Agent(A2A) API를 통해 에이전트를 Grafana Assistant에 연결해요. 이는 에이전트가 터미널에서 관측가능성 신호에 걸쳐 조사를 이어갈 수 있게 해줘요. 예를 들어 에이전트가 Tempo에서 실패한 트레이스를 찾은 다음 assistant-cli로 그 실패를 오류 로그와 연관하거나 관련 지표를 질의할 수 있어요.

마크다운 문서

Grafana 문서는 마크다운으로 제공되므로 에이전트가 잠재적으로 오래된 훈련 데이터에 의존하는 대신 최신 참고 자료를 가져올 수 있어요.

다음 단계

  • MCP 서버 설정으로 에이전트에 트레이싱 데이터에 대한 접근 권한 부여
  • gcx 설치로 터미널이나 에이전트 워크플로우에서 Grafana 리소스 관리
  • assistant-cli 설치로 에이전트를 Grafana Assistant에 연결

더 알아보기 (Learn more)