Clase 06 · Módulo 12
Monitoreo de errores con Sentry
Monitoreo de errores con Sentry
Qué logras en esta clase
Tu app te avisa cuando falla en el teléfono de un usuario, con la información necesaria para reproducir el error y arreglarlo.
- Instalas Sentry en un proyecto Expo.
- Dejas los errores legibles con source maps.
- Cuidas la privacidad y el cupo gratuito.
- Decides qué error atender primero.
02
En producción no hay pantalla roja
Cuando la app falla en el teléfono de un usuario, nadie te avisa. Lo normal es que la cierre, la desinstale y no escriba nunca.
03
Qué es Sentry y qué te entrega
Sentry es un servicio de monitoreo de errores: tu app le envía cada falla y él la guarda, la agrupa y te avisa.
- El mensaje y la pila de llamadas.
- Modelo de teléfono y versión del sistema.
- Versión de tu app.
- Cuántos usuarios y cuántas veces.
- Las acciones previas a la falla.
04
Opciones para enterarte de las fallas
| Opción | Qué da | Límite |
|---|---|---|
| Sentry | Errores de JavaScript y nativos, con contexto | Cupo mensual |
| Paneles de las tiendas | Caídas en Play Console y en Xcode | Sin tus errores de JavaScript; Xcode exige Mac |
| EAS Observe | Monitoreo de Expo | API todavía cambiante |
Los paneles de las tiendas no se instalan: revísalos igual. Esta clase configura Sentry.
05
El plan gratuito, al 18-11-2026
| Plan Developer | Incluye |
|---|---|
| Precio | 0 USD |
| Usuarios de la cuenta | 1 |
| Errores al mes | 5.000 |
| Repeticiones de sesión | 50 |
| Historial | 30 días |
El plan Team cuesta 29 USD al mes. Para una primera app, el gratuito alcanza si cuidas el cupo. Vuelve a comprobar las cifras en la página de precios.
06
Cómo viaja un error
Un «issue» es un grupo: mil usuarios con el mismo error forman un solo issue con mil eventos.
07
Instalar
- Crea una cuenta en Sentry y un proyecto de tipo React Native.
- En la carpeta de tu app, ejecuta el asistente:
npx @sentry/wizard@latest -i reactNative- Revisa con Claude Code el diff de lo que modificó.
- Compila un build nuevo: el paquete trae código nativo.
Requiere Expo SDK 50 o superior. Alternativa manual: npx expo install @sentry/react-native y seguir la guía paso a paso.
08
Qué cambia en tu proyecto
| Archivo | Cambio |
|---|---|
| Layout raíz | Llamada a Sentry.init con tu DSN |
| Layout raíz | El componente se exporta con Sentry.wrap |
app.json | Plugin @sentry/react-native/expo con organización y proyecto |
metro.config.js | Configuración getSentryExpoConfig |
Saber qué toca cada uno te permite revisar lo que hizo el asistente.
09
La inicialización, leída
import * as Sentry from '@sentry/react-native';
Sentry.init({
dsn: process.env.EXPO_PUBLIC_SENTRY_DSN,
tracesSampleRate: 0.1,
});El DSN es la dirección de tu proyecto en Sentry. tracesSampleRate es la fracción de sesiones de las que se envían medidas de rendimiento: 0.1 es una de cada diez.
10
Dos valores, dos tratamientos
| Valor | Dónde vive | Motivo |
|---|---|---|
| DSN | Dentro de la app | Solo permite enviar errores a tu proyecto |
| Token de autenticación | .env.local y variables de EAS | Permite subir archivos a tu cuenta |
El token se guarda en EAS con eas env:set bajo el nombre SENTRY_AUTH_TOKEN.
11
Source maps: de código reducido a tu código
El código final va reducido a nombres de una letra. Un source map es el archivo que traduce esa versión a tus archivos y líneas originales.
- Con EAS Build, los builds finales lo suben solos si el token está disponible.
- Con una actualización por aire (módulo 15), se sube aparte: la guía de Sentry indica el comando.
12
Por qué importan
Sin source maps, el error apunta a un archivo ilegible de una sola línea. Con ellos, apunta a tu archivo y tu línea.
13
Comprobar que funciona
- Agrega un botón temporal que ejecute esto:
Sentry.captureException(new Error('Primer error'));- Compila una versión que no sea de desarrollo e instálala.
- Toca el botón.
- Abre la sección de issues en Sentry: debe aparecer en pocos minutos.
- Confirma que la pila muestra tu archivo y tu línea.
- Quita el botón.
14
Privacidad: qué estás enviando
El ejemplo oficial activa sendDefaultPii (datos personales por defecto) y la repetición de sesión, que graba la pantalla.
- Quita lo que no necesites.
- Identifica al usuario por su
idinterno, no por su correo. - No pongas datos personales en los mensajes de error.
15
Cuidar el cupo de 5.000 errores
- Un error dentro de un ciclo que se repite puede gastar el cupo en una tarde.
- Separa desarrollo de producción para no contar tus propias pruebas.
- Baja las tasas de muestreo del ejemplo oficial: vienen al máximo.
- Arregla o silencia los errores ruidosos que no afectan al usuario.
16
Leer un issue
- Mensaje: qué falló.
- Pila: tu archivo y tu línea.
- Usuarios y eventos: a cuántos y cuántas veces.
- Versión de la app: si viene de la última o de una antigua.
- Dispositivo y sistema: si se concentra en un modelo o versión.
- Acciones previas: qué pantallas y peticiones hubo antes.
Con eso reproduces el error en tu computador, como en la clase 1.
17
Cuál atender primero
| Criterio | Pregunta |
|---|---|
| Alcance | ¿A cuántos usuarios distintos afecta? |
| Lugar | ¿Está en ingreso, pago o la acción principal? |
| Novedad | ¿Apareció con la última versión? |
| Gravedad | ¿Cierra la app o solo falla una acción? |
Un error nuevo, en el pago, que cierra la app, va antes que todo lo demás.
18
Usuarios, no eventos
Ordena por usuarios afectados. Un issue con 900 eventos de una sola persona pesa menos que uno con 40 eventos de 40 personas.
19
Del issue al arreglo
Si el mismo error vuelve a llegar desde una versión posterior, el arreglo no cubrió todos los casos: se reproduce de nuevo con los datos del evento más reciente.
20
Trabajar un issue con Claude Code
Copia a Claude Code el mensaje, la pila completa, la versión de la app, el dispositivo y las acciones previas.
Pide lo mismo que en la clase 1: primero la causa con archivo y línea, después una prueba que reproduzca el error, y al final el cambio mínimo.
21
Alertas que sirven
Configura en Sentry un aviso por correo para dos casos: un issue nuevo y un issue resuelto que reaparece.
Los nombres de las opciones cambian: búscalas en la sección de alertas de tu proyecto.
22
Errores comunes
- Instalar Sentry y no comprobar con un error de prueba.
- Publicar sin source maps y recibir pilas ilegibles.
- Dejar activada la grabación de pantalla sin declararla.
- Mirar el panel solo cuando alguien reclama.
- Tratar todos los issues como igual de urgentes.
23
Lo que te llevas
- Sin monitoreo, las fallas de producción son invisibles.
- Sentry entrega pila, dispositivo, versión y usuarios afectados.
- El DSN va en la app; el token de autenticación, nunca en el repositorio.
- Source maps y un error de prueba antes de publicar.
- Se prioriza por usuarios afectados y por lugar del recorrido.
24
Hazlo ahora
Quince minutos:
- Crea la cuenta gratuita y un proyecto React Native en Sentry.
- Ejecuta el asistente en tu proyecto y revisa el diff con Claude Code.
- Quita del
Sentry.initlas opciones que recogen datos que no necesitas. - Agrega el botón con el error de prueba.
- Deja anotado, para tu próximo build, comprobar que el issue llega con tu archivo y tu línea.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026