إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

ربط Azure Monitor

دليل إرشاديتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: مسؤول الكيان
الخططFree · Core · Pro · Enterpriseالنشراستضافة ذاتية

اربط Azure Monitor لجلب موارد Azure الخاصة بك إلى Excubius مع مقاييس المنصة والتنبيهات المُطلقة وتشغيلات Data Factory والأسرار التي توشك صلاحيتها على الانتهاء. يوضح هذا الدليل الأدوار بأقل الامتيازات على جانب Azure، وكيفية إضافة المصدر، وكيفية استقبال التنبيهات عبر مجموعة إجراءات (action group).

قبل البدء​

  • تحتاج إلى دور Entity admin على الكيان الذي تنتمي إليه الاشتراكات.
  • في Azure، شخص يستطيع تعيين الأدوار على الاشتراكات، ومنح موافقة المسؤول في Entra ID إذا أردت مراقبة انتهاء صلاحية تسجيل التطبيقات.
  • الميزة sources.azure_monitor مشغّلة. راجع المصادر.

ما الذي يقرؤه Excubius​

تُقرأ Azure عبر Azure Resource Manager وResource Graph وAzure Monitor وAlerts Management وData Factory ومستوى بيانات Key Vault وMicrosoft Graph. وكل استدعاء هو قراءة؛ أما طلبات POST القليلة فهي استعلامات، مثل استعلام Resource Graph، أو استعلام تشغيلات خط الأنابيب أو المشغّل، أو حالة وقت تشغيل التكامل.

المرحلةما الذي يُقرأالفاصل الافتراضي
Inventoryاستعلام Resource Graph واحد عبر الاشتراكات، يقتصر على أنواع الموارد التي تختارها15 دقيقة
Metricsفحوص وحدة Azure (مقاييس المنصة وصفوف Resource Graph مثل مهام النسخ الاحتياطي)، وحالة نفق VPN، وكذلك فحوص Data Factory وانتهاء صلاحية Key Vault وانتهاء صلاحية أسرار تسجيلات التطبيقات، ويمكن تشغيل كل منها أو إيقافه5 دقائق
Alertsتنبيهات Azure Monitor المُطلقة خلال آخر 30 يومًا، بحسب المورد المستهدف5 دقائق في Polling؛ ومصالحة كل 15 دقيقة في Hybrid

اختيار الهوية​

الهويةمتى تستخدمها
The server's managed identity (موصى بها)يعمل خادم Excubius في Azure وتستطيع هويته الوصول إلى الاشتراكات. لا شيء لتخزينه أو تدويره. وهي الهوية المعيّنة من النظام (system-assigned) للجهاز الظاهري، أو هوية معيّنة من المستخدم (user-assigned) عندما يسميها AZURE_CLIENT_ID في ملف .env
A service principalالاشتراكات في مستأجر لا تستطيع هوية الخادم الوصول إليه. تسجيل تطبيق بسر عميل؛ دوّر السر قبل انتهاء صلاحيته

عندما يضبط ملف .env كلًّا من AZURE_TENANT_ID وAZURE_CLIENT_ID وAZURE_CLIENT_SECRET، يستخدم الخادم service principal هذا بدلًا من هويته المُدارة.

منح الأذونات​

امنح فقط ما تحتاج إليه الخيارات التي تستخدمها. معرّفات الأدوار هي معرّفات أدوار Azure المضمّنة.

من أجلالدور أو الإذنمعرّف الدورالنطاق
الجرد والتنبيهاتReaderacdd72a7-3385-48ef-bd42-f606fba81ae7كل اشتراك، أو مجموعة إدارة (management group)
مقاييس المنصةMonitoring Reader43d0d8ad-25c7-4714-9337-8ba259a9fe05كما سبق
تشغيلات Data Factory وتشغيلات المشغّلات وحالة وقت تشغيل التكاملدور مخصص Data Factory run reader، أدناهيُنشأ في مستأجركالمصانع، أو مجموعات مواردها
انتهاء صلاحية Key VaultKey Vault Reader للخزائن التي تستخدم Azure RBAC، أو سياسة وصول بإذن List على الأسرار والمفاتيح والشهادات21090545-7ca7-4776-b22c-e363652d74d2كل خزنة
انتهاء صلاحية تسجيل التطبيقاتإذن تطبيق Microsoft Graph Application.Read.All، مع موافقة المسؤول—المستأجر

مثلًا، للهوية المُدارة للخادم على اشتراك واحد:

az role assignment create --assignee <principal-id> --role "Reader" \
--scope /subscriptions/<subscription-id>
az role assignment create --assignee <principal-id> --role "Monitoring Reader" \
--scope /subscriptions/<subscription-id>

