Logfire

Verbinde Pydantic Logfire, damit Agents die Traces, Logs und Metriken abfragen können, die dein Projekt empfängt, und seine Alerts Polylane in dem Moment erreichen, in dem sie auslösen.

Einrichtung

Logfire vergibt Abfragezugriff über einen Projektschlüssel und Zugriff auf Benachrichtigungskanäle über einen Organisationsschlüssel, ein Projekt zu verbinden braucht also beide. Verbinde jedes Projekt einzeln; der Organisationsschlüssel kann für jedes Projekt der Organisation wiederverwendet werden.

Projekt-API-Schlüssel (zuerst eingeben)

1. Öffne in Logfire dein Projekt, dann Project settings, dann Security & access, dann New API key
2. Setze die Haken bei Read-only access und Manage project and org, lass Key type auf Project und klicke auf Create API key
3. Füge den Schlüssel in Polylane ein. Die Region (US oder EU) wird aus dem Schlüsselpräfix erkannt, und Polylane zeigt das Projekt, zu dem der Schlüssel gehört.

Organisations-API-Schlüssel (als Zweites eingeben)

1. Wähle in den Project settings Go to org settings, dann Security & access, dann New API key
2. Setze die Haken bei Read-only access und Manage project and org, setze Key type auf Organization und klicke auf Create API key
3. Füge den Schlüssel in Polylane ein. Polylane prüft, ob die Organisation des Schlüssels das Projekt besitzt, das der erste Schlüssel benennt.

Jeder Schlüssel zeigt beim Einfügen, ob Logfire ihn akzeptiert hat, und Connect ist verfügbar, sobald beide bestanden haben. Beide Schlüssel werden vor dem Speichern verschlüsselt, und der Agent sieht sie nie.

Was Agents tun können

• Die Services auflisten, die in einem Zeitfenster an das Projekt gemeldet haben
• Routen nach Anfragezahl, Fehlerrate und p50/p95-Latenz ordnen
• Spans und Logs nach Service, Span-Name, Route, Level, Exception-Flag oder HTTP-Status suchen
• Einen Trace als Eltern-Kind-Span-Baum mit Dauern und Exception-Meldungen öffnen
• Eine einzelne nur lesende SQL-Anweisung über die Tabellen records und metrics ausführen, wenn die kuratierten Tools die Frage nicht abdecken

Alerts

Beim Verbinden fügt sich Polylane als Benachrichtigungskanal im Logfire-Projekt hinzu und hängt diesen Kanal an jeden Alert des Projekts, die Kanäle, die du bereits konfiguriert hast, bleiben unangetastet. Später hinzugefügte Alerts werden innerhalb einer Stunde aufgenommen. Jeder Alert, den Logfire auslöst, kommt als Incident an, den Polylane untersuchen kann. Das Trennen entfernt den Kanal und löst ihn von jedem Alert.

Jede Abfrage ist auf ein Zeitfenster von höchstens sieben Tagen beschränkt, und der Roh-SQL-Pfad akzeptiert nur eine SELECT-Anweisung.

Warum zwei Schlüssel

Der Projektschlüssel deckt die Traces und Metriken ab, die Agents abfragen: Logfire vergibt diesen Scope nur auf einem Schlüssel, der an ein Projekt gebunden ist. Der Organisationsschlüssel erlaubt Polylane, die Alerts und bestehenden Benachrichtigungskanäle des Projekts zu lesen, einen eigenen Kanal anzulegen (Logfire führt Kanäle auf Organisationsebene, weshalb ein Projektschlüssel das nicht kann) und ihn an jeden Alert zu hängen, damit ein Alert Polylane in dem Moment erreicht, in dem er auslöst, und ein Incident früh geöffnet werden kann.

Kontinuierliche Prüfung

Polylane prüft beide gespeicherten Schlüssel alle sechs Stunden und markiert die Integration, wenn Logfire einen der Schlüssel ablehnt oder der Organisationsschlüssel das Projekt nicht mehr auflistet, ein widerrufener Schlüssel fällt also auf, bevor eine Untersuchung ihn braucht.

Verbindung trennen

Trenne Logfire in Polylane, dann widerrufe in Logfire den Projekt-API-Schlüssel unter Project settings, dann Security & access, und den Organisations-API-Schlüssel unter Org settings, dann Security & access. Behalte den Organisationsschlüssel, wenn andere Projekte der Organisation verbunden bleiben.