تخطيط نافذة صيانة
تغطي نافذة الصيانة فترة يُتوقع فيها أن تسوء حال الموارد: ليلة تصحيحات، أو اختبار تجاوز الفشل، أو ترحيل. أثناء النافذة يواصل Excubius المراقبة والتسجيل، لكنه لا يرسل إشعارًا إلى أحد. يوضح هذا الدليل الطرق الثلاث لإنشاء نافذة، من وحدة التحكم ومن API.
قبل البدء
- تحتاج إلى دور Operator (عامل التشغيل) أو أعلى على الكيان. يستطيع العارضون رؤية النوافذ لكن لا يستطيعون إنشاءها.
- حدّد النطاق: كيان كامل (كل ما فيه وما تحته) أو بعض الموارد (وكل ما اكتُشف تحتها، مثل مجموعات التوفر وقواعد البيانات في مثيل).
اختر طريقة البدء
| الحاجة | ما تستخدمه |
|---|---|
| يبدأ العمل الآن | Start maintenance now: من دقيقة واحدة إلى 7 أيام |
| ليلة مخطط لها | Schedule a window › Once: البدء والانتهاء بتوقيت متصفحك، وبمدة تصل إلى سنة |
| فترة دورية | Schedule a window › Every week: أيام الأسبوع، ووقت البدء المحلي، والمدة، والمنطقة الزمنية |
جدولة نافذة أسبوعية
- افتح Settings › Maintenance windows واختر الكيان في أداة الاختيار، مثل شركة خان الخليلي › Production.
- حدد Schedule a window.
- اكتب Reason. هو داخلي: يظهر في وحدة التحكم وفي الخطوط الزمنية للتنبيهات وفي سجل التدقيق، ولا يظهر في صفحة الحالة أبدًا.
- اختر Every week.
- اختر Days وLocal start time وDuration (minutes) وTime zone، مثل السبت في الساعة 23:00 لمدة 180 دقيقة في
America/Santo_Domingo. - ضمن Covers، أبقِ على All of Production، الذي يحمل اسم الكيان الذي اخترته، أو اختر Only some resources وحدد الموارد.
- اختياريًا، حدد Announce on the status page وأعطها Public title وPublic description. لا يُنشر سوى هذين النصين.
- حدد Save window. تظهر النافذة ضمن Next 14 days.
لنافذة لمرة واحدة، اختر Once في الخطوة 4 وأدخل موعد Starts وEnds، بتوقيت متصفحك.
بدء الصيانة الآن
- افتح Settings › Maintenance windows واختر الكيان.
- ضمن Start maintenance now، أدخل For (minutes) وReason، مثل 45 دقيقة وتصحيح sql-ventas-02 (التغيير CHG-2231).
- ضمن Covers، أبقِ على الكيان كاملًا، مثل All of Production، أو اختر Only some resources وحدد الموارد.
- حدد Start now.
تظهر النافذة ضمن Active now مع وقت انتهائها. وعندما ينتهي العمل مبكرًا، حدد End now عليها.
ما تغطيه النافذة
| النطاق | ما يغطيه |
|---|---|
| الكيان | كل مورد في الكيان وفي كل كيان تحته، كما تكون الشجرة في كل لحظة: وتُغطى كذلك الموارد التي تُضاف إلى الفرع أو تُنقل إليه لاحقًا |
| بعض الموارد | الموارد المحددة، من الكيان أو من تحته، وكل ما اكتُشف تحتها: مجموعات التوفر وقواعد البيانات والخوادم المرتبطة في مثيل |
التنبيه الذي يُصدر على مثيل بشأن إحدى قواعد بياناته أو خوادمه المرتبطة يُغطى عندما يكون ذلك المورد الفرعي مغطى. والنافذة على قاعدة بيانات واحدة تهدّئ تنبيهات قاعدة البيانات تلك لا بقية تنبيهات المثيل.
ما يحدث أثناء النافذة
- تعرض الموارد المغطاة الحالة قيد الصيانة بدلًا من سلامتها، في بطاقات لوحة المعلومات وفي قوائم الموارد وفي صفحة المورد.
- تواصل الفحوصات العمل وتواصل المقاييس التخزين، فيبقى السجل التاريخي كاملًا وتعود الحالة الحقيقية لحظة انتهاء النافذة.
- يُوسَم التنبيه الذي يُفتح بالنافذة ولا يُرسل شيء. ويذكر خطه الزمني أنه فُتح أثناء الصيانة.
- التنبيه الذي يزول قبل النهاية يُحل بصمت، لأنه لم يُعلَن عن شيء.
- التنبيه الذي لا يزال مفتوحًا عند انتهاء النافذة يُعلَن عنه حينئذ، كما لو أنه فُتح للتو، عبر التوجيه المعتاد وفترة الهدوء وعمليات الكتم.
- يسجل الخط الزمني للمورد متى بدأت كل نافذة وانتهت، وما إذا كان أحد قد أنهاها مبكرًا.
نافذة الصيانة ليست كتمًا. الكتم يهدّئ تنبيهًا واحدًا قائمًا لبعض الوقت؛ أما النافذة فتهدّئ كل ما يخص مجموعة من الموارد لفترة، بما في ذلك التنبيهات التي لم توجد بعد.
النوافذ الأسبوعية والتوقيت الصيفي
- عندما تتقدم الساعات، يبدأ وقت البدء غير الموجود بعد القفزة مباشرة.
- وعندما تتراجع الساعات، يستخدم وقت البدء الذي يحدث مرتين المرة الأولى.
- المدة وقت منقضٍ فعليًا، لذا تنتهي النافذة التي تمتد عبر تغيير الساعة قبل ساعة أو بعدها بحسب ساعة الحائط.
- قد تعبر النافذة منتصف الليل أو نهاية الأسبوع: فالنافذة التي تبدأ الأحد في الساعة 23:00 لمدة ثلاث ساعات تنتهي الاثنين في الساعة 02:00. ويمتد التكرار الواحد حتى أسبوع.
- End now على نافذة أسبوعية يقطع التكرار الحالي فقط؛ وتحدث التكرارات التالية كما هو مخطط لها. وتعديل الجدول يلغي ذلك.
تعديل نافذة أو حذفها
يسرد All windows نوافذ الكيان الخاصة، ونوافذ الكيانات التي تحته، والنوافذ الموروثة من أسلافه، وعليها العلامة From واسم الكيان. ولكل منها إجراءا التعديل والحذف.
يؤدي حذف نافذة نشطة إلى إنهائها أولًا، ويحتفظ خطها الزمني بالبدء والانتهاء. وتحتفظ التنبيهات التي وسمتها بإدخالها في الخط الزمني لكنها تفقد الارتباط بالنافذة المحذوفة.
الأدوار والتدقيق
| الإجراء | الدور على كيان النافذة |
|---|---|
| عرض النوافذ، النشطة والقادمة | Viewer |
| الإنشاء أو البدء أو التعديل أو الإنهاء أو الحذف | Operator |
يُكتب كل تغيير في سجل التدقيق: maintenance.create وmaintenance.start_now وmaintenance.update وmaintenance.end وmaintenance.delete.
من API
$BASE هو https://<your server>/api/v1 و$TOKEN هو رمز الوصول الخاص بك؛ راجع التشغيل السريع: إضافة مثيل SQL Server عبر API.
# a two-hour weekly slot for the whole Production branch
curl -sS -X POST "$BASE/maintenance-windows" -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{
"entity_id": "'"$PROD"'", "kind": "weekly", "reason": "Weekly index maintenance",
"weekly": {"days": ["sun"], "start_time": "02:00", "duration_minutes": 120,
"timezone": "America/Santo_Domingo"}}'
# sql-ventas-02 is being patched now, for 45 minutes
curl -sS -X POST "$BASE/maintenance-windows/now" -H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' -d '{
"entity_id": "'"$PROD"'", "resource_ids": ["'"$SQL02"'"], "minutes": 45,
"reason": "Patching sql-ventas-02 (change CHG-2231)"}'
# done early
curl -sS -X POST "$BASE/maintenance-windows/$WINDOW/end" -H "Authorization: Bearer $TOKEN"
| الطلب | الغرض |
|---|---|
GET /maintenance-windows?entity={id} | نوافذ كيان، مع نوافذ ما تحته والموروثة؛ ويمكن الترشيح بـ state=active,scheduled,ended |
GET /maintenance-windows/active و/upcoming | ما هو قيد الصيانة الآن، وما يأتي بعده |
POST /maintenance-windows | إنشاء نافذة: قيمة kind هي once (مع starts_at وends_at) أو weekly (مع weekly)؛ وقيمة scope هي entity أو resources (مع resource_ids) |
POST /maintenance-windows/now | بدء نافذة الآن لمدة minutes، على الكيان أو على resource_ids |
PATCH /maintenance-windows/{id} | تغيير أي حقل |
POST /maintenance-windows/{id}/end | إنهاء التكرار النشط الآن |
DELETE /maintenance-windows/{id} | حذف نافذة؛ وتُنهى النافذة النشطة أولًا |
للإعلان عن نافذة في صفحة الحالة، أضف "public": true مع public_title واختياريًا public_description. ويمكن تقييد النافذة الأسبوعية بـ starts_at وends_at الاختياريين: ولا تُحتسب إلا التكرارات التي تبدأ بينهما. ويمكن للنافذة لمرة واحدة تسجيل المنطقة الزمنية التي خُطط لها فيها بـ timezone.
المحتوى ذو الصلة
- تأكيد تنبيه ومعالجته
- الكيانات والعلامات والوراثة: النوافذ المضبوطة على كيان تغطي كل ما تحته
- إعداد صفحة الحالة العامة