Laravel Sentry: Seguimiento de errores en tiempo real

Estoy seguro que algo que te preocupa mucho cuando pones tus aplicaciones Laravel en producción es saber si los visitantes de tu sitio podrán reproducir errores que tú no has podido reproducir. Esto es algo normal, aunque nuestra aplicación haya sido bien testeada, los problemas pueden aparecer. Por suerte para nosotros, los desarrolladores Laravel, Sentry soluciona este problema facilmente.

¿Qué es Sentry?

Sentry es una plataforma de seguimiento de errores y eventos en tiempo real que proporciona una forma de monitorear y solucionar problemas en aplicaciones web. Con Sentry, es posible recibir notificaciones cuando ocurren errores en tu aplicación, ver información detallada sobre los errores y rastrear el origen de los errores.

Sentry es especialmente útil para aplicaciones en producción, ya que proporciona una forma de detectar y solucionar problemas de manera rápida y eficiente. También puedes utilizar Sentry para realizar un seguimiento de eventos personalizados en tu aplicación, como el uso de características específicas por parte de los usuarios.

Sentry está disponible como un servicio en la nube o como una aplicación de código abierto que puedes instalar en tu propio servidor haciendo uso de Composer. Es compatible con una amplia variedad de lenguajes y frameworks, incluyendo PHP, JavaScript, Python, Ruby, y por supuesto, Laravel.

Instalar Sentry en Laravel

Para instalar Sentry en una aplicación Laravel, primero debes crear una cuenta en Sentry y crear un proyecto. Luego, debes instalar el paquete de integración de Laravel para Sentry mediante Composer:

Habilitar la captura de errores Laravel con Sentry

Una vez instalado Sentry en nuestro proyecto, debemos decirle a Laravel que capture las excepciones no controladas. Para ello, podemos hacer el siguiente cambio en nuestro App/Exceptions/Handler.php:

Configurar la DSN de Sentry en Laravel

A continuación, debemos ejecutar el siguiente comando en nuestro proyecto para publicar el archivo de configuración sentry.php y para actualizar nuestro .env con la variable de entorno que Sentry necesita para funcionar.

Recuerda reemplazar <dsn> por la dsn que te haya proporcionado Sentry al crear tu aplicación desde su panel.

Si abres el archivo .env, verás que Sentry ha generado una nueva variable:

Verificar la instalación de Sentry en Laravel

Una vez hemos seguido todos los pasos anteriores, debemos verificar que la instalación y configuración de Sentry ha sido correcta. Para ello, podemos ejecutar el siguiente comando en nuestro proyecto:

Deberás ver un mensaje como el siguiente en tu terminal:

Si revisas el dashboard de tu aplicación en la web de Sentry también podrás ver el error que se ha generado con el comando anterior.

Deshabilitar Sentry en localhost

Sentry es una gran herramienta para entornos de producción, pero no es ideal tenerla habilitada en entornos de desarrollo. El motivo es que en entornos de desarrollo podemos generar una gran cantidad de errores, y eso consumirá nuestros créditos de Sentry.

Para deshabilitar Sentry en localhost simplemente actualiza tu .env con lo siguiente:

Recuerda actualizar esa variable de entorno en tu entorno de producción y añadirla a tu .env.example para que quede registrada en tu repositorio.

Espero que esta entrada te haya servido para controlar los errores de tus aplicaciones Laravel en entornos de producción. Si quieres seguir aprendiendo Laravel no te pierdas nuestra ruta de aprendizaje.