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
• Шукати span-и та логи за сервісом, назвою span-у, маршрутом, рівнем, ознакою винятку або HTTP-статусом
• Відкривати один трейс як дерево батьківських і дочірніх span-ів із тривалостями та повідомленнями винятків
• Виконувати одну SQL-інструкцію лише для читання над таблицями записів і метрик, коли підготовлені інструменти не покривають запитання

Алерти

Під час підключення Polylane додає себе як канал сповіщень у проєкті Logfire та прикріплює цей канал до кожного алерту проєкту, не змінюючи каналів, які ви вже налаштували. Алерти, додані пізніше, підхоплюються протягом години. Кожний алерт, який спрацьовує в Logfire, надходить як інцидент, який Polylane може розслідувати. Відключення видаляє канал і від'єднує його від кожного алерту.

Кожний запит обмежений часовим вікном щонайбільше в сім днів, а шлях сирого SQL приймає лише одну інструкцію SELECT.

Чому два ключі

Ключ проєкту покриває трейси та метрики, які запитують агенти: Logfire надає цю область дії лише ключу, прив'язаному до одного проєкту. Ключ організації дає Polylane змогу читати алерти проєкту та наявні канали сповіщень, створювати власний канал (Logfire зберігає канали на рівні організації, тому ключ проєкту цього зробити не може) і прикріплювати його до кожного алерту, щоб алерт досягав Polylane у момент спрацювання, а інцидент міг відкритися раніше.

Безперервна перевірка

Polylane перевіряє обидва збережені ключі кожні шість годин і позначає інтеграцію, коли Logfire відхиляє будь-який із ключів або ключ організації більше не містить проєкт у своєму списку, тому відкликаний ключ виявляється до того, як він знадобиться розслідуванню.

Відключення

Відключіть Logfire у Polylane, а потім відкличте в Logfire ключ API проєкту в розділі Project settings, потім Security & access, і ключ API організації в розділі Org settings, потім Security & access. Залиште ключ організації, якщо інші проєкти організації залишаються підключеними.