Logfire

Conecte o Pydantic Logfire para que os agentes possam consultar os traces, logs e métricas que seu projeto recebe, e para que seus alertas cheguem ao Polylane no momento em que disparam.

Configuração

O Logfire concede acesso de consulta em uma chave de projeto e acesso a canais de notificação em uma chave de organização, então conectar um projeto exige as duas. Conecte cada projeto separadamente; a chave da organização pode ser reutilizada para todos os projetos da organização.

Chave de API do projeto (informada primeiro)

1. No Logfire, abra seu projeto, depois Project settings, depois Security & access, depois New API key
2. Marque Read-only access e Manage project and org, mantenha Key type como Project, depois Create API key
3. Cole a chave no Polylane. A região (US ou EU) é detectada pelo prefixo da chave, e o Polylane mostra o projeto ao qual a chave pertence.

Chave de API da organização (informada em segundo)

1. Em Project settings, escolha Go to org settings, depois Security & access, depois New API key
2. Marque Read-only access e Manage project and org, defina Key type como Organization, depois Create API key
3. Cole a chave no Polylane. O Polylane verifica se a organização da chave é dona do projeto indicado pela primeira chave.

Cada chave mostra se o Logfire a aceitou conforme você cola, e Connect fica disponível quando as duas passam. As duas chaves são criptografadas antes de serem armazenadas, e o agente nunca as vê.

O que os agentes podem fazer

• Listar os serviços que reportaram ao projeto em uma janela de tempo
• Classificar rotas por contagem de requisições, taxa de erro e latência p50/p95
• Pesquisar spans e logs por serviço, nome do span, rota, nível, flag de exceção ou status HTTP
• Abrir um trace como uma árvore de spans pai/filho com durações e mensagens de exceção
• Executar uma única instrução SQL somente leitura sobre as tabelas de records e metrics quando as ferramentas curadas não cobrem a pergunta

Alertas

Ao conectar, o Polylane se adiciona como canal de notificação no projeto do Logfire e anexa esse canal a todos os alertas que o projeto tem, deixando intocados os canais que você já configurou. Alertas que você adicionar depois são captados dentro de uma hora. Cada alerta que o Logfire dispara chega como um incidente que o Polylane pode investigar. Desconectar remove o canal e o desanexa de todos os alertas.

Toda consulta tem escopo em uma janela de tempo de no máximo sete dias, e o caminho de SQL bruto aceita apenas uma instrução SELECT.

Por que duas chaves

A chave do projeto cobre os traces e métricas que os agentes consultam: o Logfire só concede esse escopo em uma chave vinculada a um projeto. A chave da organização permite que o Polylane leia os alertas do projeto e os canais de notificação existentes, crie seu próprio canal (o Logfire mantém os canais no nível da organização, e é por isso que uma chave de projeto não consegue fazer isso) e o anexe a cada alerta, para que um alerta chegue ao Polylane no momento em que dispara e um incidente possa abrir cedo.

Validação contínua

O Polylane valida as duas chaves armazenadas a cada seis horas e sinaliza a integração quando o Logfire rejeita qualquer uma delas ou quando a chave da organização deixa de listar o projeto, para que uma chave revogada apareça antes que uma investigação precise dela.

Desconectar

Desconecte o Logfire no Polylane, depois revogue a chave de API do projeto em Project settings, depois Security & access, e a chave de API da organização em Org settings, depois Security & access, no Logfire. Mantenha a chave da organização se outros projetos da organização continuarem conectados.