Monitoreo y Sentry

Monitoreo y Sentry

El sistema utiliza Sentry para monitoreo de errores en tiempo real, captura de logs y seguimiento de rendimiento.

🚀 Configuración

1. Obtener DSN de Sentry

1. Ve a sentry.io y crea una cuenta
2. Crea un nuevo proyecto (selecciona “Astro”)
3. Copia el DSN que te proporcionan

2. Configurar Variables de Entorno

Desarrollo local (.env):

SENTRY_DSN=https://tu-dsn-aqui@sentry.io/proyecto-id
PUBLIC_ENV=development

Producción (Vercel):

• Ve a Settings → Environment Variables
• Agrega SENTRY_DSN con tu DSN
• Agrega PUBLIC_ENV=production (opcional)

3. Verificar Configuración

El sistema detecta automáticamente si Sentry está configurado. Puedes verificar con:

curl http://localhost:4321/api/test-sentry?type=status

📊 Funcionalidades

Captura Automática de Errores

Todos los errores críticos (5xx, 401, 403) se capturan automáticamente en Sentry:

• Errores de API
• Errores de integraciones externas (GoHighLevel, Resend, Backblaze)
• Errores no capturados

Console Logging

Sentry captura automáticamente:

• console.log()
• console.warn()
• console.error()

Contexto de Usuario

Cuando hay una sesión activa, los errores incluyen:

• ID de usuario
• Email
• Rol (natural/juridica/admin)

🔍 Ver Errores en Sentry

1. Ve a tu dashboard: https://sentry.io/organizations/
2. Selecciona tu proyecto
3. Ve a Issues para ver errores
4. Ve a Logs para ver console logs
5. Haz clic en cualquier error para ver:
   • Stack trace completo
   • Breadcrumbs (secuencia de eventos)
   • Contexto del usuario
   • Tags personalizados
   • Información del entorno

🧪 Probar Sentry

Endpoint de Prueba

# Error de prueba
curl http://localhost:4321/api/test-sentry?type=error

# Mensaje de prueba
curl http://localhost:4321/api/test-sentry?type=message

# Excepción no capturada
curl http://localhost:4321/api/test-sentry?type=exception

Desde el Código

import * as Sentry from '@sentry/astro';

// Capturar error manualmente
Sentry.captureException(new Error('Error de prueba'));

// Capturar mensaje
Sentry.captureMessage('Mensaje importante', 'info');

// Con contexto adicional
Sentry.captureException(error, {
  tags: { section: 'checkout' },
  extra: { userId: 123 },
});

📈 Métricas y Rendimiento

Sentry también monitorea:

• Traces: 10% de las transacciones (configurable)
• Performance: Tiempos de respuesta de endpoints
• Logs: Console logs estructurados

🔔 Alertas

Configura alertas en Sentry para:

• Errores críticos
• Aumento de tasa de errores
• Errores nuevos
• Errores por usuario específico

🛠️ Troubleshooting

Sentry no captura errores

1. Verifica que SENTRY_DSN esté configurado
2. Verifica que los archivos de configuración existan:
   • sentry.client.config.ts
   • sentry.server.config.ts
3. Revisa la consola del navegador para errores
4. Verifica que Sentry esté habilitado: enabled: !!import.meta.env.SENTRY_DSN

Errores no aparecen en Sentry

1. Espera 10-30 segundos (puede haber delay)
2. Verifica el rate limiting del plan
3. Revisa los filtros en Sentry
4. Verifica que el entorno sea correcto

📚 Recursos

• Documentación de Sentry
• Sentry para Astro
• Endpoint de prueba