이벤트 계약
쿼리가 예상하는 필드
| 필드 | 유형 | 그것이 존재하는 이유 |
|---|---|---|
| timestamp_utc | Timestamp | 도구 호출이 완료되었을 때. |
| event_name | Utf8 | 이러한 이벤트에 대한 agent_tool_called. |
| data.tool_name | Utf8 | 점선 열로 표시되는 중첩된 도구 식별자입니다. |
| data.status | Utf8 | 중첩된 성공 또는 실패 상태입니다. |
| data.args.operation | Utf8 | 원시 인수가 아닌 안전하고 분류된 작업입니다. |
| data.latency_ms | Float64 | 중첩된 도구 호출 대기 시간. |
쿼리 복사
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_name | operation | calls | failures | failure_rate_pct | p95_latency_ms |
|---|---|---|---|---|---|
| crm_lookup | search_contact | 842 | 61 | 7.24 | 2,180 |
| order_api | fetch_order | 2,210 | 44 | 1.99 | 940 |
| knowledge_search | semantic_search | 4,510 | 19 | 0.42 | 720 |
합성 예제 출력. 운영 결정에 사용하기 전에 자체 이벤트 스키마 및 임계값에 대해 쿼리를 실행하세요.
예제 재현
공공 픽스처 다운로드
JSON 번들은 타입이 지정된 이벤트 계약을 포함합니다. illustrative 입력 행, 정확한 SQL, 예상 출력, 검토 참고 사항 및 엔진 버전. CSV에는 표시된 결과가 포함됩니다.
SQL 작동 방식
- 1점이 유추된 열 이름의 일부이기 때문에 점으로 구분된 필드 이름은 큰따옴표로 묶입니다.
- 2쿼리는 도구와 분류된 작업별로 그룹화되어 하나의 도구의 다양한 동작을 구별할 수 있을 만큼 충분한 컨텍스트를 유지합니다.
- 3원시 도구 인수는 기본적으로 기록되지 않아야 합니다. 대신 안전한 카테고리, 식별자, 결과 필드를 저장하세요.
결정해야 할 극단적인 경우
- 스키마가 발전함에 따라 중첩된 필드 유형을 안정적으로 유지합니다.
- 도구마다 성공 의미가 다를 수 있습니다. 계측 시 상태 값을 정규화합니다.
- 카디널리티가 높은 원시 인수는 개인 정보 보호, 비용 및 유용성 문제를 일으킬 수 있습니다.
추천 대시보드
- 막대형 차트: failure_rate_pct by tool_name
- 꺾은선형 차트: 도구별로 분할된 시간에 따른 p95_latency_ms
- 표: error_type 및 에이전트 워크플로의 최근 실패
레시피를 활용해 보세요
관련 계측 및 가이드
소스 데이터 정의
이 분석을 위한 이벤트 스키마
분석 계속하기
실제 이벤트에서 실행
테이블을 만들고, 필드를 조정하고, 결과를 저장하세요.
무료로 시작하고, 구조화된 이벤트를 보내고, 쿼리 결과를 차트, 공유 대시보드 위젯 또는 알림 입력으로 사용하세요.