# 통계 & KPI API
SUMMARY: 통계 엔드포인트, 플릿 KPI, LLM 에이전트를 위한 tidy-long KPI 내보내기(CSV/JSON/XLSX).

통계 & KPI API
Synapse는 에이전트 건강, API 사용량, 추세, 플릿 KPI에 대한 읽기 전용 통계를 노출합니다. 모든 엔드포인트는 MindKey() 또는 사용자 JWT()를 받습니다.
기존 분석 라우트(WebUI의  페이지 참조):
| 라우트 | 목적 |
| --- | --- |
|  | 모든 에이전트 개요(기간: ) |
|  | 에이전트 간 비교 |
|  | 한 에이전트의 상세 통계 |
|  | 건강 점수 |
|  | 활동 히트맵 |
|  | 세션 트래커 |
|  | API 사용량(전역) |
|  | 시계열 |
|  | 채팅 응답 시간 |
|  | A2A 메시지 흐름 |
|  | 크론 분석 |
|  ·  ·  ·  ·  ·  | 대시보드 집계 |
GET /export/kpis
운영 KPI의 tidy-long 내보내기(task 7418541b). 데이터의 진실 원천은 입니다 — 내보내기 계층은 평탄화만 하며, 스스로는 아무것도 측정하지 않습니다.
[CODE BLOCK]
| 매개변수 | 값 | 기본값 |
| --- | --- | --- |
|  |  ·  ·  |  |
|  | –(에이전트 개요의 창) |  |
응답:
-  → 
-  → (RFC 4180, BOM, CRLF) 첨부파일로
-  → Excel 통합문서(단일 시트 ) 첨부파일로
tidy-long 열(모든 형식에서 동일):
| 열 | 의미 |
| --- | --- |
|  | KPI 그룹: , , , , , ,  |
|  | 평탄화된 메트릭 경로(예: ) |
|  | 스칼라 값(숫자, 텍스트 또는 만 데이터를 담을 때 ) |
|  |  ·  ·  ·  |
|  | 내보내기 생성의 ISO-8601 타임스탬프 |
|  | 의 원천 함수 |
|  | 배열/깊은 객체용 JSON 페이로드, 그 외에는 비어 있음 |
예시:
[CODE BLOCK]
WebUI의  페이지는 같은 내보내기를 「KPI export」 섹션에 세 개의 다운로드 버튼(CSV/JSON/XLSX)으로 렌더링합니다.