خطافات الويب: إرسال تنبيهات CostGuard إلى أدواتك

ما الغرض من هذه الصفحة

ترسل خطافات الويب تنبيهات مساحة العمل إلى أنظمة تديرها، مثل روبوت محادثة أو أداة حوادث أو خدمتك الخاصة. وتجيب الصفحة عن الوجهات التي تتلقى كل حدث، وعما إذا وصلت عمليات التسليم الأخيرة.

يوقّع CostGuard كل عملية تسليم ويعيد المحاولة عند الفشل وفق جدول ثابت حتى خمس محاولات. لا يُرسَل سوى الأحداث المدرجة أدناه؛ ولا يخرج شيء غيرها.

قبل أن تبدأ

تحتاج إلى:

• خطة Pro أو Enterprise؛ وتعرض الخطط الأخرى نموذجًا موسومًا.
• عنوان HTTPS على مضيف عام يقبل طلب POST ويتحقق من التوقيع قبل أن يثق بالطلب.

اقرأ دليل البدء

تسجيل وجهة

في «تسجيل وجهة» املأ:

• «الاسم»: اسم قصير بسيط تعرفه في القوائم.
• «عنوان الوجهة»: يجب أن يكون عنوان HTTPS على مضيف عام. لا يتحقق CostGuard من إمكانية الوصول إلى العنوان ولا من ملكيتك له.
• «الأحداث المراد إرسالها»: رُصد خطر على الميزانية ورُصد خطر في التوقعات وفشلت مزامنة التكاليف، وهي الأحداث الثلاثة التي ينتجها CostGuard اليوم.

تحت «غير مُنتَجة حاليًا» تذكر الصفحة فئات الأحداث الأخرى التي لا يمكن اختيارها: يسمّي CostGuard فئات الأحداث هذه لكنه لا يُطلق أيًّا منها حاليًا، لذا لا يمكن اختيارها. لن يُرسَل شيء من أجلها أبدًا.

يشغّل «تسجيل الوجهة» الوجهة فورًا. ويمكن لمساحة العمل تسجيل عشر وجهات على الأكثر، وتعدّ اللوحة المستخدم منها.

سرّ التوقيع

حين تُسجَّل وجهة تعرض الصفحة «مفتاح التوقيع» الخاص بها مرة واحدة. انسخه الآن. يُعرض مرة واحدة ولا يمكن عرضه مرة أخرى؛ إذا فقدته فأصدر مفتاحًا جديدًا، وهو ما يوقف عمل المفتاح القديم.

يحمل كل تسليم ترويسة X-CostGuard-Signature، وهي توقيع HMAC-SHA256 يُنشأ بمفتاح التوقيع الخاص بالوجهة، وترويسة X-CostGuard-Timestamp. يتحقق جهاز الاستقبال لديك من التوقيع قبل أن يثق بالطلب.

يسأل «إصدار مفتاح جديد» أولًا: يتوقف السرّ الحالي عن العمل فورًا، ويرفض مستقبِلك عمليات التسليم حتى يحصل على السرّ الجديد.

الوجهات المسجلة

تسرد «الوجهات المسجّلة» كل وجهة مع الأحداث التي تتلقاها و«الحالة» و«آخر تسليم» و«تاريخ التسجيل (UTC)». وإجراءاتها:

• «تعطيل» و«تفعيل»: ما دامت الوجهة معطّلة فلا يُنشأ لها أي تسليم جديد؛ أما التسليم الذي كان ينتظر مسبقاً فيُرسَل بمجرد إعادة تفعيلها.
• «إصدار مفتاح جديد»: انظر سرّ التوقيع أعلاه.
• «إزالة»: تُزال مع مفتاح التوقيع الخاص بها، ولا يُرسَل إليها أي شيء بعد ذلك.

يطلب الإيقاف وإصدار سرّ جديد والإزالة تأكيدًا أولًا، أما التشغيل فيتم فورًا.

عمليات التسليم الأخيرة

أحدث عمليات التسليم لمساحة العمل هذه، حتى مئة، الأحدث أولاً. الأوقات بتوقيت UTC. لكل تسليم حالة:

• «تم التسليم»: قبلته نقطة النهاية لديك.
• «قيد الانتظار»: ستُجرَّب، أو تُعاد محاولتها وفق الجدول الثابت.
• «مرفوض»: رفضتها نقطة النهاية لديك، أو لا يجوز استدعاء العنوان؛ ولا تُعاد محاولتها.
• «توقّفت المحاولات»: جرت خمس محاولات دون أن تقبلها نقطة النهاية لديك في الوقت المناسب.

