Logfire

Conecta Pydantic Logfire para que los agentes puedan consultar las trazas, logs y métricas que recibe tu proyecto y sus alertas lleguen a Polylane en el momento en que se disparan.

Configuración

Logfire concede el acceso de consulta en una clave de proyecto y el acceso a los canales de notificación en una clave de organización, así que conectar un proyecto requiere ambas. Conecta cada proyecto por separado; la clave de organización puede reutilizarse para todos los proyectos de la organización.

Clave de API de proyecto (se introduce primero)

1. En Logfire, abre tu proyecto, luego Project settings, luego Security & access, luego New API key
2. Marca Read-only access y Manage project and org, mantén Key type en Project y luego Create API key
3. Pega la clave en Polylane. La región (US o EU) se detecta a partir del prefijo de la clave, y Polylane muestra el proyecto al que pertenece la clave.

Clave de API de organización (se introduce en segundo lugar)

1. Desde Project settings, elige Go to org settings, luego Security & access, luego New API key
2. Marca Read-only access y Manage project and org, establece Key type en Organization y luego Create API key
3. Pega la clave en Polylane. Polylane comprueba que la organización de la clave es propietaria del proyecto indicado por la primera clave.

Cada clave muestra si Logfire la aceptó a medida que la pegas, y Connect está disponible cuando ambas pasan. Ambas claves se cifran antes de almacenarse, y el agente nunca las ve.

Qué pueden hacer los agentes

• Listar los servicios que reportaron al proyecto en una ventana de tiempo
• Clasificar rutas por número de solicitudes, tasa de errores y latencia p50/p95
• Buscar spans y logs por servicio, nombre de span, ruta, nivel, marca de excepción o estado HTTP
• Abrir una traza como árbol de spans padre/hijo con duraciones y mensajes de excepción
• Ejecutar una única sentencia SQL de solo lectura sobre las tablas de registros y métricas cuando las herramientas curadas no cubren la pregunta

Alertas

Al conectar, Polylane se añade como canal de notificación en el proyecto de Logfire y adjunta ese canal a todas las alertas que tiene el proyecto, dejando intactos los canales que ya habías configurado. Las alertas que añadas más adelante se recogen en menos de una hora. Cada alerta que Logfire dispara llega como un incidente que Polylane puede investigar. Desconectar elimina el canal y lo desvincula de todas las alertas.

Cada consulta se limita a una ventana de tiempo de como máximo siete días, y la vía de SQL en bruto acepta una sola sentencia SELECT.

Por qué dos claves

La clave de proyecto cubre las trazas y métricas que consultan los agentes: Logfire solo concede ese scope en una clave vinculada a un proyecto. La clave de organización permite a Polylane leer las alertas del proyecto y los canales de notificación existentes, crear su propio canal (Logfire mantiene los canales a nivel de organización, por eso una clave de proyecto no puede hacerlo) y adjuntarlo a cada alerta para que una alerta llegue a Polylane en el momento en que se dispara y un incidente pueda abrirse pronto.

Validación continua

Polylane valida ambas claves almacenadas cada seis horas y marca la integración cuando Logfire rechaza cualquiera de las dos o la clave de organización deja de listar el proyecto, así que una clave revocada sale a la luz antes de que una investigación la necesite.

Desconexión

Desconecta Logfire en Polylane y luego revoca la clave de API de proyecto en Project settings, luego Security & access, y la clave de API de organización en Org settings, luego Security & access, en Logfire. Conserva la clave de organización si otros proyectos de la organización siguen conectados.