Cómo detectar errores en producción: configuramos el monitoreo en 15 minutos

Has desplegado una nueva funcionalidad. En tu máquina local todo funciona a la perfección, estás satisfecho con el resultado.
Y entonces aparece el mensaje: «A mí no me funciona nada». Abres los registros del servidor: están vacíos. Resulta que el error ocurrió en el lado del cliente, en el navegador antiguo de un usuario o con configuraciones no estándar. Y podrías ni siquiera enterarte.

Esto les pasa prácticamente a todos los que despliegan proyectos en producción. Me pasaba también hasta que configuré una herramienta que permite ver los errores casi al instante —incluso si es de madrugada y el problema lo sufrió un único usuario al otro lado del mundo.

Esa herramienta es Sentry. En este artículo te mostraré cómo conectar Sentry a tu proyecto en quince minutos.

Por qué necesitas Sentry

Imagina un sistema de videovigilancia. Mientras no hay cámaras, no sabes qué ocurre en la habitación. En cuanto aparecen, la situación cambia por completo: todo bajo control.

Sentry funciona con el mismo principio, pero para tu aplicación. Registra errores, advertencias y comportamientos anómalos para que te enteres de los problemas antes que los usuarios.

Qué ofrece Sentry:

• Notificaciones instantáneas: te enteras del error de inmediato —en Telegram, Slack, correo u otro canal.
• Contexto detallado: Sentry mostrará qué usuario tuvo el error, en qué dispositivo y en qué condiciones.
• Pila de llamadas (stack trace): el lugar exacto en el código donde todo falló.
• Historial de acciones (breadcrumbs): la secuencia de eventos que llevó al fallo.
• Priorización: sabes si el problema lo sufrió una persona o cientos.

Para proyectos personales y startups es especialmente agradable que Sentry tiene un plan gratuito muy generoso.

Cómo conectar Sentry: instrucción paso a paso

Paso 1. Registro

Ve al sitio https://sentry.io y crea una cuenta. Puedes usar GitHub o Google para acelerar el proceso.
Durante el registro selecciona el idioma principal de tu aplicación. Los demás lenguajes y plataformas se pueden añadir después.

Paso 2. Crear un proyecto

Haz clic en el botón Crear proyecto.
Selecciona tu plataforma: Node.js, Python, Django, React, Next.js, Go, PHP — lo que sea.
Dale al proyecto un nombre comprensible, por ejemplo:

my-awesome-app

Después de esto Sentry generará para ti un DSN — una dirección única a la que la aplicación enviará los informes de errores. Se parece a esto:

https://12345abc@o123456.ingest.sentry.io/1234567

Guarda esta dirección — la necesitarás en un minuto.

Paso 3. Conectar Sentry en el código

Abajo — instrucciones para tecnologías populares. Sentry ofrecerá automáticamente ejemplos listos para la plataforma seleccionada.

JavaScript / React / Next.js

Instala las dependencias:

npm install @sentry/browser @sentry/tracing

Inicializa Sentry en el punto de entrada (por ejemplo, index.js, _app.js):

import * as Sentry from "@sentry/browser";

Sentry.init({
  dsn: "TU_DSN_AQUI",
  release: "my-awesome-app@1.0.0",
  tracesSampleRate: 1.0
});

Python (Django / Flask / FastAPI)

Instalación:

pip install sentry-sdk

Inicialización:

import sentry_sdk

sentry_sdk.init(
    dsn="TU_DSN_AQUI",
    traces_sample_rate=1.0,
    release="1.0.0",
)

Paso 4. Comprobar el funcionamiento

Añade una llamada temporal de prueba de error:

throw new Error("Test Sentry Error");

Ejecuta la aplicación, abre la página correspondiente y luego entra al panel de Sentry.
Tras diez-treinta segundos aparecerá un nuevo error —todo funciona como debe.

Paso 5. Configurar las notificaciones

Ve a: Settings → Alerts → Create Alert

Selecciona la condición de notificación, por ejemplo:

• cada error nuevo,
• aumento en la cantidad de errores,
• errores de una versión específica del release.

Elige el canal de entrega: Telegram, Slack, Microsoft Teams, Email o Webhook.

Paso 6. Cómo rastrear releases (bonus)

El seguimiento de releases permite ver: qué versión contiene el error, cuántos usuarios están afectados y cuándo se manifestó el problema por primera vez.

La forma más sencilla es el CLI oficial:

curl -sL https://sentry.io/get-cli/ | bash
sentry-cli releases new $VERSION
sentry-cli releases finalize $VERSION

Te recomiendo integrarlo en el CI/CD para que todo ocurra automáticamente.

Cuánto cuesta Sentry (a noviembre de 2025)

Plan gratuito — Developer Plan

• 5 000 errores al mes
• 5 000 000 de spans para monitorización de rendimiento

Esto es más que suficiente para la mayoría de proyectos personales y MVP.

Plan comercial — Team Plan

Desde 26 dólares al mes con pago anual.
Se elige cuando los límites se quedan cortos o se requiere funcionalidad avanzada.

Conclusión

Conectar Sentry es una de las formas más rápidas de mejorar la calidad del producto.
Tú:

1. Te registras en el servicio.
2. Añades unas pocas líneas de código.
3. Obtienes control sobre producción.

Dejas de temer mensajes de usuarios como «a mí no me funciona nada», porque ahora te enteras de los problemas primero —y los arreglas antes de que alguien se enoje.