콘텐츠로 건너뛰기
Telemetry
구조화된 이벤트 SQL 레시피

중첩된 AI 도구 호출 이벤트 쿼리

원래 이벤트 페이로드를 평면화하지 않고 점으로 중첩된 필드를 필터링하고 실패한 도구의 순위를 매깁니다.

중급agent_events검토됨 2026-07-27테스트됨 아파치 DataFusion 45.2.0

검토자 Telemetry 제품 팀 . SQL 호환성, 이벤트 계약, 합성 출력 및 운영상의 주의사항. 표준 및 소유권 검토

질문에 답변됨

가장 많이 실패한 호출과 관련된 AI 도구 및 인수는 무엇입니까?

구조화된 에이전트 이벤트는 종종 중첩된 도구 컨텍스트를 전달합니다. Telemetry는 중첩된 값을 안정적인 점선 열로 노출하므로 수집 시 자연스러운 이벤트 형태를 유지하면서 SQL을 읽을 수 있게 유지합니다.

이벤트 계약

쿼리가 예상하는 필드

필드유형그것이 존재하는 이유
timestamp_utcTimestamp도구 호출이 완료되었을 때.
event_nameUtf8이러한 이벤트에 대한 agent_tool_called.
data.tool_nameUtf8점선 열로 표시되는 중첩된 도구 식별자입니다.
data.statusUtf8중첩된 성공 또는 실패 상태입니다.
data.args.operationUtf8원시 인수가 아닌 안전하고 분류된 작업입니다.
data.latency_msFloat64중첩된 도구 호출 대기 시간.
DataFusion SQL

쿼리 복사

sql
SELECT
  "data.tool_name" AS tool_name,
  "data.args.operation" AS operation,
  COUNT(*) AS calls,
  SUM(CASE
    WHEN "data.status" = 'failed' THEN 1 ELSE 0
  END) AS failures,
  100.0 * SUM(CASE
    WHEN "data.status" = 'failed' THEN 1 ELSE 0
  END) / NULLIF(COUNT(*), 0) AS failure_rate_pct,
  approx_percentile_cont("data.latency_ms", 0.95) AS p95_latency_ms
FROM agent_events
WHERE event_name = 'agent_tool_called'
  AND timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY "data.tool_name", "data.args.operation"
HAVING COUNT(*) >= 20
ORDER BY failure_rate_pct DESC, calls DESC;

이 읽기 전용 쿼리는 빈 유형의 테이블에 대해 계획되고 실행됩니다. 아파치 DataFusion 45.2.0. 결정론적 샘플 출력은 합성되어 별도로 검토됩니다. 자신의 데이터에 대해 필드 유형, 임계값 및 비즈니스 정의를 검증합니다. 테스트 방법론을 읽어보세요.

쿼리 결과

도구 호출 실패율

CRM 조회는 안정성이 가장 낮은 도구 작업이자 p95에서 가장 느린 작업입니다.

tool_nameoperationcallsfailuresfailure_rate_pctp95_latency_ms
crm_lookupsearch_contact842617.242,180
order_apifetch_order2,210441.99940
knowledge_searchsemantic_search4,510190.42720

합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.

Tool-call failure rate: Query Nested AI Tool-Call Events 예제 결과의 합성 failure_rate_pct 값에 대한 정적 차트
결정론적 예제 출력의 색인 생성 가능한 SVG입니다. 기사, 런북 또는 저작자가 포함된 디자인 검토를 위해 다운로드하세요.

예제 재현

공공 픽스처 다운로드

JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. illustrative 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.

SQL 작동 방식

  1. 1점이 유추된 열 이름의 일부이기 때문에 점으로 구분된 필드 이름은 큰따옴표로 묶입니다.
  2. 2쿼리는 도구와 분류된 작업별로 그룹화되어 하나의 도구의 다양한 동작을 구별할 수 있을 만큼 충분한 컨텍스트를 유지합니다.
  3. 3원시 도구 인수는 기본적으로 기록되지 않아야 합니다. 대신 안전한 카테고리, 식별자, 결과 필드를 저장하세요.

결정해야 할 극단적인 경우

  • 스키마가 발전함에 따라 중첩된 필드 유형을 안정적으로 유지합니다.
  • 도구마다 성공 의미가 다를 수 있습니다. 계측 시 상태 값을 정규화합니다.
  • 카디널리티가 높은 원시 인수는 개인 정보 보호, 비용 및 유용성 문제를 일으킬 수 있습니다.

추천 대시보드

  • 막대형 차트: failure_rate_pct by tool_name
  • 꺾은선형 차트: 도구별로 분할된 시간에 따른 p95_latency_ms
  • 표: error_type 및 에이전트 워크플로의 최근 실패

알림 안내

프로덕션 도구의 실패율이 의미 있는 양으로 임계값을 초과할 때 알림하고 알림을 소유 통합으로 라우팅합니다.

알림 설정 읽기

레시피를 활용해 보세요

관련 계측 및 가이드

소스 데이터 정의

이 분석을 위한 이벤트 스키마

분석 계속하기

실제 이벤트에서 실행

테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.

무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.

API 키 받기