ربط Azure Monitor
اربط 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 المضمّنة.
| من أجل | الدور أو الإذن | معرّف الدور | النطاق |
|---|---|---|---|
| الجرد والتنبيهات | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | كل اشتراك، أو مجموعة إدارة (management group) |
| مقاييس المنصة | Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | كما سبق |
| تشغيلات Data Factory وتشغيلات المشغّلات وحالة وقت تشغيل التكامل | دور مخصص Data Factory run reader، أدناه | يُنشأ في مستأجرك | المصانع، أو مجموعات مواردها |
| انتهاء صلاحية Key Vault | Key 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 على أنه إذن اختياري فشل.
إضافة المصدر
- افتح Settings › Sources وحدد Add a source واختر Azure Monitor.
- ضمن General، أدخل Name واختر Entity.
- ضمن Identity، اختر The server's managed identity أو A service principal. وبالنسبة إلى service principal، أدخل Tenant ID وClient ID وClient secret.
- ضمن Subscriptions، أدخل معرّفات الاشتراكات، معرّفًا في كل سطر، أو اتركه فارغًا لقراءة كل اشتراك تستطيع الهوية قراءته. وإدراجها هو طريقة تقسيم مستأجر واحد بين عدة كيانات عملاء.
- ضمن Resource types، أبقِ الأنواع التي تريدها: الأجهزة الظاهرية، وقواعد بيانات Azure SQL، والمثيلات المُدارة لـ SQL، وخوادم PostgreSQL المرنة، وحسابات التخزين، وخزائن المفاتيح، وخزائن Recovery Services، ومصانع البيانات (data factories)، وبوابات الشبكة وجدران الحماية وموازنات الحمل.
- اختر ما يُقرأ: Platform metrics وFired alerts وData Factory runs مشغّلة افتراضيًا؛ أما Key Vault secret expiry وApp registration secret expiry فهما موقوفان إلى أن تمنح أذوناتهما.
- اضبط Time zone الذي يبدأ منه «اليوم» في ملخص Data Factory، مثل
America/Santo_Domingo. - ضمن Ingest mode، اختر Hybrid (recommended) عندما تستطيع قواعد التنبيه لديك الوصول إلى خادم Excubius، أو Polling في غير ذلك.
- حدد Create source وانسخ عنوان webhook URL. يُعرض مرة واحدة فقط.
استقبال التنبيهات عبر مجموعة إجراءات
في وضع Hybrid أو Webhook only:
- في Azure Monitor، أنشئ action group بإجراء Webhook إلى العنوان الذي عرضه Excubius، وشغّل common alert schema.
- استخدم مجموعة الإجراءات هذه في قواعد التنبيه التي تريد تنبيهاتها في Excubius.
لا تستطيع مجموعات الإجراءات إضافة ترويسات، لذلك فإن الرمز المميز في العنوان هو بيانات الاعتماد. أبقِ العنوان خاصًا، وحدد Rotate URL على المصدر إذا تسرّب.
الاختبار والمزامنة
- في صفحة المصدر، حدد Test. تُدرج كل قراءة مع نتيجتها، ويُوسم الاختياري منها: بيانات الاعتماد والاشتراكات والجرد والتنبيهات والمقاييس وData Factory وKey Vault وتسجيلات التطبيقات.
- حدد Sync now لجلب الموارد والمقاييس والتنبيهات دون انتظار.
تظهر موارد Azure تحت كيان المصدر، وتتم مطابقتها مع الخوادم نفسها من المصادر الأخرى بمعرّف المورد والأسماء. ويحصل كل مصنع بيانات على بطاقة في Overview، وتظهر الأسرار التي تنتهي صلاحيتها خلال 30 يومًا ضمن Expiry and risk.