التكاملات
Datadog
في هذه الصفحة
ما الذي يُرسَل
| حدث NanoFlags | حدث Datadog | نوع التنبيه |
|---|---|---|
| نشر مراجعة (من لوحة التحكم أو الواجهة البرمجية أو سطر الأوامر أو الجدولة) | NanoFlags: published r42 to Production (Shop) | success |
| إيقاف علم بمفتاح الإيقاف | NanoFlags: kill switch turned new-checkout off in Production (Shop) | warning |
| الموافقة على تغيير أو رفضه | NanoFlags: change approved: New checkout (Production, Shop) | success / warning |
| فشل نشر مجدول | NanoFlags: scheduled publish of Production failed (Shop) | error |
يحمل كل حدث رابطًا إلى التغيير (أو سجل النشاط) في NanoFlags. ويُرسَل الإيقاف بمفتاح الإيقاف مرة واحدة، كحدث مفتاح الإيقاف.
الإعداد
- في Datadog، افتح Organization Settings ← API Keys وأنشئ مفتاحًا (32 حرفًا). استخدم مفتاح API لا مفتاح تطبيق: مفتاح API يستطيع إرسال البيانات فقط.
- في NanoFlags، افتح الإعدادات ← التكاملات ← Datadog بصفة مالك أو مسؤول.
- أضف وجهة: اسمًا، وموقع Datadog لديك (العنوان الذي تستخدمه:
app.datadoghq.comهو US1 وapp.datadoghq.euهو EU، وكذلك US3 وUS5 وAP1 وAP2 وUS1-FED)، ومفتاح API، والأحداث، واختياريًا البيئات والمشروع الذي تغطيه. - يتحقق NanoFlags من المفتاح مع الموقع ويرسل حدثًا اختباريًا. ويعيد زر اختبار الاتصال الفحص في أي وقت.
تغطي الوجهة هذا المشروع أو كل مشاريع المؤسسة. ويمكن للمؤسسة إضافة 10 وجهات كحد أقصى، مثل وجهة لكل مؤسسة في Datadog أو لكل بيئة.
الوسوم
| الوسم | مثال | المعنى |
|---|---|---|
integration:nanoflags | كل أحداث NanoFlags | |
nanoflags_event | nanoflags_event:publish.completed | نوع الحدث |
service | service:checkout | وسم الخدمة للوجهة (الافتراضي nanoflags)، لتظهر الأحداث بجانب تلك الخدمة |
env | env:production | مفتاح البيئة |
project | project:shop | مفتاح المشروع |
revision | revision:42 | المراجعة المنشورة |
flag | flag:new-checkout | وسم لكل علم في التغيير (حتى 10) |
change_id | change_id:… | التغيير في NanoFlags |
أضف وسومك الخاصة لكل وجهة، مثل team:payments.
علامات الإصدار على لوحات المتابعة
في عنصر سلسلة زمنية، افتح Event overlays وابحث عن:
tags:integration:nanoflags env:production
tags:integration:nanoflags service:checkout nanoflags_event:publish.completedويمكن لأحداث مفتاح الإيقاف وإخفاقات النشر المجدول تشغيل المراقبات أيضًا: مراقب أحداث على tags:integration:nanoflags nanoflags_event:flag.killed ينبّه قناة المناوبة لديك.
مقياس زمن الانتشار
اختياريًا، يرسل كل نشر أيضًا المقياس nanoflags.publish.propagation_ms: الزمن من حفظ المراجعة في قاعدة البيانات حتى توزيعها على حزم SDK المتصلة، بالوسوم env وproject وservice نفسها. يُرسَل بعد دقيقتين من النشر متى قيس؛ والنشر الذي لم يُوزَّع خلال دقائق لا يرسل قيمة.
التسليم وإعادة المحاولة
- توضع الأحداث في قائمة الانتظار لحظة وقوعها وتُرسَل خلال دقيقة. وتُعاد المحاولات الفاشلة 5 مرات (بعد 1 و2 و4 و8 و16 دقيقة) عند تجاوز حد المعدل وأخطاء خوادم Datadog وانتهاء المهلة.
- لا يُعاد إرسال المفتاح المرفوض (HTTP 403) أو الطلب غير الصالح: يعرض سجل التسليم في صفحة إعدادات Datadog الإجابة، وتجعل ثلاث إخفاقات متتالية الوجهة متعطّلة.
- التسليم مرة واحدة على الأقل: قد ترسل إعادة المحاولة بعد إجابة مفقودة الحدث مرتين.
كيف يُخزَّن مفتاح API
يُرسَل المفتاح مرة واحدة من متصفحك إلى NanoFlags، وتشفّره (AES-256-GCM) خدمة الإشعارات في NanoFlags بمفتاح لا تملكه قاعدة البيانات. لا يظهر مجددًا، ولا تعيده أي واجهة برمجية، ولا يُرسَل إلى أي متصفح؛ وتعرض صفحة الإعدادات آخر أربعة أحرف منه فقط. وإزالة الوجهة تحذف مفتاحها. راجع الأمان.