Logfire

Connecte Pydantic Logfire pour que les agents puissent interroger les traces, logs et métriques que ton projet reçoit et que ses alertes atteignent Polylane au moment où elles se déclenchent.

Configuration

Logfire accorde l'accès aux requêtes sur une clé de projet et l'accès aux canaux de notification sur une clé d'organisation, donc connecter un projet demande les deux. Connecte chaque projet séparément ; la clé d'organisation peut être réutilisée pour chaque projet de l'organisation.

Clé API de projet (saisie en premier)

1. Dans Logfire, ouvre ton projet, puis Project settings, puis Security & access, puis New API key
2. Coche Read-only access et Manage project and org, garde Key type sur Project, puis Create API key
3. Colle la clé dans Polylane. La région (US ou EU) est détectée à partir du préfixe de la clé, et Polylane montre le projet auquel la clé appartient.

Clé API d'organisation (saisie en second)

1. Depuis Project settings, choisis Go to org settings, puis Security & access, puis New API key
2. Coche Read-only access et Manage project and org, mets Key type sur Organization, puis Create API key
3. Colle la clé dans Polylane. Polylane vérifie que l'organisation de la clé possède le projet nommé par la première clé.

Chaque clé indique si Logfire l'a acceptée à mesure que tu la colles, et Connect est disponible une fois que les deux passent. Les deux clés sont chiffrées avant d'être stockées, et l'agent ne les voit jamais.

Ce que les agents peuvent faire

• Lister les services qui ont rapporté au projet dans une fenêtre de temps
• Classer les routes par nombre de requêtes, taux d'erreur et latence p50/p95
• Chercher des spans et des logs par service, nom de span, route, niveau, indicateur d'exception ou statut HTTP
• Ouvrir une trace comme un arbre de spans parent/enfant avec les durées et les messages d'exception
• Exécuter une seule instruction SQL en lecture seule sur les tables records et metrics quand les outils dédiés ne couvrent pas la question

Alertes

À la connexion, Polylane s'ajoute comme canal de notification sur le projet Logfire et attache ce canal à chaque alerte du projet, sans toucher aux canaux que tu as déjà configurés. Les alertes que tu ajoutes plus tard sont reprises dans l'heure. Chaque alerte que Logfire déclenche arrive comme un incident que Polylane peut investiguer. La déconnexion retire le canal et le détache de chaque alerte.

Chaque requête est limitée à une fenêtre de temps d'au plus sept jours, et le chemin SQL brut n'accepte qu'une seule instruction SELECT.

Pourquoi deux clés

La clé de projet couvre les traces et les métriques que les agents interrogent : Logfire n'accorde ce scope que sur une clé liée à un seul projet. La clé d'organisation permet à Polylane de lire les alertes du projet et les canaux de notification existants, de créer son propre canal (Logfire garde les canaux au niveau de l'organisation, c'est pourquoi une clé de projet ne peut pas le faire) et de l'attacher à chaque alerte pour qu'une alerte atteigne Polylane au moment où elle se déclenche et qu'un incident puisse s'ouvrir tôt.

Validation continue

Polylane valide les deux clés stockées toutes les six heures et signale l'intégration quand Logfire rejette l'une des clés ou que la clé d'organisation ne liste plus le projet, pour qu'une clé révoquée remonte avant qu'une investigation en ait besoin.

Déconnexion

Déconnecte Logfire dans Polylane, puis révoque la clé API de projet sous Project settings, puis Security & access, et la clé API d'organisation sous Org settings, puis Security & access, dans Logfire. Garde la clé d'organisation si d'autres projets de l'organisation restent connectés.