Logfire

اربط Pydantic Logfire ليستطيع الوكلاء الاستعلام عن التتبعات والسجلات والمقاييس التي يستلمها مشروعك ولتصل تنبيهاته إلى Polylane لحظة انطلاقها.

الإعداد

يصدر Logfire حق الاستعلام على مفتاح مشروع وحق قنوات الإشعارات على مفتاح مؤسسة، فيتطلب ربط مشروع واحد كليهما. اربط كل مشروع على حدة؛ ويمكن إعادة استخدام مفتاح المؤسسة لكل مشروع في المؤسسة.

مفتاح API للمشروع (يُدخل أولاً)

1. في Logfire، افتح مشروعك، ثم Project settings، ثم Security & access، ثم New API key
2. حدد Read-only access وManage project and org، وأبقِ Key type على Project، ثم Create API key
3. الصق المفتاح في Polylane. تُكتشف المنطقة (US أو EU) من بادئة المفتاح، ويعرض Polylane المشروع الذي ينتمي المفتاح إليه.

مفتاح API للمؤسسة (يُدخل ثانياً)

1. من Project settings، اختر Go to org settings، ثم Security & access، ثم New API key
2. حدد Read-only access وManage project and org، وعيّن Key type إلى Organization، ثم Create API key
3. الصق المفتاح في Polylane. يتحقق Polylane من أن مؤسسة المفتاح تملك المشروع الذي سمّاه المفتاح الأول.

يعرض كل مفتاح هل قبله Logfire فور لصقه، ويصبح Connect متاحاً بعد نجاح كليهما. يُشفَّر المفتاحان قبل تخزينهما، ولا يراهما الوكيل أبداً.

ما يستطيع الوكلاء فعله

• سرد الخدمات التي أبلغت المشروع في نافذة زمنية
• ترتيب المسارات حسب عدد الطلبات ومعدل الأخطاء وزمن الاستجابة p50/p95
• البحث في spans والسجلات حسب الخدمة أو اسم span أو المسار أو المستوى أو علامة الاستثناء أو حالة HTTP
• فتح تتبع واحد كشجرة spans أصل/فرع مع المدد ورسائل الاستثناءات
• تشغيل عبارة SQL واحدة للقراءة فقط على جدولَي السجلات والمقاييس حين لا تغطي الأدوات المنسَّقة السؤال

التنبيهات

عند الربط، يضيف Polylane نفسه كقناة إشعارات على مشروع Logfire ويرفق تلك القناة بكل تنبيه في المشروع، تاركاً القنوات التي ضبطتها أصلاً كما هي. تُلتقط التنبيهات التي تضيفها لاحقاً خلال الساعة. يصل كل تنبيه يطلقه Logfire كحادثة يستطيع Polylane التحقيق فيها. يزيل الفصل القناة ويفصلها عن كل تنبيه.

كل استعلام محصور في نافذة زمنية لا تتجاوز سبعة أيام، ولا يقبل مسار SQL الخام إلا عبارة SELECT واحدة.

لماذا مفتاحان

يغطي مفتاح المشروع التتبعات والمقاييس التي يستعلم عنها الوكلاء: لا يصدر Logfire ذلك النطاق إلا على مفتاح مرتبط بمشروع واحد. ويتيح مفتاح المؤسسة لـ Polylane قراءة تنبيهات المشروع وقنوات الإشعارات القائمة، وإنشاء قناته الخاصة (يحتفظ Logfire بالقنوات على مستوى المؤسسة، وهو سبب عجز مفتاح المشروع عن ذلك)، وإرفاقها بكل تنبيه ليصل التنبيه إلى Polylane لحظة انطلاقه وتُفتح حادثة مبكراً.

التحقق المستمر

يتحقق Polylane من المفتاحين المخزّنَين كل ست ساعات ويعلّم التكامل حين يرفض Logfire أي منهما أو حين لا يسرد مفتاح المؤسسة المشروع بعد الآن، فيظهر المفتاح الملغى قبل أن يحتاج إليه تحقيق.

الفصل

افصل Logfire في Polylane، ثم ألغِ مفتاح API للمشروع تحت Project settings، ثم Security & access، ومفتاح API للمؤسسة تحت Org settings، ثم Security & access، في Logfire. أبقِ مفتاح المؤسسة إذا بقيت مشاريع أخرى في المؤسسة مربوطة.