يعدّ «المحاولات» المحاولات، ويقول «التفاصيل» بكلمات بسيطة ما حدث، مثل «لم تُجب نقطة النهاية لديك في الوقت المحدد» أو «رفضت نقطة النهاية لديك الطلب». ويظهر على التسليم إلى وجهة أُزيلت لاحقًا «وجهة أُزيلت».

كيف تعمل خطافات الويب

يُعاد محاولة التسليم الذي لم تقبله نقطة النهاية لديك في الوقت المناسب بعد دقيقة وخمس دقائق وخمس عشرة دقيقة وستين دقيقة، أي خمس محاولات في المجموع؛ وبعد الخامسة يظهر بالحالة «توقّفت المحاولات». أما التسليم الذي رفضته نقطة النهاية لديك، أو العنوان الذي لا يُسمح لـ CostGuard باستدعائه، فلا تُعاد محاولته.

تحمل الأحداث التنبيهات نفسها التي تطلقها مساحة العمل في «قواعد التنبيه»، ولا يُرسل حدث إلا حين يُطلق تنبيه كهذا.

خطافات الويب منفصلة عن تنبيهات البريد الإلكتروني والتنبيهات داخل التطبيق: تضبطها «إعدادات الإشعارات»، ويسردها «سجل تسليم التنبيهات».

ما قد تراه بدلًا من الأرقام

أثناء القراءة تحلّ أشرطة رمادية محلّ اللوحات. وبعد ذلك قد تعرض الصفحة إحدى هذه الحالات بدلاً منها:

• «تعذّرت قراءة الوجهات المسجّلة»: هذا لا يعني أن مساحة العمل ليس لديها أي وجهة. حاول مرة أخرى.
• لم تسجّل مساحة العمل هذه أي وجهة.
• «تعذّرت قراءة عمليات التسليم الأخيرة»: هذا لا يعني أنه لم يُسلَّم شيء. أعد تحميل الصفحة للمحاولة مرة أخرى.
• تعذر على CostGuard تأكيد ما إذا كان قد تم حفظ هذا التغيير. تعرض القائمة أدناه الحالة الحالية لمساحة العمل.

حين لا تتضمن خطتك خطافات الويب

في Free وStarter وGrowth تعرض الصفحة مثالًا ثابتًا تحت التسمية «بيانات نموذجية» مع الجملة «خطتك الحالية لا تتضمن هذه الميزة. الأرقام المعروضة هنا مثال وليست بياناتك.»

يعرض النموذج وجهات وعمليات تسليم مختلقة، بلا أزرار ولا أسرار ولا أي عنوان من عناوينك.

يفتح «مقارنة الخطط» صفحة الأسعار في علامة تبويب جديدة. ويقرّر CostGuard على الخادم ما تتضمنه خطتك؛ والنموذج ليس إلا الطريقة التي تعرض بها الصفحة ذلك.

ما تتضمنه كل خطة

يعرض الجدول أول خطة تتضمن كل جزء من الصفحة. وكل خطة أعلى منها تتضمنه أيضًا.

الخطط والأسعار

تتضمن Pro وEnterprise خطافات الويب، وتعرض Free وStarter وGrowth النموذج الموسوم. وتُتحقق الخطة على الخادم، ولا تعرض الصفحة سعرًا أبدًا.

استكشاف الأخطاء وإصلاحها

يرفض مستقبِلي التوقيع

يحمل المستقبِل سرًّا قديمًا أو مكتوبًا خطأً. أصدر سرًّا جديدًا، واحفظه في مستقبِلك فورًا، وتحقق من أن التوقيع يُحسب على الطلب كما وصل تمامًا.

تظهر على عمليات التسليم «توقّفت المحاولات»

لم تقبل نقطة النهاية لديك في الوقت المناسب في أي من المحاولات الخمس: كانت غير قابلة للوصول أو بطيئة جدًا أو أعادت خطأً. أصلحها؛ وستُسلَّم الأحداث الجديدة حين تستجيب.

ترفض الصفحة عنواني

تعذّر على CostGuard استخدام هذا العنوان. يجب أن يكون HTTPS، على مضيف عام، وعلى منفذ قياسي. ويُرفض أيضًا العنوان الذي يحوي اسم مستخدم أو كلمة مرور.

لا أستطيع تسجيل وجهة أخرى

سجّلت مساحة العمل عشر وجهات، وهو الحد الأقصى. أزل أولًا وجهة لم تعد تستخدمها.