Logfire

Collega Pydantic Logfire così gli agenti possono interrogare tracce, log e metriche che il tuo progetto riceve e i suoi alert raggiungono Polylane nel momento in cui scattano.

Configurazione

Logfire concede l'accesso alle query su una chiave di progetto e l'accesso ai canali di notifica su una chiave di organizzazione, quindi collegare un progetto richiede entrambe. Collega ogni progetto separatamente; la chiave di organizzazione può essere riutilizzata per ogni progetto dell'organizzazione.

Project API key (inserita per prima)

1. In Logfire, apri il tuo progetto, poi Project settings, poi Security & access, poi New API key
2. Spunta Read-only access e Manage project and org, lascia Key type su Project, poi Create API key
3. Incolla la chiave in Polylane. La regione (US o EU) viene rilevata dal prefisso della chiave e Polylane mostra il progetto a cui la chiave appartiene.

Organization API key (inserita per seconda)

1. Da Project settings, scegli Go to org settings, poi Security & access, poi New API key
2. Spunta Read-only access e Manage project and org, imposta Key type su Organization, poi Create API key
3. Incolla la chiave in Polylane. Polylane verifica che l'organizzazione della chiave possieda il progetto indicato dalla prima chiave.

Ogni chiave mostra se Logfire l'ha accettata mentre la incolli, e Connect diventa disponibile quando entrambe passano. Entrambe le chiavi vengono cifrate prima di essere archiviate e l'agente non le vede mai.

Cosa possono fare gli agenti

• Elencare i servizi che hanno inviato dati al progetto in una finestra temporale
• Classificare le route per numero di richieste, tasso di errore e latenza p50/p95
• Cercare span e log per servizio, nome dello span, route, livello, flag di eccezione o stato HTTP
• Aprire una traccia come albero di span padre/figlio con durate e messaggi di eccezione
• Eseguire una singola istruzione SQL in sola lettura sulle tabelle records e metrics quando gli strumenti curati non coprono la domanda

Alert

Al collegamento, Polylane si aggiunge come canale di notifica sul progetto Logfire e collega quel canale a ogni alert del progetto, lasciando intatti i canali che avevi già configurato. Gli alert che aggiungi in seguito vengono raccolti entro un'ora. Ogni alert che Logfire fa scattare arriva come incidente che Polylane può indagare. Lo scollegamento rimuove il canale e lo scollega da ogni alert.

Ogni query è limitata a una finestra temporale di al massimo sette giorni e il percorso SQL grezzo accetta una sola istruzione SELECT.

Perché due chiavi

La chiave di progetto copre le tracce e le metriche che gli agenti interrogano: Logfire concede quello scope solo su una chiave legata a un singolo progetto. La chiave di organizzazione permette a Polylane di leggere gli alert del progetto e i canali di notifica esistenti, creare il proprio canale (Logfire tiene i canali a livello di organizzazione, ed è per questo che una chiave di progetto non può farlo) e collegarlo a ogni alert, così un alert raggiunge Polylane nel momento in cui scatta e un incidente può aprirsi presto.

Convalida continua

Polylane convalida entrambe le chiavi archiviate ogni sei ore e segnala l'integrazione quando Logfire rifiuta una delle due chiavi o la chiave di organizzazione non elenca più il progetto, così una chiave revocata emerge prima che un'indagine ne abbia bisogno.

Scollegamento

Scollega Logfire in Polylane, poi revoca la chiave API di progetto sotto Project settings, poi Security & access, e la chiave API di organizzazione sotto Org settings, poi Security & access, in Logfire. Conserva la chiave di organizzazione se altri progetti dell'organizzazione restano collegati.