Logfire

Ajanların projenin aldığı izleri, günlükleri ve metrikleri sorgulayabilmesi ve uyarılarının tetiklendikleri anda Polylane'e ulaşması için Pydantic Logfire'ı bağla.

Kurulum

Logfire sorgu erişimini bir proje anahtarında, bildirim kanalı erişimini ise bir organizasyon anahtarında verir, bu yüzden bir projeyi bağlamak ikisini de alır. Her projeyi ayrı bağla; organizasyon anahtarı organizasyondaki her proje için yeniden kullanılabilir.

Proje API anahtarı (önce girilir)

1. Logfire'da projeni aç, sonra Project settings, sonra Security & access, sonra New API key
2. Read-only access ve Manage project and org seçeneklerini işaretle, Key type değerini Project olarak bırak, sonra Create API key
3. Anahtarı Polylane'e yapıştır. Bölge (US veya EU) anahtar önekinden algılanır ve Polylane anahtarın ait olduğu projeyi gösterir.

Organizasyon API anahtarı (ikinci girilir)

1. Project settings'ten Go to org settings'i seç, sonra Security & access, sonra New API key
2. Read-only access ve Manage project and org seçeneklerini işaretle, Key type değerini Organization olarak ayarla, sonra Create API key
3. Anahtarı Polylane'e yapıştır. Polylane, anahtarın organizasyonunun ilk anahtarın adlandırdığı projeye sahip olduğunu kontrol eder.

Her anahtar yapıştırdığın anda Logfire'ın onu kabul edip etmediğini gösterir ve ikisi de geçince Connect kullanılabilir olur. Her iki anahtar saklanmadan önce şifrelenir ve ajan onları asla görmez.

Ajanlar ne yapabilir

• Bir zaman penceresinde projeye rapor veren servisleri listeleyebilir
• Rotaları istek sayısına, hata oranına ve p50/p95 gecikmeye göre sıralayabilir
• Span'leri ve günlükleri servise, span adına, rotaya, düzeye, istisna bayrağına veya HTTP durumuna göre arayabilir
• Tek bir izi süreler ve istisna mesajlarıyla bir üst/alt span ağacı olarak açabilir
• Seçilmiş araçlar soruyu kapsamadığında kayıtlar ve metrikler tabloları üzerinde tek bir salt okunur SQL ifadesi çalıştırabilir

Uyarılar

Bağlanırken Polylane kendini Logfire projesine bir bildirim kanalı olarak ekler ve o kanalı projenin sahip olduğu her uyarıya bağlar; zaten yapılandırdığın kanallara dokunmaz. Sonradan eklediğin uyarılar bir saat içinde alınır. Logfire'ın tetiklediği her uyarı Polylane'in inceleyebileceği bir olay olarak gelir. Bağlantıyı kesmek kanalı kaldırır ve her uyarıdan ayırır.

Her sorgu en fazla yedi günlük bir zaman penceresiyle kapsamlanır ve ham SQL yolu yalnızca tek bir SELECT ifadesi kabul eder.

Neden iki anahtar

Proje anahtarı ajanların sorguladığı izleri ve metrikleri kapsar: Logfire bu kapsamı yalnızca tek bir projeye bağlı bir anahtarda verir. Organizasyon anahtarı Polylane'in projenin uyarılarını ve mevcut bildirim kanallarını okumasına, kendi kanalını oluşturmasına (Logfire kanalları organizasyon düzeyinde tutar, proje anahtarı bu yüzden bunu yapamaz) ve onu her uyarıya bağlamasına izin verir; böylece bir uyarı tetiklendiği anda Polylane'e ulaşır ve bir olay erken açılabilir.

Sürekli doğrulama

Polylane saklanan her iki anahtarı altı saatte bir doğrular ve Logfire anahtarlardan birini reddettiğinde ya da organizasyon anahtarı projeyi artık listelemediğinde entegrasyonu işaretler; böylece iptal edilmiş bir anahtar bir inceleme ona ihtiyaç duymadan önce ortaya çıkar.

Bağlantıyı kesme

Logfire'ın Polylane ile bağlantısını kes, sonra Logfire'da proje API anahtarını Project settings, sonra Security & access altından ve organizasyon API anahtarını Org settings, sonra Security & access altından iptal et. Organizasyonun diğer projeleri bağlı kalıyorsa organizasyon anahtarını koru.