Logfire

Подключите Pydantic Logfire, чтобы агенты могли запрашивать трейсы, логи и метрики, которые получает ваш проект, а его алерты достигали Polylane в момент срабатывания.

Настройка

Logfire выдаёт доступ к запросам на ключе проекта, а доступ к каналам уведомлений на ключе организации, поэтому для подключения одного проекта нужны оба. Подключайте каждый проект отдельно; ключ организации можно переиспользовать для каждого проекта в организации.

Project API key (вводится первым)

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 показывает проект, которому принадлежит ключ.

Organization API key (вводится вторым)

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
• Искать спаны и логи по сервису, имени спана, маршруту, уровню, флагу исключения или HTTP-статусу
• Открывать один трейс как дерево родительских и дочерних спанов с длительностями и сообщениями исключений
• Выполнять один SQL-запрос только для чтения по таблицам records и metrics, когда готовые инструменты не покрывают вопрос

Алерты

При подключении 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. Сохраните ключ организации, если другие проекты организации остаются подключёнными.