دور للقراءة فقط لـ Data Factory​

تعرض Data Factory سجل تشغيلاتها على هيئة actions. ولا يتضمنها Reader، وسيمنحها الدور المضمّن Data Factory Contributor مع إذن الكتابة. ويُبقي الدور المخصص الأمر للقراءة فقط. احفظ ما يلي باسم data-factory-run-reader.json:

{
"Name": "Data Factory run reader",
"Description": "Read Data Factory pipelines, triggers, runs and integration runtime status.",
"Actions": [
"Microsoft.DataFactory/factories/read",
"Microsoft.DataFactory/factories/pipelines/read",
"Microsoft.DataFactory/factories/triggers/read",
"Microsoft.DataFactory/factories/integrationruntimes/read",
"Microsoft.DataFactory/factories/querypipelineruns/action",
"Microsoft.DataFactory/factories/querytriggerruns/action",
"Microsoft.DataFactory/factories/integrationruntimes/getstatus/action"
],
"NotActions": [],
"AssignableScopes": ["/subscriptions/<subscription-id>"]
}

ثم أنشئه وعيّنه:

az role definition create --role-definition data-factory-run-reader.json
az role assignment create --assignee <principal-id> --role "Data Factory run reader" \
--scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>

وبدون هذا الدور يعمل كل شيء آخر، ويُدرج Test عنصر Data Factory على أنه إذن اختياري فشل.

إضافة المصدر​

  1. افتح Settings › Sources وحدد Add a source واختر Azure Monitor.
  2. ضمن General، أدخل Name واختر Entity.
  3. ضمن Identity، اختر The server's managed identity أو A service principal. وبالنسبة إلى service principal، أدخل Tenant ID وClient ID وClient secret.
  4. ضمن Subscriptions، أدخل معرّفات الاشتراكات، معرّفًا في كل سطر، أو اتركه فارغًا لقراءة كل اشتراك تستطيع الهوية قراءته. وإدراجها هو طريقة تقسيم مستأجر واحد بين عدة كيانات عملاء.
  5. ضمن Resource types، أبقِ الأنواع التي تريدها: الأجهزة الظاهرية، وقواعد بيانات Azure SQL، والمثيلات المُدارة لـ SQL، وخوادم PostgreSQL المرنة، وحسابات التخزين، وخزائن المفاتيح، وخزائن Recovery Services، ومصانع البيانات (data factories)، وبوابات الشبكة وجدران الحماية وموازنات الحمل.
  6. اختر ما يُقرأ: Platform metrics وFired alerts وData Factory runs مشغّلة افتراضيًا؛ أما Key Vault secret expiry وApp registration secret expiry فهما موقوفان إلى أن تمنح أذوناتهما.
  7. اضبط Time zone الذي يبدأ منه «اليوم» في ملخص Data Factory، مثل America/Santo_Domingo.
  8. ضمن Ingest mode، اختر Hybrid (recommended) عندما تستطيع قواعد التنبيه لديك الوصول إلى خادم Excubius، أو Polling في غير ذلك.
  9. حدد Create source وانسخ عنوان webhook URL. يُعرض مرة واحدة فقط.

استقبال التنبيهات عبر مجموعة إجراءات​

في وضع Hybrid أو Webhook only:

  1. في Azure Monitor، أنشئ action group بإجراء Webhook إلى العنوان الذي عرضه Excubius، وشغّل common alert schema.
  2. استخدم مجموعة الإجراءات هذه في قواعد التنبيه التي تريد تنبيهاتها في Excubius.
تحذير

لا تستطيع مجموعات الإجراءات إضافة ترويسات، لذلك فإن الرمز المميز في العنوان هو بيانات الاعتماد. أبقِ العنوان خاصًا، وحدد Rotate URL على المصدر إذا تسرّب.

الاختبار والمزامنة​

  1. في صفحة المصدر، حدد Test. تُدرج كل قراءة مع نتيجتها، ويُوسم الاختياري منها: بيانات الاعتماد والاشتراكات والجرد والتنبيهات والمقاييس وData Factory وKey Vault وتسجيلات التطبيقات.
  2. حدد Sync now لجلب الموارد والمقاييس والتنبيهات دون انتظار.

تظهر موارد Azure تحت كيان المصدر، وتتم مطابقتها مع الخوادم نفسها من المصادر الأخرى بمعرّف المورد والأسماء. ويحصل كل مصنع بيانات على بطاقة في Overview، وتظهر الأسرار التي تنتهي صلاحيتها خلال 30 يومًا ضمن Expiry and risk.