{"title":"واجهة الإحصاءات ومؤشرات الأداء","slug":"stats","category":"api","summary":"نقاط النهاية للإحصاءات، ومؤشرات أداء الأسطول، وتصدير KPI بنمط tidy-long (CSV/JSON/XLSX) لعملاء LLM.","audience":["human"],"tags":[],"word_count":297,"read_minutes":1,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# واجهة الإحصاءات ومؤشرات الأداء\n\nتعرض Synapse إحصاءات للقراءة فقط عن صحة الوكلاء، واستخدام الواجهة البرمجية، والاتجاهات الزمنية، ومؤشرات أداء الأسطول. تقبل جميع نقاط النهاية إما MindKey (`Authorization: Bearer`) أو JWT للمستخدم (`requireMindOrUser`).\n\nمسارات التحليلات الموجودة (انظر صفحة `/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` | استخدام الواجهة البرمجية (عالمي) |\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تصدير مؤشرات الأداء التشغيلية بنمط 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\nأعمدة tidy-long (متطابقة في كل الصيغ):\n\n| العمود | المعنى |\n| --- | --- |\n| `kategorie` | مجموعة المؤشر: `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\nتعرض صفحة `/stats` في واجهة الويب التصدير نفسه كثلاثة أزرار تنزيل (CSV/JSON/XLSX) في قسم «KPI export».\n","content_html":"<h1>واجهة الإحصاءات ومؤشرات الأداء</h1>\n<p>تعرض Synapse إحصاءات للقراءة فقط عن صحة الوكلاء، واستخدام الواجهة البرمجية، والاتجاهات الزمنية، ومؤشرات أداء الأسطول. تقبل جميع نقاط النهاية إما MindKey (<code>Authorization: Bearer</code>) أو JWT للمستخدم (<code>requireMindOrUser</code>).</p>\n<p>مسارات التحليلات الموجودة (انظر صفحة <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>استخدام الواجهة البرمجية (عالمي)</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>تصدير مؤشرات الأداء التشغيلية بنمط 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>مجموعة المؤشر: <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>تعرض صفحة <code>/stats</code> في واجهة الويب التصدير نفسه كثلاثة أزرار تنزيل (CSV/JSON/XLSX) في قسم «KPI export».</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":297,"readMinutes":1,"requestedLang":"ar","contentMarkdown":"\n# واجهة الإحصاءات ومؤشرات الأداء\n\nتعرض Synapse إحصاءات للقراءة فقط عن صحة الوكلاء، واستخدام الواجهة البرمجية، والاتجاهات الزمنية، ومؤشرات أداء الأسطول. تقبل جميع نقاط النهاية إما MindKey (`Authorization: Bearer`) أو JWT للمستخدم (`requireMindOrUser`).\n\nمسارات التحليلات الموجودة (انظر صفحة `/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` | استخدام الواجهة البرمجية (عالمي) |\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تصدير مؤشرات الأداء التشغيلية بنمط 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\nأعمدة tidy-long (متطابقة في كل الصيغ):\n\n| العمود | المعنى |\n| --- | --- |\n| `kategorie` | مجموعة المؤشر: `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\nتعرض صفحة `/stats` في واجهة الويب التصدير نفسه كثلاثة أزرار تنزيل (CSV/JSON/XLSX) في قسم «KPI export».\n","contentHtml":"<h1>واجهة الإحصاءات ومؤشرات الأداء</h1>\n<p>تعرض Synapse إحصاءات للقراءة فقط عن صحة الوكلاء، واستخدام الواجهة البرمجية، والاتجاهات الزمنية، ومؤشرات أداء الأسطول. تقبل جميع نقاط النهاية إما MindKey (<code>Authorization: Bearer</code>) أو JWT للمستخدم (<code>requireMindOrUser</code>).</p>\n<p>مسارات التحليلات الموجودة (انظر صفحة <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>استخدام الواجهة البرمجية (عالمي)</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>تصدير مؤشرات الأداء التشغيلية بنمط 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>مجموعة المؤشر: <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>تعرض صفحة <code>/stats</code> في واجهة الويب التصدير نفسه كثلاثة أزرار تنزيل (CSV/JSON/XLSX) في قسم «KPI export».</p>\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}