هل يوفر n8n أي واجهة برمجية (API) لجلب تحليلات سير العمل أو المقاييس، أم أن هناك أي ميزة مماثلة متاحة من خلال خادم n8n MCP؟
مرحبًا @mylearnings_abu
واجهة برمجة التطبيقات (REST API) العامة لـ n8n تعرض بيانات التنفيذ التي يمكنك الاستعلام عنها برمجيًا. تتضمن نقاط النهاية الرئيسية:
-
GET /api/v1/executions— قائمة التنفيذات مع عوامل التصفية (معرّف سير العمل، الحالة، نطاق التاريخ) -
GET /api/v1/executions/{id}— الحصول على تفاصيل التنفيذ المحدد -
GET /api/v1/workflows— قائمة سير العمل (للمرجع المتقاطع لمعرّفات)
هذه هي الطريقة الأساسية لسحب سجل التنفيذ وتجميع مقاييسك الخاصة (عدد النجاح/الفشل، أوقات التشغيل، إلخ). متاح على كل من Cloud والخوادم الذاتية الاستضافة.
للحصول على المقاييس التشغيلية في الوقت الفعلي، يعرّض n8n نقطة نهاية /metrics عند تفعيلها عبر متغيرات البيئة:
N8N_METRICS=true
N8N_METRICS_INCLUDE_QUEUE_METRICS=true # لوضع قائمة الانتظار
يوفر هذا مقاييس وعدادات مثل:
-
n8n_scaling_mode_queue_jobs_active— الوظائف قيد التشغيل حاليًا -
n8n_scaling_mode_queue_jobs_completed— إجمالي المكتملة منذ البداية -
n8n_scaling_mode_queue_jobs_failed— إجمالي الفاشلة منذ البداية
نقطة نهاية /metrics غير متاحة على n8n Cloud — الخوادم الذاتية الاستضافة فقط.
للتتبع المتعمق لكل تنفيذ، يدعم n8n OpenTelemetry spans، التي تتضمن سمات غنية:
-
n8n.workflow.id،n8n.workflow.name،n8n.execution.status -
n8n.execution.mode(يدوي، webhook، trigger، إعادة محاولة) -
n8n.execution.error_typeعند الفشل
هذا يغذي منصات المراقبة مثل Grafana أو Jaeger أو Datadog
مرجع أدوات خادم MCP يتضمن أداة لتنفيذ سير العمل حسب المعرّف واسترجاع معرّف التنفيذ. ومع ذلك، فإن خادم MCP يركز على تنفيذ وإدارة سير العمل (تشغيل، إدراج، إدارة سير العمل)، وليس على سحب التحليلات أو المقاييس المجمعة. لا توجد أداة MCP مخصصة لجلب إحصائيات التنفيذ أو بيانات التحليلات.
يمكنك الرجوع إلى ما يلي للمرجع السريع
هل هذا مفيد؟
شكراً على الرد السريع!
مرحباً @mylearnings_abu
ميزة التحليلات المدمجة في n8n تسمى Insights، وله نقطة نهاية خاصة به على واجهة برمجية التطبيقات العامة:
GET /api/v1/insights/summary?startDate=2026-07-01T00:00:00Z&endDate=2026-07-29T00:00:00Z
يُرجع إجمالي عمليات الإنتاج المنفذة وعدد الأخطاء ومعدل الفشل والوقت المحفوظ ومتوسط وقت التشغيل، كل واحد منها مع انحراف مقابل الفترة السابقة، بالإضافة إلى مرشح اختياري projectId. يحتاج مفتاح واجهة برمجية التطبيقات ذو النطاق إلى insights:read. يتم عد عمليات الإنتاج من سير العمل الأصلي فقط، لذا يتم استبعاد التشغيل اليدوي وعمليات سير العمل الفرعي من تلك الأرقام.
شكراً @Anshul_Namdev على مشاركة هذا. هل لدينا أي نقطة نهاية لكل سير عمل؟
@Anshul_Namdev لا يمكنني العثور على هذا النطاق في إعداد n8n المستضاف الحالي لدي.
@mylearnings_abu لا توجد نقطة نهاية لكل سير عمل على واجهة برمجة التطبيقات العامة، /insights/summary هي المسار الوحيد للرؤى وprojectId هو عامل التصفية الوحيد. توجد أرقام لكل سير عمل في جدول لوحة معلومات الرؤى، وليس عبر واجهة برمجة التطبيقات.
فيما يتعلق بالنطاق، تم شحن insights:read في الإصدار 2.16 ونقطة النهاية الملخصة في 2.17، لذا فإن أي نسخة أقدم من ذلك لن تعرضها عند إنشاء مفتاح واجهة برمجة التطبيقات. يمنحك الترقية كليهما، الإصدار المستقر الحالي هو 2.32.6.
نظراً لأنك تستخدم الاستضافة الذاتية، فإن نقطة نهاية Prometheus تمنحك أرقام لكل سير عمل اليوم، مع تفعيل تسمية معرف سير العمل:
N8N_METRICS=true
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL=true
أستخدم n8n Enterprise Edition v2.27.4. عند محاولتي إنشاء مفتاح API، لا أرى أي نطاقات متعلقة بـ Insights
هل هناك أي إعدادات إضافية يجب القيام بها؟
مرحباً @mylearnings_abu
1)أولاً، يرجى التحديث إلى أحدث إصدار مستقر من n8n.
2)إذا كان لديك N8N_DISABLED_MODULES=insights معيّناً في بيئتك، فلن تظهر النطاق في واجهة المستخدم لأن الميزة معطّلة.
3)فقط مالكو المثيل والمسؤولون لديهم إمكانية الوصول إلى Insights. تحقق من دورك كمستخدم ضمن الإعدادات > المستخدمون.
4)تأكد من تفعيل ترخيص Enterprise الخاص بك بشكل صحيح. انتقل إلى الإعدادات > الاستخدام والخطة للتحقق.
هل هذا يساعد؟
@mylearnings_abu الإصدار 2.27.4 يأتي مع الـ scope بالفعل، لذا هذا يتعلق برخصة الاستحقاق وليس بالبناء. يعرض منتقي الـ scope فقط insights:read عندما تحمل رخصة النسخة ميزة Enterprise insights، ولن يتم إدراجه على الإطلاق إذا كان المفتاح Enterprise الصادر بدون هذا الاستحقاق. تحقق مما يمنحه مفتاحك فعليًا:
docker exec -u node -it <your-n8n-container-name> n8n license:info
حذف جزء docker exec إذا كنت قد ثبتت باستخدام npm. إذا لم يكن insights في الاستحقاقات المطبوعة، يجب إعادة إصدار المفتاح مقابل خطتك، يمكن لـ support@n8n.io القيام بذلك.