انتقل إلى المحتوى
NanoFlags
ابدأ مجانًا

التكاملات

Datadog

أرسل أحداث الإصدارات من NanoFlags إلى Datadog كأحداث موسومة بالبيئة والمشروع والخدمة والأعلام والمراجعة. اعرضها فوق أي رسم بياني لترى أي تغيير في الأعلام يوافق ارتفاعًا مفاجئًا. متاح في خطة Team وما فوقها.

ما الذي يُرسَل

حدث 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. ويُرسَل الإيقاف بمفتاح الإيقاف مرة واحدة، كحدث مفتاح الإيقاف.

الإعداد

  1. في Datadog، افتح Organization Settings ← API Keys وأنشئ مفتاحًا (32 حرفًا). استخدم مفتاح API لا مفتاح تطبيق: مفتاح API يستطيع إرسال البيانات فقط.
  2. في NanoFlags، افتح الإعدادات ← التكاملات ← Datadog بصفة مالك أو مسؤول.
  3. أضف وجهة: اسمًا، وموقع Datadog لديك (العنوان الذي تستخدمه: app.datadoghq.com هو US1 وapp.datadoghq.eu هو EU، وكذلك US3 وUS5 وAP1 وAP2 وUS1-FED)، ومفتاح API، والأحداث، واختياريًا البيئات والمشروع الذي تغطيه.
  4. يتحقق NanoFlags من المفتاح مع الموقع ويرسل حدثًا اختباريًا. ويعيد زر اختبار الاتصال الفحص في أي وقت.

تغطي الوجهة هذا المشروع أو كل مشاريع المؤسسة. ويمكن للمؤسسة إضافة 10 وجهات كحد أقصى، مثل وجهة لكل مؤسسة في Datadog أو لكل بيئة.

الوسوم

الوسممثالالمعنى
integration:nanoflagsكل أحداث NanoFlags
nanoflags_eventnanoflags_event:publish.completedنوع الحدث
serviceservice:checkoutوسم الخدمة للوجهة (الافتراضي nanoflags)، لتظهر الأحداث بجانب تلك الخدمة
envenv:productionمفتاح البيئة
projectproject:shopمفتاح المشروع
revisionrevision:42المراجعة المنشورة
flagflag:new-checkoutوسم لكل علم في التغيير (حتى 10)
change_idchange_id:…التغيير في NanoFlags

أضف وسومك الخاصة لكل وجهة، مثل team:payments.

علامات الإصدار على لوحات المتابعة

في عنصر سلسلة زمنية، افتح Event overlays وابحث عن:

text
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 بمفتاح لا تملكه قاعدة البيانات. لا يظهر مجددًا، ولا تعيده أي واجهة برمجية، ولا يُرسَل إلى أي متصفح؛ وتعرض صفحة الإعدادات آخر أربعة أحرف منه فقط. وإزالة الوجهة تحذف مفتاحها. راجع الأمان.

الخطة
أحداث Datadog متاحة في خطة Team وما فوقها. وفي الخطط الأدنى تبقى الوجهات الحالية ظاهرة لكنها لا تستقبل شيئًا.