Skip to main content

Depurar un informe de error de principio a fin

Proporciónale a Devin un informe de error con registros de Datadog y acceso a la base de datos, y recibe un análisis de la causa raíz y un PR con la corrección.
AuthorCognition
CategoryGestión de incidentes
FeaturesMCP
1

Conecta Datadog

Devin necesita acceso a tus registros de Datadog para buscar errores relacionados con el error. Si aún no lo has hecho, habilita el MCP de Datadog:
  1. Ve a Settings > MCP Marketplace y busca Datadog
  2. Haz clic en Enable y proporciona dos secretos:
  3. Si tu instancia de Datadog usa un sitio personalizado (por ejemplo, datadoghq.eu), configura también DATADOG_SITE
Una vez conectado, Devin puede buscar logs, extraer trazas de errores y correlacionar incidencias con despliegues, todo dentro de la sesión. Consulta MCP Marketplace para ver todos los detalles de configuración.
2

Otorga a Devin acceso de solo lectura a la base de datos

Para errores de datos — valores incorrectos, campos faltantes, consultas con errores — Devin es mucho más efectivo cuando puede verificar directamente el estado de los datos. Proporciona una cadena de conexión de solo lectura como un Secret:
  1. Ve a Settings > Secrets y agrega un nuevo secret:
    • Name: DATABASE_READ_REPLICA_URL
    • Value: postgresql://readonly_user:password@read-replica.internal:5432/production
  2. Agrega una nota como: “Conexión de solo lectura a la réplica de lectura de producción. Segura solo para consultas SELECT.”
Alternativamente, conecta una base de datos MCP (PostgreSQL, MySQL, etc.) en Settings > MCP Marketplace: Devin puede usar cualquiera de los dos enfoques para consultar tus datos.
Utiliza siempre una réplica de solo lectura o un usuario con permisos solo de SELECT. Devin nunca necesita acceso de escritura para investigar un error. Si te preocupa que consultas costosas afecten el rendimiento, dirige a Devin a una réplica de solo lectura dedicada o a una réplica de analítica existente que esté separada de tu base de datos de producción.
3

Envía a Devin el informe de error

Pega el informe de error directamente en una sesión de Devin. Incluye todo el contexto que te haya proporcionado la persona que lo reportó: cuándo empezó, quiénes se ven afectados, qué está mal y dónde. Para realizar una investigación estructurada, usa el !triage template playbook: dúplícalo y personaliza los pasos para tu stack.Cuanto más específico sea el informe, más rápido encontrará Devin la respuesta. “Desde el deploy del viernes” le permite a Devin acotar la ventana temporal en Datadog. “Usuarios del plan Pro” le indica exactamente qué registros debe consultar.
4

Devin investiga y soluciona

Con Datadog y el acceso a la base de datos conectados, Devin realiza una investigación completa:Extrae los logs de Datadog — Busca errores en el servicio de facturación desde el viernes, filtrando por nombre de servicio y estado de error. Encuentra un pico de TypeError: Cannot read property 'name' of undefined que comienza a las 18:12 UTC en la fecha del despliegue.Consulta la base de datos — Ejecuta SELECT id, company_name, plan FROM users WHERE plan = 'pro' LIMIT 20 contra la réplica de solo lectura. Confirma que los usuarios Pro sí tienen valores de company_name: los datos están bien, así que el error está en el código.Localiza el cambio de código — Revisa git log --since="2026-02-13" y encuentra el commit a1b2c3d que refactorizó la respuesta de la API de usuario, renombrando company a organization. La página de facturación en src/pages/billing/BillingHeader.tsx sigue haciendo referencia a user.company.name.Escribe la corrección — Actualiza BillingHeader.tsx para usar user.organization?.name ?? 'Your Company' y agrega una prueba de regresión que renderiza el componente con ambas estructuras de respuesta de API, la antigua y la nueva.Verifica en el navegador — Inicia el servidor de desarrollo, abre la página de facturación en el navegador integrado de Devin y confirma que el nombre de la compañía ahora se muestra correctamente para un usuario de prueba.Abre un PR con la corrección, la prueba y una descripción que explica la causa raíz y el impacto (todos los usuarios Pro y Enterprise, ~350 cuentas).
5

Seguimiento

Once the fix PR is merged, you can ask Devin to sweep for related issues or add monitoring:If you want Devin to remember something from this investigation for next time, just tell it — e.g., “Recuerda que la API de usuario usa user.organization, no user.company.” Devin will propose a Knowledge entry that you can review and save. This way, future sessions start with the context your team has already learned.