Logfire

Koble til Pydantic Logfire slik at agenter kan spørre i sporene, loggene og metrikkene prosjektet ditt mottar, og varslene dens når Polylane i det øyeblikket de utløses.

Oppsett

Logfire utsteder spørretilgang på en prosjektnøkkel og tilgang til notifikasjonskanaler på en organisasjonsnøkkel, så å koble til ett prosjekt krever begge. Koble til hvert prosjekt separat; organisasjonsnøkkelen kan gjenbrukes for hvert prosjekt i organisasjonen.

Prosjekt-API-nøkkel (skrives inn først)

1. I Logfire åpner du prosjektet ditt, så Project settings, så Security & access, så New API key
2. Kryss av for Read-only access og Manage project and org, la Key type stå som Project, og klikk så på Create API key
3. Lim nøkkelen inn i Polylane. Regionen (US eller EU) oppdages fra nøkkelprefikset, og Polylane viser prosjektet nøkkelen tilhører.

Organisasjons-API-nøkkel (skrives inn som nummer to)

1. Fra Project settings velger du Go to org settings, så Security & access, så New API key
2. Kryss av for Read-only access og Manage project and org, sett Key type til Organization, og klikk så på Create API key
3. Lim nøkkelen inn i Polylane. Polylane sjekker at nøkkelens organisasjon eier prosjektet den første nøkkelen navnga.

Hver nøkkel viser om Logfire godtok den mens du limer den inn, og Connect blir tilgjengelig når begge er godkjent. Begge nøklene krypteres før de lagres, og agenten ser dem aldri.

Hva agenter kan gjøre

• Liste tjenestene som rapporterte til prosjektet i et tidsvindu
• Rangere ruter etter antall forespørsler, feilrate og p50/p95-latens
• Søke i spans og logger etter tjeneste, span-navn, rute, nivå, unntaksflagg eller HTTP-status
• Åpne ett spor som et foreldre/barn-span-tre med varigheter og unntaksmeldinger
• Kjøre ett enkelt skrivebeskyttet SQL-uttrykk over records- og metrics-tabellene når de kuraterte verktøyene ikke dekker spørsmålet

Varsler

Ved tilkobling legger Polylane seg til som en notifikasjonskanal på Logfire-prosjektet og knytter den kanalen til hvert varsel prosjektet har, og lar kanalene du allerede har konfigurert, stå urørt. Varsler du legger til senere, plukkes opp innen en time. Hvert varsel Logfire utløser, kommer som en hendelse Polylane kan undersøke. Frakobling fjerner kanalen og løsner den fra hvert varsel.

Hver spørring avgrenses til et tidsvindu på høyst sju dager, og den rå SQL-veien aksepterer bare ett SELECT-uttrykk.

Hvorfor to nøkler

Prosjektnøkkelen dekker sporene og metrikkene agenter spør i: Logfire utsteder bare det omfanget på en nøkkel knyttet til ett prosjekt. Organisasjonsnøkkelen lar Polylane lese prosjektets varsler og eksisterende notifikasjonskanaler, opprette sin egen kanal (Logfire holder kanaler på organisasjonsnivå, som er grunnen til at en prosjektnøkkel ikke kan gjøre dette) og knytte den til hvert varsel, slik at et varsel når Polylane i det øyeblikket det utløses og en hendelse kan åpnes tidlig.

Kontinuerlig validering

Polylane validerer begge de lagrede nøklene hver sjette time og flagger integrasjonen når Logfire avviser en av nøklene eller organisasjonsnøkkelen ikke lenger lister prosjektet, så en tilbaketrukket nøkkel dukker opp før en undersøkelse trenger den.

Frakobling

Koble Logfire fra i Polylane, og trekk så tilbake prosjekt-API-nøkkelen under Project settings, så Security & access, og organisasjons-API-nøkkelen under Org settings, så Security & access, i Logfire. Behold organisasjonsnøkkelen hvis andre prosjekter i organisasjonen forblir tilkoblet.