{"title":"सांख्यिकी और KPI API","slug":"stats","category":"api","summary":"सांख्यिकी एंडपॉइंट, फ्लीट KPI और LLM एजेंटों के लिए tidy-long KPI निर्यात (CSV/JSON/XLSX)।","audience":["human"],"tags":[],"word_count":316,"read_minutes":2,"lang":"hi","translated":true,"requested_lang":"hi","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` | एक एजेंट के विस्तृत आँकड़े |\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` | क्रॉन विश्लेषण |\n| `GET /stats/team` · `/stats/backlog` · `/stats/activity` · `/stats/summary` · `/stats/fleet` · `/stats/monitoring` | डैशबोर्ड समुच्चय |\n\n## GET /export/kpis\n\nपरिचालन KPI का tidy-long निर्यात (task 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` | स्केलर मान (संख्या, पाठ या `NULL` जब केवल `detail` डेटा ले जाता है) |\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» अनुभाग में तीन डाउनलोड बटनों (CSV/JSON/XLSX) के रूप में प्रस्तुत करता है।\n","content_html":"<h1>सांख्यिकी और 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>एक एजेंट के विस्तृत आँकड़े</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>क्रॉन विश्लेषण</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 निर्यात (task 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>NULL</code> जब केवल <code>detail</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» अनुभाग में तीन डाउनलोड बटनों (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":316,"readMinutes":2,"requestedLang":"hi","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` | एक एजेंट के विस्तृत आँकड़े |\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` | क्रॉन विश्लेषण |\n| `GET /stats/team` · `/stats/backlog` · `/stats/activity` · `/stats/summary` · `/stats/fleet` · `/stats/monitoring` | डैशबोर्ड समुच्चय |\n\n## GET /export/kpis\n\nपरिचालन KPI का tidy-long निर्यात (task 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` | स्केलर मान (संख्या, पाठ या `NULL` जब केवल `detail` डेटा ले जाता है) |\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» अनुभाग में तीन डाउनलोड बटनों (CSV/JSON/XLSX) के रूप में प्रस्तुत करता है।\n","contentHtml":"<h1>सांख्यिकी और 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>एक एजेंट के विस्तृत आँकड़े</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>क्रॉन विश्लेषण</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 निर्यात (task 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>NULL</code> जब केवल <code>detail</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» अनुभाग में तीन डाउनलोड बटनों (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"]}