إضافة مورد
المورد هو شيء واحد يراقبه Excubius: مثيل SQL Server، أو نقطة نهاية ويب، أو خادم تقارير، أو مضيف. وعند إضافة مورد، يُعدّ Excubius فورًا الفحوص الافتراضية لنوعه. يوضح هذا الدليل كيفية إضافة مورد باستخدام معالج Add resource، واختبار اتصاله، واكتشاف ما يعمل عليه، وتحريره أو حذفه.
قبل البدء
- تحتاج إلى دور Entity admin على الكيان الذي سيضم المورد.
- بيانات الاعتماد التي يحتاج إليها المورد مخزنة، أو أنت مستعد لإنشائها في المعالج. راجع تخزين بيانات اعتماد للمُجمِّع.
- يصل خادم Excubius إلى النظام عبر المنفذ الصحيح. راجع مسارات الشبكة.
تظهر الموارد التي يبلغ عنها مصدر، مثل موارد Azure من Azure Monitor أو الأجهزة من NinjaOne، من تلقاء نفسها. وأنت تضيف فقط ما يصل إليه المُجمِّع الأصلي. ولا تُضاف قواعد البيانات والخوادم المرتبطة يدويًا أيضًا: بل تكتشفها من مثيلها.
إضافة المورد
- وحدة التحكم
- API
- افتح Resources وحدد Add resource.
- Type: اختر ما هو. يعرض كل نوع عدد الفحوص التي يحصل عليها افتراضيًا والتفاصيل التي يحتاج إليها.
- Place and name: اختر Entity، الذي يحدد ما يرثه (الحدود والقنوات وبيانات الاعتماد)، وأدخل Name الذي يظهر في كل مكان، مثل
sql-ventas-01. - Connection: أدخل تفاصيل النوع، بدءًا بالمطلوبة. يُتحقق منها قبل أن تتابع.
- Tags: أضف أزواج
key:value، على الأقلenvوroleوclient، وCriticality من 1 (منخفضة) إلى 5 (حرجة). - Credential: اختر بيانات اعتماد مناسبة في المتناول، أو None لاستخدام بيانات اعتماد المورد الأصل، أو New credential لإنشاء بيانات اعتماد هنا.
- راجع ما أدخلته في Review، ثم حدد Create resource.
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"web_endpoint\", \"name\": \"portal-ventas\",
\"attributes\": {\"url\": \"https://ventas.ciguapa.example/\", \"domain\": \"ciguapa.example\"},
\"tags\": {\"env\": \"prod\", \"role\": \"web\", \"client\": \"ciguapa\"}, \"criticality\": 4
}" | jq '{id, name, checks_provisioned}'
$BASE هو https://<your server>/api/v1 ويحمل H الرمز المميز لحامل (bearer) الخاص بك؛ راجع مرجع API.
تُعدّ الفحوص الافتراضية فورًا وتصل القيم الأولى خلال دقيقة أو دقيقتين. وتقدّم الشاشة الأخيرة Test connection، وDiscover لمثيلات SQL Server، وOpen the resource، وAdd another.
التفاصيل حسب النوع
| النوع | مطلوب | تفاصيل أخرى |
|---|---|---|
| SQL Server instance | host | port (1433 افتراضيًا)؛ وinstance لمثيل مسمى ليس له منفذ ثابت، يُوصَل إليه عبر SQL Server Browser على UDP 1434 |
| Always On availability group | ag_name | يُنشأ عادةً بالاكتشاف، مع وحدة الاستماع والنسخ المتماثلة وقواعد البيانات |
| SQL Server Reporting Services | portal_url | test_report_path لعرض تقرير واحد؛ وhost وport وinstance وreport_server_db (ReportServer افتراضيًا) لفحص سجل التنفيذ |
| Web endpoint / portal | url | expect_status وexpect_text؛ وdomain (النطاق القابل للتسجيل) لانتهاء صلاحية النطاق |
| Windows host | — | ip؛ وبدونه يتصل المُجمِّع باسم المورد |
| Linux host | — | ip وssh_port (22 افتراضيًا)؛ وبدون ip يتصل المُجمِّع باسم المورد |
| PostgreSQL server | — | host وport |
| Entra ID tenant / domain services | — | tenant_id وdomain؛ ويضم فحوص الهوية |
| Monitoring platform itself | — | heartbeat_url؛ ويضم الفحوص على مستوى المنصة، مثل خلاصات التحديثات والوضع الأمني للسحابة |
| Azure resources | — | resource_id؛ ويضيفه عادةً مصدر Azure Monitor |
اختبار الاتصال
في صفحة المورد، حدد Test connection. يلتقط المُجمِّع الاختبار خلال نحو 10 ثوانٍ ويتصل ببيانات اعتماد المورد.
| النوع | ما يعرضه الاختبار الناجح |
|---|---|
| SQL Server instance، availability group | اسم الخادم والإصدار والطبعة وزمن الاستجابة، وأذونات حساب الدخول مع أي أذونات ناقصة، وتحذير عندما يكون حساب الدخول sysadmin |
| Report server، web endpoint | العنوان وحالة HTTP والإصدار وزمن الاستجابة |
يعرض الاختبار الفاشل نوع الخطأ مع تلميح:
| نوع الخطأ | ما تتحقق منه |
|---|---|
auth | حساب الدخول وكلمة المرور، وأن المثيل يقبل حسابات دخول SQL |
unreachable | اسم المضيف والمنفذ وجدار الحماية بين خادم Excubius والنظام |
timeout | مسار الشبكة؛ فلم يرد النظام في الوقت المناسب |
query | إذن ناقص لحساب الدخول |
config | شيء يجب إصلاحه في Excubius: المضيف أو بيانات الاعتماد أو سر مخزن |
عندما يبقى الاختبار عند waiting for the collector وينتهي بالرسالة No collector picked it up، فهذا يعني أن المُجمِّع لا يعمل، أو لا يملك رمزًا مميزًا، أو لا يتيح وسيلة النقل تلك. راجع أخطاء المُجمِّع.
اكتشاف ما يعمل على مثيل
على مثيل SQL Server، حدد Discover. يقرأ الاكتشاف الخادم، ومجموعات التوفر فيه مع نسخها المتماثلة وأدوارها ووحدة الاستماع، وقواعد بياناته، وخوادمه المرتبطة، وملخصًا عن SQL Agent. ويضيفها، أو يحدّثها، موارد فرعية لها فحوصها الخاصة، ويبلغ عن عدد ما أُنشئ وما حُدّث وما لم يعد موجودًا.
- شغّل الاكتشاف مرة أخرى كلما تغيرت البنية.
- يُوسم المورد الفرعي الذي لم يعد موجودًا بـ missing ويُحتفظ به مع سجله. ولا يحذفه الاكتشاف أبدًا؛ احذفه بنفسك عندما يختفي نهائيًا.
- في مجموعة توفر، أضف كل نسخة متماثلة على أنها مثيل وشغّل الاكتشاف على إحداها. راجع التشغيل السريع: إضافة مجموعة توفر.
تحرير مورد أو حذفه
- يغيّر Edit الاسم ومستوى الحرجية والعلامات وبيانات الاعتماد. أما تفاصيل الاتصال والكيان فتُغيَّر عبر API:
PATCH /api/v1/resources/{id}معattributesأوentity_id. - يزيل Delete المورد مع موارده الفرعية المكتشفة وفحوصه ومقاييسه وتنبيهاته. ولا يُمَس النظام المراقَب نفسه أبدًا.
يشغّل المحررون الفحوص أو يوقفونها ويغيّرون فاصلها وحدودها لمورد واحد في علامة التبويب Checks الخاصة به؛ راجع الموارد وصفحة المورد.