Introducción

Para ayudarte a aprender más acerca de lo que está sucediendo dentro de tu aplicación, Laravel proporciona un robusto servicio de registro que te permite registrar mensajes en archivos, en el registro de errores del sistema e incluso en Slack para notificar a todo tu equipo.

De forma interna, Laravel usa la biblioteca Monolog, que proporciona soporte para una variedad de poderosos manejadores de registros. Laravel hace que sea pan comido configurar dichos manejadores, permitiéndote mezclarlos y juntarlos para personalizar el manejo de registros en tu aplicación.

Configuración

Toda la configuración para el sistema de registros de tu aplicación se encuentra en el archivo de configuración config/logging.php. Este archivo te permite configurar los canales de registros de tu aplicación, así que asegúrate de revisar cada uno de los canales disponibles y sus opciones. Revisaremos algunas opciones comunes a continuación.

Por defecto, Laravel usará el canal stack al registrar mensajes. El canal stack es usado para agregar múltiples canales de registros en un solo canal. Para más información sobre la construcción de stacks, revisa la documentación debajo.

Configurando el nombre del canal

Por defecto, Monolog es instanciado con un "nombre de canal" que concuerda con el entorno actual, como production o local. Para cambiar este valor, agrega una opción name a la configuración de tu canal:

'stack' => [
    'driver' => 'stack',
    'name' => 'channel-name',
    'channels' => ['single', 'slack'],
],

Drivers de canales disponibles

Nombre Descripción
stack Wrapper para facilitar la creación de canales "multi-canales"
single Canal de registro de un sólo archivo o ubicación (StreamHandler)
daily Driver de Monolog basado en RotatingFileHandler que rota diariamente
slack Driver de Monolog basado en SlackWebhookHandler
papertrail Driver de Monolog basado en SyslogUdpHandler
syslog Driver de Monolog basado en SyslogHandler
errorlog Driver de Monolog basado en ErrorLogHandler
monolog Driver factory de Monolog que puede usar cualquier manejador de Monolog soportado
custom Driver que llama a un factory especificado para crear un canal

Consulta la documentación sobre personalización avanzada de canales para aprender más sobre monolog y drivers personalizados.

Configuración de los canales single y daily

Los canales single y daily tienen tres opciones de configuración opcionales: bubble, permission y locking.

Nombre Descripción Default
bubble Indica si los mensajes deberían llegar a otros canales después de ser manejados true
permission Los permisos del archivo de registro 0644
locking Intenta bloquear el archivo de registro antes de escribirlo false

Configurando el canal de papertrail

El canal papertrail requiere de las opciones de configuración url y port. Puedes obtener estos valores desde Papertrail.

Configurando el canal de Slack

El canal slack requiere una opción de configuración url. Esta URL debe coincidir con una URL de un webhook entrante que hayas configurado para tu equipo de Slack. Por defecto, Slack sólo recibirá registros en el nivel critical y superior; sin embargo, puedes ajustar esto en tu archivo de configuración logging.

Regístrate en Styde

Para obtener acceso a ésta y a todas nuestras lecciones y cursos premium:

Ver planes

Regístrate hoy en Styde y obtén acceso a todo nuestro contenido.

Lección anterior Manejo de Errores - Documentación de Laravel 6 Lección siguiente Plantillas Blade - Documentación de Laravel 6