تغيير الحدود وإيقاف الفحوص
يبدأ كل فحص من خط الأساس الموجود في إدخاله بالكتالوج. وتغيّره حيث يكون ذلك منطقيًا: على كيان، فيتبعه كل مورد تحته، أو على مورد واحد يمثل الاستثناء. يوضح هذا الدليل الحالتين، وكيفية العودة إلى القيم الموروثة، وكيفية إيقاف فحص أو أحد مستوياته.
قبل البدء
- لتغيير فحص على مورد واحد، تحتاج إلى دور Editor أو أعلى على كيان المورد.
- لضبط قيمة افتراضية لكيان، تحتاج إلى دور Entity admin على ذلك الكيان.
- اعرف من أين تأتي القيم: خط الأساس، ثم كل كيان من الجذر نزولًا، ثم المورد. وتسود القيمة الأكثر تحديدًا. راجع الحدود وخطوط الأساس.
اضبط القيم في أعلى موضع ممكن من الشجرة وتجاوز الاستثناءات فقط. فالقيمة الافتراضية التي تُضبط مرة واحدة على شركة خان الخليلي › Production تغطي كل خادم يُضاف هناك لاحقًا.
كيف يُكتب المستوى
لكل فحص مستوى Warning ومستوى Critical. ولكل مستوى:
| الجزء | القيم |
|---|---|
| Operator | >, >=, <, <=, ==, !=, in, not_in, matches |
| Value | رقم بوحدة الفحص، تظهر بجوار الحقل، أو قائمة لـ in وnot_in |
| For | اختياري. المدة التي يجب أن يستمر فيها الشرط قبل فتح التنبيه، مثل 30s أو 15m أو 1h أو 1d. وهو يمتص الارتفاعات القصيرة؛ أما التعافي فيكون فوريًا |
تقارن بعض الفحوص الحالات بدلًا من مقارنة قيمة بحدود، مثل سلامة نسخة متماثلة في مجموعة توفر. وتأتي قواعدها من الكتالوج، وتنص نافذة التحرير على ذلك بدلًا من عرض المستويات.
تغيير حد على مورد واحد
- افتح المورد وحدد علامة التبويب Checks. استخدم Search checks أو Only problems للعثور على الفحص.
- حدد أيقونة القلم، Edit، في صف الفحص. تعرض النافذة معرّف الفحص وخط الأساس والمستويات الحالية.
- لكل مستوى تريد تغييره، أبقِ This level raises alerts محددًا وأدخل Operator وValue وFor عند الحاجة. مثلًا، لـ Page life expectancy (
sqlserver.ple_seconds) علىsql-ventas-01، اضبط Warning level على<900لمدة10m. - حدد Save.
يعرض الصف الآن المستويات الجديدة موسومة بـ (this resource). أما المستويات التي لم تغيّرها فتحتفظ بقيمها الموروثة.
للعودة إلى القيم الموروثة، افتح النافذة مرة أخرى وحدد Back to inherited thresholds. ويظهر الزر فقط عندما يكون للمورد قيم خاصة به.
ضبط قيمة افتراضية لكيان
- افتح Settings › Entities.
- افتح قائمة إجراءات الكيان، مثل Production، وحدد Threshold defaults. تسرد اللوحة الفحوص التي يضبطها هذا الكيان بنفسه؛ ويرث كل فحص آخر.
- ضمن Set a default for a check، اختر الفحص، مثل CPU utilization (SQL process) (
sqlserver.cpu_percent)، وحدد Add. - لكل مستوى، اختر:
- Inherit: أبقِ ما يأتي من الأعلى.
- Set here: أدخل Operator وValue وFor، مثل
>75لمدة15m. - Turn off here: لا يرفع هذا المستوى أي تنبيهات على هذا الكيان وما تحته.
- حدد Save.
يستخدم كل مورد تحت الكيان الآن القيمة الافتراضية، ما لم يغيّرها كيان أدنى أو المورد نفسه. وفي علامة التبويب Checks لكل مورد، يعرض المستوى الكيان الذي جاء منه.
لإزالة قيمة افتراضية، حدد أيقونة سلة المهملات بجوارها، وتسميتها Remove the default of متبوعة باسم ذلك الفحص. وعندئذٍ ترث الموارد التي تحته من موضع أعلى مرة أخرى.
إيقاف فحص
على مورد واحد، افتح علامة التبويب Checks وأوقف الفحص في العمود On، أو ألغِ تحديد Check runs في نافذة الفحص. يتوقف الفحص عن العمل على ذلك المورد ويُدرج بالحالة Off، حتى لا ينسى أحد وجوده. وأعد تشغيله بالطريقة نفسها.
لمنع فحص من إصدار تنبيهات على كيان بأكمله، افتح Threshold defaults الخاصة به، وأضف الفحص، واضبط كلًّا من Warning level وCritical level على Turn off here. يواصل الفحص العمل وتسجيل القيم على كل مورد تحته، لكنه لا يرفع أي تنبيهات هناك. استخدم ذلك للفحوص التي لا معنى لها في فرع ما، مثل فحوص خادم التقارير حيث لا يوجد خادم تقارير.
تغيير وتيرة تشغيل الفحص
في نافذة الفحص، أدخل Interval من 10s إلى 7d، مثل 30s أو 5m أو 1h. واتركه فارغًا لاستخدام فاصل الكتالوج، الذي يعرضه الحقل. ويضع الصف على الفاصل المتغيّر علامة changed.
التنفيذ عبر API
يخضع كل تغيير عبر API للأدوار نفسها ويُكتب في سجل التدقيق. $BASE هو https://<your server>/api/v1 ويحمل H الرمز المميز الخاص بك؛ راجع التشغيل السريع: إضافة مثيل SQL Server باستخدام API.
| المهمة | الطلب |
|---|---|
| عرض المستويات الفعلية ومصدر كل منها | GET /resources/{id}/checks |
| ضبط المستويات على مورد واحد | PATCH /resources/{id}/checks/{check_id} مع thresholds |
| العودة إلى المستويات الموروثة | الطلب PATCH نفسه مع "thresholds": null |
| إيقاف فحص أو تشغيله | الطلب PATCH نفسه مع "enabled": false أو true |
| تغيير الفاصل | الطلب PATCH نفسه مع "interval_seconds"، من 10 إلى 604800 |
| عرض القيم الافتراضية الخاصة بكيان | GET /entities/{id}/thresholds |
| ضبط قيمة افتراضية لكيان | PUT /entities/{id}/thresholds/{check_id} |
| إزالة قيمة افتراضية لكيان | DELETE /entities/{id}/thresholds/{check_id} |
المفاتيح التي يمكن أن يحملها تجاوز المستوى هي warn وcrit وexpect وwindow وsigma. والمفتاح المضبوط على null يوقف ذلك الجزء عند ذلك المستوى.
# one resource: warn when page life expectancy stays under 900 s for 10 minutes
curl -s "${H[@]}" -X PATCH "$BASE/resources/$SQL01/checks/sqlserver.ple_seconds" \
-d '{"thresholds": {"warn": {"op": "<", "value": 900, "for": "10m"}}}' | jq .thresholds
# the Production entity: CPU warning above 75% for 15 minutes, no critical level
curl -s "${H[@]}" -X PUT "$BASE/entities/$PROD/thresholds/sqlserver.cpu_percent" \
-d '{"warn": {"op": ">", "value": 75, "for": "15m"}, "crit": null}'