Integrador de Seguimiento de Errores
Integra servicios de seguimiento de errores en aplicaciones para una mejor depuración en producción y monitorización.
Cuándo Usarlo
- El usuario solicita monitorización o seguimiento de errores
- Configuración de registro de errores en producción
- El usuario menciona "Sentry", "seguimiento de errores", "informes de fallos" o "depuración en producción"
Instrucciones
1. Detectar el Framework
Identificar el framework de la aplicación:
- React, Vue, Angular (frontend)
- Express, Fastify (backend Node.js)
- Django, Flask (Python)
- Rails (Ruby)
2. Elegir el Servicio de Seguimiento de Errores
Servicios populares:
- Sentry: El más popular, completo
- Rollbar: Bueno para backend
- Bugsnag: Multiplataforma
- Airbrake: Enfocado en Ruby
- LogRocket: Reproducción de sesiones + errores
3. Instalar y Configurar
Sentry (ejemplo con React):
npm install @sentry/react
import * as Sentry from "@sentry/react";
Sentry.init({
dsn: process.env.REACT_APP_SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
integrations: [
new Sentry.BrowserTracing(),
new Sentry.Replay()
],
});
Sentry (Node.js/Express):
const Sentry = require("@sentry/node");
Sentry.init({
dsn: process.env.SENTRY_DSN,
environment: process.env.NODE_ENV,
tracesSampleRate: 1.0,
});
// Manejador de solicitudes (primer middleware)
app.use(Sentry.Handlers.requestHandler());
// Manejador de errores (después de todas las rutas, antes del middleware de error)
app.use(Sentry.Handlers.errorHandler());
4. Añadir Límites de Error (React)
import { ErrorBoundary } from '@sentry/react';
function App() {
return (
<ErrorBoundary fallback={<ErrorFallback />}>
<YourApp />
</ErrorBoundary>
);
}
5. Añadir Contexto
Contexto de usuario:
Sentry.setUser({
id: user.id,
email: user.email,
username: user.username
});
Etiquetas:
Sentry.setTag("page_locale", "en-US");
Sentry.setTag("feature_flag", "new_ui");
Contexto:
Sentry.setContext("order", {
id: order.id,
total: order.total,
items: order.items.length
});
6. Migas de Pan
Rastrear acciones del usuario que llevan al error:
Sentry.addBreadcrumb({
category: "auth",
message: "Usuario inició sesión",
level: "info"
});
Sentry.addBreadcrumb({
category: "ui",
message: "Botón clickeado",
data: { buttonId: "submit-form" }
});
7. Captura Manual de Errores
try {
riskyOperation();
} catch (error) {
Sentry.captureException(error, {
tags: { section: "payment" },
level: "error",
extra: { orderId: order.id }
});
}
8. Filtrar Datos Sensibles
Depurar PII:
Sentry.init({
beforeSend(event, hint) {
// No enviar si contiene datos sensibles
if (event.request?.data?.password) {
delete event.request.data.password;
}
return event;
},
ignoreErrors: [
// Ignorar errores de extensiones del navegador
/extensions\//i,
/^Non-Error promise rejection/,
]
});
9. Mapas de Origen (Producción)
Habilitar mapas de origen para trazas de pila legibles:
Webpack:
// webpack.config.js
module.exports = {
devtool: 'source-map',
plugins: [
new SentryWebpackPlugin({
org: "your-org",
project: "your-project",
authToken: process.env.SENTRY_AUTH_TOKEN,
include: "./dist",
}),
],
};
10. Configuración de Alertas
Configurar alertas para:
- Nuevos problemas
- Regresión (cuando un problema resuelto vuelve a aparecer)
- Pico en la tasa de errores
- Errores críticos (pagos, fallos de autenticación)
11. Monitorización del Rendimiento
Añadir seguimiento de transacciones:
const transaction = Sentry.startTransaction({
name: "processOrder",
op: "task"
});
try {
await processOrder();
} finally {
transaction.finish();
}
12. Mejores Prácticas
- Separación de entornos: Proyectos diferentes para dev/staging/prod
- Seguimiento de versiones: Etiquetar errores con la versión de lanzamiento
- Tasas de muestreo: 100% para errores, menor % para rendimiento
- Notificaciones al equipo: Integración con Slack/correo electrónico
- Asignación de problemas: Asignación automática a responsables del código
- Agrupación de errores: Huella digital personalizada para mejor agrupación
- No registrar datos sensibles: PII, contraseñas, tokens
Archivos de Soporte
templates/sentry-react.js: Plantilla de integración Reacttemplates/sentry-node.js: Plantilla de integración Node.jstemplates/sentry-python.py: Plantilla de integración Python