في منتصف الليل يتعطل موزّع الأحمال (load balancer) لديك، ولا يكون أي مستخدم متصلًا في تلك اللحظة، فتبقى مقاييس الأخطاء مستقرة ولا يصدر أي تنبيه. من هذه الحالة تنطلق أداة Gatus، وهي تفسّر لماذا تستحق صفحة حالة Gatus مكانًا إلى جانب لوحاتك: المشروع يستعلم عن خدماتك بنفسه بدل أن ينتظر حركة مرور حقيقية تكشف العطل. يصف مستودع TwiN/gatus المشروع بأنه لوحة صحة «موجّهة للمطوّرين».
لذلك أبدأ من ثلاثة قرارات تشغيلية لا من قائمة ميزات: ما الذي تعدّه خدمة سليمة، وكم إخفاقًا تتحمل قبل أن توقظ أحدًا، وأين تحتفظ بالسجل التاريخي. كل ذلك يُضبط في ملف YAML واحد.
توضيح منهجي: لم تثبّت span.observer أداة Gatus ولم تشغّلها. المعلومات مأخوذة من ملف README وبنية المستودع، وقد قُرئا في 10 نوفمبر 2026. الصور إما من المستودع نفسه (ترخيص Apache 2.0) أو عرض مرسوم لمثال الإعداد فيه. لم أتمكن من قراءة عدد النجوم من المصدر في ذلك اليوم، لذا لا أذكره.
صفحة حالة Gatus: ما يقوله المستودع
- الترخيص: ملف LICENSE يحمل نص Apache License 2.0.
- اللغة: Go؛ ويشترط الملف
go.modالإصدار 1.26.3. - الإصدار: أحدث وسم Git بعد الاستنساخ هو
v5.38.0، وآخر إيداع في الفرع الرئيسي بتاريخ 9 نوفمبر 2026. - الفواحص: طلبات HTTP وICMP وTCP وDNS بحسب README، ويضيف قسم الأسئلة الشائعة SSH وTLS وgRPC وWebSocket.
حجة README المركزية بسيطة: مقياس حركة المرور يصمت حين تختفي الحركة، أما الفاحص النشط فيواصل السؤال. والنهجان يكمّل أحدهما الآخر؛ الفاحص يقول «الخدمة تستجيب»، والقياس عن بُعد (telemetry) يقول «كيف تتصرف».

القرار الأول: ما الخدمة السليمة؟
الرمز 200 لا يثبت شيئًا يُذكر. وتقرّ Gatus بذلك: لكل نقطة نهاية (endpoint) قائمة شروط، ويكفي أن يفشل شرط واحد لتُعدّ معطوبة. هذا هو المثال الأول في README:
endpoints:
- name: website
url: "https://twin.sh/health"
interval: 5m
conditions:
- "[STATUS] == 200"
- "[BODY].status == UP"
- "[RESPONSE_TIME] < 300"
ثلاثة شروط وثلاثة أسئلة مختلفة: هل يستجيب الخادم، وهل يعلن أنه بخير، وهل يستجيب بسرعة كافية؟ ويورد جدول الشروط في README غيرها، مثل [CERTIFICATE_EXPIRATION] > 48h و[CONNECTED] == true وlen([BODY].data) < 5 و[BODY].name == pat(john*). نصيحتي: اكتب الشرط الذي سيشعر به مستخدمك، لا الشرط الذي يسهل فحصه. فمراقبة الشهادة قبل انتهائها بـ 48 ساعة تجنّبك عطلًا سخيفًا يوم الأحد.
تحتفظ بطاقة نقطة النهاية بالشروط التي قُيّمت في كل دورة. وعند تمرير المؤشر فوق شريط في السجل تعرض اللوحة الطابع الزمني وزمن الاستجابة وكل شرط جرى فحصه.

القرار الثاني: كم إخفاقًا قبل التنبيه؟
التنبيه عند أول إخفاق يوقظ الفريق كله بسبب حزمة شبكة ضائعة. لذلك يضع README قيمًا افتراضية متحفظة لكل تنبيه:
failure-threshold: ثلاثة إخفاقات متتالية قبل الإطلاق؛success-threshold: نجاحان متتاليان قبل إغلاق الحادثة؛send-on-resolved: معطّل افتراضيًا، فلا تصل رسالة إغلاق ما لم تطلبها؛minimum-reminder-interval: معطّل افتراضيًا، ولا يقل أبدًا عن 5 دقائق.
هذه الإعدادات سياسة للضجيج. كلما ارتفعت العتبة قلّ إزعاجك، لكن طالت معاناة المستخدم من العطل قبل أن تعلم به. ويوضح README هذه المفاضلة بتنبيهين على نقطة النهاية نفسها، أحدهما عند الإخفاق الثالث والآخر عند الخامس، لتصعيد على مرحلتين. يُعرَّف المزوّد مرة واحدة على المستوى العام، ثم تشير إليه كل نقطة نهاية:
alerting:
slack:
webhook-url: "https://hooks.slack.com/services/**********/**********/**********"

يدعم المستودع مزوّدين كثيرين (Slack وTeams وPagerDuty وDiscord وTelegram وntfy وOpsgenie والبريد الإلكتروني وغيرها، بحسب المجلد alerting/provider). انتبه: بعضهم يحمل في README تحذير «لم يُختبر بعد»، مثل Squadcast. تحقق من مزوّدك قبل أن تعهد إليه بنوبات المناوبة. ولمنهج في فرز الإشارات راجع https://span.observer/ar/alert-on-symptoms-not-causes-ar/، ولمنطق العتبات نفسه في Dynatrace راجع https://span.observer/ar/reduce-alert-noise-davis-ar/.

