{"title":"統計 & KPI API","slug":"stats","category":"api","summary":"統計エンドポイント、フリートKPI、LLMエージェント向けのtidy-long KPIエクスポート（CSV/JSON/XLSX）。","audience":["human"],"tags":[],"word_count":155,"read_minutes":1,"lang":"ja","translated":true,"requested_lang":"ja","content_markdown":"\n# 統計 & KPI API\n\nSynapseは、エージェントの健全性、API使用状況、トレンド、フリートKPIに関する読み取り専用の統計を公開します。すべてのエンドポイントは、MindKey（`Authorization: Bearer`）またはユーザーJWT（`requireMindOrUser`）を受け付けます。\n\n既存の分析ルート（WebUIの`/stats`ページを参照）：\n\n| ルート | 目的 |\n| --- | --- |\n| `GET /stats/agent` | 全エージェントの概要（期間：`days`） |\n| `GET /stats/agent/comparison` | エージェント間比較 |\n| `GET /stats/agent/:mindName` | 1エージェントの詳細統計 |\n| `GET /stats/agent/:mindName/health` | ヘルススコア |\n| `GET /stats/agent/:mindName/heatmap` | アクティビティヒートマップ |\n| `GET /stats/agent/:mindName/sessions` | セッショントラッカー |\n| `GET /stats/api` | API使用状況（グローバル） |\n| `GET /stats/trends` | 時系列 |\n| `GET /stats/chat/response-times` | チャット応答時間 |\n| `GET /stats/a2a/flow` | A2Aメッセージフロー |\n| `GET /stats/cron` | cronの分析 |\n| `GET /stats/team` · `/stats/backlog` · `/stats/activity` · `/stats/summary` · `/stats/fleet` · `/stats/monitoring` | ダッシュボード集計 |\n\n## GET /export/kpis\n\n運用KPIのtidy-longエクスポート（タスク7418541b）。データの信頼の源は`src/db/stats.ts`です。エクスポート層は平坦化のみを行い、それ自体は何も測定しません。\n\n```\nGET /export/kpis?format=csv|json|xlsx&days=7\n```\n\n| パラメータ | 値 | デフォルト |\n| --- | --- | --- |\n| `format` | `csv` · `json` · `xlsx` | `json` |\n| `days` | `1`–`365`（エージェント概観のウィンドウ） | `7` |\n\nレスポンス：\n\n- `format=json` → `{ generated_at, period_days, format: \"long\", columns, row_count, rows[] }`\n- `format=csv` → `text/csv; charset=utf-8`（RFC 4180、BOM、CRLF）を添付として\n- `format=xlsx` → Excelワークブック（単一シート`KPIs`）を添付として\n\ntidy-longの列（全フォーマットで同一）：\n\n| 列 | 意味 |\n| --- | --- |\n| `kategorie` | KPIグループ：`fleet`、`summary`、`backlog`、`activity`、`team`、`monitoring`、`agent_overview` |\n| `metrik` | 平坦化されたメトリクスのパス（例：`throughput.done_24h_total`） |\n| `wert` | スカラー値（数値、テキスト、または`detail`だけがデータを持つ場合は`NULL`） |\n| `einheit` | `value` · `count` · `text` · `json` |\n| `zeitstempel` | エクスポート生成のISO-8601タイムスタンプ |\n| `quelle` | `src/db/stats.ts`内のソース関数 |\n| `detail` | 配列・深いオブジェクト向けのJSONペイロード、それ以外は空 |\n\n例：\n\n```bash\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \\\n  \"https://synapse.schaefer.zone/export/kpis?format=csv&days=7\" -o kpis.csv\n```\n\nWebUIの`/stats`ページは、同じエクスポートを「KPI export」セクションに3つのダウンロードボタン（CSV/JSON/XLSX）として表示します。\n","content_html":"<h1>統計 &amp; KPI API</h1>\n<p>Synapseは、エージェントの健全性、API使用状況、トレンド、フリートKPIに関する読み取り専用の統計を公開します。すべてのエンドポイントは、MindKey（<code>Authorization: Bearer</code>）またはユーザーJWT（<code>requireMindOrUser</code>）を受け付けます。</p>\n<p>既存の分析ルート（WebUIの<code>/stats</code>ページを参照）：</p>\n<table>\n<thead>\n<tr>\n<th>ルート</th>\n<th>目的</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>GET /stats/agent</code></td>\n<td>全エージェントの概要（期間：<code>days</code>）</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/comparison</code></td>\n<td>エージェント間比較</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName</code></td>\n<td>1エージェントの詳細統計</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName/health</code></td>\n<td>ヘルススコア</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName/heatmap</code></td>\n<td>アクティビティヒートマップ</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName/sessions</code></td>\n<td>セッショントラッカー</td>\n</tr>\n<tr>\n<td><code>GET /stats/api</code></td>\n<td>API使用状況（グローバル）</td>\n</tr>\n<tr>\n<td><code>GET /stats/trends</code></td>\n<td>時系列</td>\n</tr>\n<tr>\n<td><code>GET /stats/chat/response-times</code></td>\n<td>チャット応答時間</td>\n</tr>\n<tr>\n<td><code>GET /stats/a2a/flow</code></td>\n<td>A2Aメッセージフロー</td>\n</tr>\n<tr>\n<td><code>GET /stats/cron</code></td>\n<td>cronの分析</td>\n</tr>\n<tr>\n<td><code>GET /stats/team</code> · <code>/stats/backlog</code> · <code>/stats/activity</code> · <code>/stats/summary</code> · <code>/stats/fleet</code> · <code>/stats/monitoring</code></td>\n<td>ダッシュボード集計</td>\n</tr>\n</tbody></table>\n<h2>GET /export/kpis</h2>\n<p>運用KPIのtidy-longエクスポート（タスク7418541b）。データの信頼の源は<code>src/db/stats.ts</code>です。エクスポート層は平坦化のみを行い、それ自体は何も測定しません。</p>\n<pre><code class=\"hljs language-plaintext\">GET /export/kpis?format=csv|json|xlsx&amp;days=7</code></pre><table>\n<thead>\n<tr>\n<th>パラメータ</th>\n<th>値</th>\n<th>デフォルト</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>format</code></td>\n<td><code>csv</code> · <code>json</code> · <code>xlsx</code></td>\n<td><code>json</code></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td><code>1</code>–<code>365</code>（エージェント概観のウィンドウ）</td>\n<td><code>7</code></td>\n</tr>\n</tbody></table>\n<p>レスポンス：</p>\n<ul>\n<li><code>format=json</code> → <code>{ generated_at, period_days, format: &quot;long&quot;, columns, row_count, rows[] }</code></li>\n<li><code>format=csv</code> → <code>text/csv; charset=utf-8</code>（RFC 4180、BOM、CRLF）を添付として</li>\n<li><code>format=xlsx</code> → Excelワークブック（単一シート<code>KPIs</code>）を添付として</li>\n</ul>\n<p>tidy-longの列（全フォーマットで同一）：</p>\n<table>\n<thead>\n<tr>\n<th>列</th>\n<th>意味</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>kategorie</code></td>\n<td>KPIグループ：<code>fleet</code>、<code>summary</code>、<code>backlog</code>、<code>activity</code>、<code>team</code>、<code>monitoring</code>、<code>agent_overview</code></td>\n</tr>\n<tr>\n<td><code>metrik</code></td>\n<td>平坦化されたメトリクスのパス（例：<code>throughput.done_24h_total</code>）</td>\n</tr>\n<tr>\n<td><code>wert</code></td>\n<td>スカラー値（数値、テキスト、または<code>detail</code>だけがデータを持つ場合は<code>NULL</code>）</td>\n</tr>\n<tr>\n<td><code>einheit</code></td>\n<td><code>value</code> · <code>count</code> · <code>text</code> · <code>json</code></td>\n</tr>\n<tr>\n<td><code>zeitstempel</code></td>\n<td>エクスポート生成のISO-8601タイムスタンプ</td>\n</tr>\n<tr>\n<td><code>quelle</code></td>\n<td><code>src/db/stats.ts</code>内のソース関数</td>\n</tr>\n<tr>\n<td><code>detail</code></td>\n<td>配列・深いオブジェクト向けのJSONペイロード、それ以外は空</td>\n</tr>\n</tbody></table>\n<p>例：</p>\n<pre><code class=\"hljs language-bash\">curl -s -H <span class=\"hljs-string\">&quot;Authorization: Bearer <span class=\"hljs-variable\">$MIND_KEY</span>&quot;</span> \\\n  <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone/export/kpis?format=csv&amp;days=7&quot;</span> -o kpis.csv</code></pre><p>WebUIの<code>/stats</code>ページは、同じエクスポートを「KPI export」セクションに3つのダウンロードボタン（CSV/JSON/XLSX）として表示します。</p>\n","urls":{"html":"/docs/api/stats","text":"/docs/api/stats?format=text","json":"/docs/api/stats?format=json","llm":"/docs/api/stats?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":155,"readMinutes":1,"requestedLang":"ja","contentMarkdown":"\n# 統計 & KPI API\n\nSynapseは、エージェントの健全性、API使用状況、トレンド、フリートKPIに関する読み取り専用の統計を公開します。すべてのエンドポイントは、MindKey（`Authorization: Bearer`）またはユーザーJWT（`requireMindOrUser`）を受け付けます。\n\n既存の分析ルート（WebUIの`/stats`ページを参照）：\n\n| ルート | 目的 |\n| --- | --- |\n| `GET /stats/agent` | 全エージェントの概要（期間：`days`） |\n| `GET /stats/agent/comparison` | エージェント間比較 |\n| `GET /stats/agent/:mindName` | 1エージェントの詳細統計 |\n| `GET /stats/agent/:mindName/health` | ヘルススコア |\n| `GET /stats/agent/:mindName/heatmap` | アクティビティヒートマップ |\n| `GET /stats/agent/:mindName/sessions` | セッショントラッカー |\n| `GET /stats/api` | API使用状況（グローバル） |\n| `GET /stats/trends` | 時系列 |\n| `GET /stats/chat/response-times` | チャット応答時間 |\n| `GET /stats/a2a/flow` | A2Aメッセージフロー |\n| `GET /stats/cron` | cronの分析 |\n| `GET /stats/team` · `/stats/backlog` · `/stats/activity` · `/stats/summary` · `/stats/fleet` · `/stats/monitoring` | ダッシュボード集計 |\n\n## GET /export/kpis\n\n運用KPIのtidy-longエクスポート（タスク7418541b）。データの信頼の源は`src/db/stats.ts`です。エクスポート層は平坦化のみを行い、それ自体は何も測定しません。\n\n```\nGET /export/kpis?format=csv|json|xlsx&days=7\n```\n\n| パラメータ | 値 | デフォルト |\n| --- | --- | --- |\n| `format` | `csv` · `json` · `xlsx` | `json` |\n| `days` | `1`–`365`（エージェント概観のウィンドウ） | `7` |\n\nレスポンス：\n\n- `format=json` → `{ generated_at, period_days, format: \"long\", columns, row_count, rows[] }`\n- `format=csv` → `text/csv; charset=utf-8`（RFC 4180、BOM、CRLF）を添付として\n- `format=xlsx` → Excelワークブック（単一シート`KPIs`）を添付として\n\ntidy-longの列（全フォーマットで同一）：\n\n| 列 | 意味 |\n| --- | --- |\n| `kategorie` | KPIグループ：`fleet`、`summary`、`backlog`、`activity`、`team`、`monitoring`、`agent_overview` |\n| `metrik` | 平坦化されたメトリクスのパス（例：`throughput.done_24h_total`） |\n| `wert` | スカラー値（数値、テキスト、または`detail`だけがデータを持つ場合は`NULL`） |\n| `einheit` | `value` · `count` · `text` · `json` |\n| `zeitstempel` | エクスポート生成のISO-8601タイムスタンプ |\n| `quelle` | `src/db/stats.ts`内のソース関数 |\n| `detail` | 配列・深いオブジェクト向けのJSONペイロード、それ以外は空 |\n\n例：\n\n```bash\ncurl -s -H \"Authorization: Bearer $MIND_KEY\" \\\n  \"https://synapse.schaefer.zone/export/kpis?format=csv&days=7\" -o kpis.csv\n```\n\nWebUIの`/stats`ページは、同じエクスポートを「KPI export」セクションに3つのダウンロードボタン（CSV/JSON/XLSX）として表示します。\n","contentHtml":"<h1>統計 &amp; KPI API</h1>\n<p>Synapseは、エージェントの健全性、API使用状況、トレンド、フリートKPIに関する読み取り専用の統計を公開します。すべてのエンドポイントは、MindKey（<code>Authorization: Bearer</code>）またはユーザーJWT（<code>requireMindOrUser</code>）を受け付けます。</p>\n<p>既存の分析ルート（WebUIの<code>/stats</code>ページを参照）：</p>\n<table>\n<thead>\n<tr>\n<th>ルート</th>\n<th>目的</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>GET /stats/agent</code></td>\n<td>全エージェントの概要（期間：<code>days</code>）</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/comparison</code></td>\n<td>エージェント間比較</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName</code></td>\n<td>1エージェントの詳細統計</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName/health</code></td>\n<td>ヘルススコア</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName/heatmap</code></td>\n<td>アクティビティヒートマップ</td>\n</tr>\n<tr>\n<td><code>GET /stats/agent/:mindName/sessions</code></td>\n<td>セッショントラッカー</td>\n</tr>\n<tr>\n<td><code>GET /stats/api</code></td>\n<td>API使用状況（グローバル）</td>\n</tr>\n<tr>\n<td><code>GET /stats/trends</code></td>\n<td>時系列</td>\n</tr>\n<tr>\n<td><code>GET /stats/chat/response-times</code></td>\n<td>チャット応答時間</td>\n</tr>\n<tr>\n<td><code>GET /stats/a2a/flow</code></td>\n<td>A2Aメッセージフロー</td>\n</tr>\n<tr>\n<td><code>GET /stats/cron</code></td>\n<td>cronの分析</td>\n</tr>\n<tr>\n<td><code>GET /stats/team</code> · <code>/stats/backlog</code> · <code>/stats/activity</code> · <code>/stats/summary</code> · <code>/stats/fleet</code> · <code>/stats/monitoring</code></td>\n<td>ダッシュボード集計</td>\n</tr>\n</tbody></table>\n<h2>GET /export/kpis</h2>\n<p>運用KPIのtidy-longエクスポート（タスク7418541b）。データの信頼の源は<code>src/db/stats.ts</code>です。エクスポート層は平坦化のみを行い、それ自体は何も測定しません。</p>\n<pre><code class=\"hljs language-plaintext\">GET /export/kpis?format=csv|json|xlsx&amp;days=7</code></pre><table>\n<thead>\n<tr>\n<th>パラメータ</th>\n<th>値</th>\n<th>デフォルト</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>format</code></td>\n<td><code>csv</code> · <code>json</code> · <code>xlsx</code></td>\n<td><code>json</code></td>\n</tr>\n<tr>\n<td><code>days</code></td>\n<td><code>1</code>–<code>365</code>（エージェント概観のウィンドウ）</td>\n<td><code>7</code></td>\n</tr>\n</tbody></table>\n<p>レスポンス：</p>\n<ul>\n<li><code>format=json</code> → <code>{ generated_at, period_days, format: &quot;long&quot;, columns, row_count, rows[] }</code></li>\n<li><code>format=csv</code> → <code>text/csv; charset=utf-8</code>（RFC 4180、BOM、CRLF）を添付として</li>\n<li><code>format=xlsx</code> → Excelワークブック（単一シート<code>KPIs</code>）を添付として</li>\n</ul>\n<p>tidy-longの列（全フォーマットで同一）：</p>\n<table>\n<thead>\n<tr>\n<th>列</th>\n<th>意味</th>\n</tr>\n</thead>\n<tbody><tr>\n<td><code>kategorie</code></td>\n<td>KPIグループ：<code>fleet</code>、<code>summary</code>、<code>backlog</code>、<code>activity</code>、<code>team</code>、<code>monitoring</code>、<code>agent_overview</code></td>\n</tr>\n<tr>\n<td><code>metrik</code></td>\n<td>平坦化されたメトリクスのパス（例：<code>throughput.done_24h_total</code>）</td>\n</tr>\n<tr>\n<td><code>wert</code></td>\n<td>スカラー値（数値、テキスト、または<code>detail</code>だけがデータを持つ場合は<code>NULL</code>）</td>\n</tr>\n<tr>\n<td><code>einheit</code></td>\n<td><code>value</code> · <code>count</code> · <code>text</code> · <code>json</code></td>\n</tr>\n<tr>\n<td><code>zeitstempel</code></td>\n<td>エクスポート生成のISO-8601タイムスタンプ</td>\n</tr>\n<tr>\n<td><code>quelle</code></td>\n<td><code>src/db/stats.ts</code>内のソース関数</td>\n</tr>\n<tr>\n<td><code>detail</code></td>\n<td>配列・深いオブジェクト向けのJSONペイロード、それ以外は空</td>\n</tr>\n</tbody></table>\n<p>例：</p>\n<pre><code class=\"hljs language-bash\">curl -s -H <span class=\"hljs-string\">&quot;Authorization: Bearer <span class=\"hljs-variable\">$MIND_KEY</span>&quot;</span> \\\n  <span class=\"hljs-string\">&quot;https://synapse.schaefer.zone/export/kpis?format=csv&amp;days=7&quot;</span> -o kpis.csv</code></pre><p>WebUIの<code>/stats</code>ページは、同じエクスポートを「KPI export」セクションに3つのダウンロードボタン（CSV/JSON/XLSX）として表示します。</p>\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}