¿Qué hace Integración de Sentry?
Guía para usar Sentry en el monitoreo de errores y trazado de rendimiento.
Captura de Excepciones
Usa Sentry.captureException(error) en bloques try/catch:
try {
await riskyOperation();
} catch (error) {
Sentry.captureException(error);
throw error;
}
Trazado de Rendimiento
Crea spans para acciones significativas como clics en botones, llamadas API y llamadas a funciones.
Acciones de UI
function handleClick() {
Sentry.startSpan(
{ op: "ui.click", name: "Enviar Formulario" },
(span) => {
span.setAttribute("formId", formId);
submitForm();
}
);
}
Llamadas API
async function fetchData(id) {
return Sentry.startSpan(
{ op: "http.client", name: `GET /api/items/${id}` },
async () => {
const response = await fetch(`/api/items/${id}`);
return response.json();
}
);
}
Configuración (Next.js)
Archivos de inicialización de Sentry:
sentry.client.config.ts- Lado del clientesentry.server.config.ts- Lado del servidorsentry.edge.config.ts- Entorno edge
Importa con import * as Sentry from "@sentry/nextjs" - no es necesario inicializar en otros archivos.
Configuración Básica
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
enableLogs: true,
});
Con Registro en Consola
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
integrations: [
Sentry.consoleLoggingIntegration({ levels: ["log", "warn", "error"] }),
],
});
Registro Estructurado
Usa logger.fmt para plantillas literales con variables:
const { logger } = Sentry;
logger.trace("Iniciando conexión", { database: "users" });
logger.debug(logger.fmt`Fallo de caché para: ${userId}`);
logger.info("Perfil actualizado", { profileId: 345 });
logger.warn("Límite de tasa alcanzado", { endpoint: "/api/data" });
logger.error("Pago fallido", { orderId: "order_123" });
logger.fatal("Conjunto de conexiones agotado", { activeConnections: 100 });