القرار الثالث: أين يُحفظ السجل؟
التخزين افتراضيًا في الذاكرة، فإعادة التشغيل تمحو السجل ونسبة التوافر المعروضة. ويقترح README الخيار sqlite (مع مسار ملف) أو postgres (مع عنوان اتصال).
storage:
type: sqlite
path: data.db
وهناك رافعتان أخريان تمسّان التشغيل. نوافذ الصيانة (maintenance.start وduration وtimezone وevery) تمنع التنبيهات أثناء نشر مخطط له. أما «نقاط النهاية الخارجية» (external endpoints) فتعكس الاتجاه: وكيل داخل شبكة خاصة يدفع حالته إلى Gatus برمز مميّز، وقيمة heartbeat.interval تولّد إخفاقًا إن لم تصل الرسالة في وقتها. وهذا جواب المشروع عن حالة تعذّر وصول Gatus إلى الخدمة.
التشغيل والتحقق
يقدّم README أمر Docker واحدًا؛ ونسخة الملف تركّب إعدادك في /config/config.yaml:
docker run -p 8080:8080 --name gatus ghcr.io/twin/gatus:stable
docker run -p 8080:8080 --mount type=bind,source="$(pwd)"/config.yaml,target=/config/config.yaml --name gatus ghcr.io/twin/gatus:stable
- اكتب ملف
config.yamlبنقطة نهاية واحدة وشروطها. - شغّل الأمر الثاني وافتح
http://localhost:8080: يجب أن تظهر البطاقة. - اكسر شرطًا عمدًا (مثل
[STATUS] == 201): يجب أن تتحول البطاقة إلى «Unhealthy». - انتظر ثلاثة إخفاقات: يجب أن ينطلق التنبيه. أعد الشرط إلى أصله: يجب أن يُحلّ بعد نجاحين إذا كان
send-on-resolvedمفعّلًا.
تعيد Gatus تحميل الملف أثناء العمل. فإن كانت النسخة الجديدة غير صالحة تتوقف، إلا إذا كانت قيمة skip-invalid-config-update هي true. ويحذّر README من هذا الإعداد، وينبّه إلى أن اكتشاف التغيير قد يفشل إن ركّبت الملف بدل المجلد. راقب السجل (log) بعد كل تعديل.
حدود ينبغي معرفتها
- الـ«suites» موسومة بـ ALPHA، والنسخ البعيدة (remote) موصوفة بأنها تجريبية، مع احتمال تغييرات غير متوافقة.
- التنفيذ مقيّد بالإعداد
concurrency(القيمة الافتراضية 3): كثرة نقاط النهاية البطيئة، مع مهلة قصوى افتراضية قدرها 10 ثوانٍ، قد تؤخر غيرها. والفاصل الزمني لا يشمل مدة الطلب نفسه. - تخبرك Gatus هل الخدمة تستجيب، ولا تشرح السبب؛ فهي لا تغني عن التتبع (traces) ولا عن السجلات.
- لم أقِس الأداء، ولذلك لا أورد هنا أي رقم عن الحمل.
ربط Gatus بمنظومة المراقبة لديك
عند ضبط metrics: true تعرض Gatus مقاييس بصيغة Prometheus على المسار /metrics وعلى منفذ التطبيق نفسه. يذكر README منها مثلًا gatus_results_total وgatus_results_duration_seconds وgatus_results_certificate_expiration_seconds وgatus_results_endpoint_success (القيمة 0 عند الفشل و1 عند النجاح). وهكذا يمكنك التنبيه على مدة صلاحية الشهادة بمحركك المعتاد، راجع https://span.observer/ar/prometheus-alerting-rules-promtool-ci-ar/. أما جمعها بأداة أخرى (OpenTelemetry Collector أو Dynatrace) فلم أتحقق منه هنا. ولمشروع آخر من السجل نفسه راجع https://span.observer/ar/argo-cd-gitops-kubernetes-ar/.
ممارسات مقترحة
- افحص مسار المستخدم (تسجيل الدخول، واجهة API الأساسية) لا الصفحة الرئيسية وحدها.
- ابدأ بقيمة 3 للإعداد
failure-threshold، ثم عدّلها بحسب سجل الإنذارات الكاذبة. - انتقل إلى
sqliteأوpostgresبمجرد أن يصبح السجل مهمًا. - لا تضع رمز webhook في مستودع عام؛ فـ README يتيح استعمال متغيرات البيئة داخل الملف.
- ضع Gatus خارج البنية التي تراقبها، وإلا سقطت معها.
الأسئلة الشائعة
هل تحل Gatus محل Prometheus أو Dynatrace؟
لا. تجيب Gatus عن سؤال «هل تستجيب الخدمة كما وعدت؟»، بينما تشرح المقاييس والتتبع والسجلات الأسباب. والنهجان متكاملان.
ما ترخيص Gatus؟
يضم المستودع نص Apache License 2.0. أعد قراءة ملف LICENSE قبل أي إعادة توزيع.
كيف أمنع التنبيه أثناء الصيانة؟
عرّف maintenance على المستوى العام، أو maintenance-windows على نقطة نهاية بعينها، مع وقت البدء والمدة والمنطقة الزمنية.
الخلاصة
تكفي Gatus ملف YAML واحد وسؤال مفيد: هل سأعلم بالعطل قبل عملائي؟ والقرارات الثلاثة (الشروط والعتبات والتخزين) تنجز معظم العمل. أبقِ الفاحص النشط مكمّلًا للقياس عن بُعد لديك، واختبره بكسره عمدًا.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. Gatus مشروع تابع لجهة خارجية ولا تصدره Dynatrace. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.