{"id":2701,"date":"2024-11-26T11:30:47","date_gmt":"2024-11-26T14:30:47","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=2701"},"modified":"2025-12-05T11:47:52","modified_gmt":"2025-12-05T14:47:52","slug":"laravel-log","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/laravel-log\/","title":{"rendered":"Laravel Log"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Laravel Log<\/strong>: O sistema de Logging<\/strong> \u00e9 uma funda\u00e7\u00e3o para qualquer aplica\u00e7\u00e3o robusta. No Laravel 12<\/strong>, o logging \u00e9 gerenciado pela poderosa biblioteca Monolog<\/strong>, que \u00e9 integrada de forma transparente, permitindo registrar eventos, erros e informa\u00e7\u00f5es de debug<\/em> durante a execu\u00e7\u00e3o. O Laravel Log<\/strong> \u00e9 essencial para a depura\u00e7\u00e3o<\/strong>, monitoramento de desempenho<\/strong> e auditoria<\/strong> de seguran\u00e7a.<\/p>\n\n\n\n

Neste artigo, exploraremos como configurar o Laravel Log, utilizar os diferentes n\u00edveis de log<\/strong> e gerenciar canais de destino.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. \u2699\ufe0f Configura\u00e7\u00e3o e Canais de Log<\/h2>\n\n\n\n

O sistema de logging \u00e9 configurado no arquivo config\/logging.php<\/code><\/strong>. Este arquivo define os Canais de Log<\/strong>, que s\u00e3o os destinos para onde as mensagens s\u00e3o enviadas.<\/p>\n\n\n\n

<\/div>\n\n\n\n

A. Drivers de Log (Canais)<\/h3>\n\n\n\n

Cada canal utiliza um driver<\/strong> que define o m\u00e9todo de armazenamento\/envio:<\/p>\n\n\n\n

Driver<\/strong><\/td>Descri\u00e7\u00e3o<\/strong><\/td>Uso Comum<\/strong><\/td><\/tr><\/thead>
single<\/code><\/strong><\/td>Grava logs em um \u00fanico arquivo (padr\u00e3o).<\/td>Desenvolvimento e ambientes de baixo tr\u00e1fego.<\/td><\/tr>
daily<\/code><\/strong><\/td>Cria um novo arquivo de log por dia (\u00f3timo para manuten\u00e7\u00e3o).<\/td>Ambientes de produ\u00e7\u00e3o para f\u00e1cil rota\u00e7\u00e3o.<\/td><\/tr>
slack<\/code><\/strong><\/td>Envia logs para um canal do Slack.<\/td>Alertas cr\u00edticos que exigem a\u00e7\u00e3o imediata.<\/td><\/tr>
syslog<\/code><\/strong><\/td>Envia logs para o sistema de log do servidor.<\/td>Integra\u00e7\u00e3o com infraestrutura de logging<\/em> centralizada.<\/td><\/tr>
stack<\/code><\/strong><\/td>Combina m\u00faltiplos canais (ex: grava no arquivo E envia para o Slack).<\/td>Padr\u00e3o do ambiente de produ\u00e7\u00e3o.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

B. N\u00edvel M\u00ednimo<\/h3>\n\n\n\n

Para cada canal, voc\u00ea define o n\u00edvel m\u00ednimo<\/strong> de log que ser\u00e1 gravado. No exemplo abaixo, o canal single<\/code> ir\u00e1 registrar qualquer evento com n\u00edvel debug<\/code><\/strong> ou superior.<\/p>\n\n\n\n

PHP<\/p>\n\n\n\n

\/\/ config\/logging.php\n'channels' => [\n    'single' => [\n        'driver' => 'single',\n        'path' => storage_path('logs\/laravel.log'),\n        'level' => 'debug', \/\/ Tudo a partir de DEBUG ser\u00e1 registrado\n    ],\n    \/\/ ...\n],\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. \ud83d\udea6 N\u00edveis de Log (RFC 5424)<\/h2>\n\n\n\n
O Monolog e o Laravel seguem os 8 n\u00edveis de log definidos pelo RFC 5424<\/strong>, listados em ordem de severidade crescente:<\/p>\n\n\n\n
N\u00edvel<\/strong><\/td>Objetivo<\/strong><\/td>Exemplo de Uso<\/strong><\/td><\/tr><\/thead>
debug<\/code><\/strong><\/td>Informa\u00e7\u00f5es detalhadas para debug<\/strong> (uso interno).<\/td>Valores de vari\u00e1veis, execu\u00e7\u00e3o de queries SQL.<\/td><\/tr>
info<\/code><\/strong><\/td>Eventos normais e interessantes (fluxo de aplica\u00e7\u00e3o).<\/td>“Usu\u00e1rio logado com sucesso.”<\/td><\/tr>
notice<\/code><\/strong><\/td>Eventos significativos, mas n\u00e3o cr\u00edticos.<\/td>Algu\u00e9m limpou o cache.<\/td><\/tr>
warning<\/code><\/strong><\/td>Indica problemas potenciais que podem n\u00e3o exigir a\u00e7\u00e3o imediata.<\/td>Uso de recurso deprecated<\/em>.<\/td><\/tr>
error<\/code><\/strong><\/td>Erros que n\u00e3o causam a interrup\u00e7\u00e3o completa da aplica\u00e7\u00e3o.<\/td>Erro ao enviar um e-mail.<\/td><\/tr>
critical<\/code><\/strong><\/td>Componente ou aplicativo indispon\u00edvel (requer a\u00e7\u00e3o).<\/td>Falha na conex\u00e3o com um servi\u00e7o de pagamento.<\/td><\/tr>
alert<\/code><\/strong><\/td>Exige a\u00e7\u00e3o imediata; erro corrigido no n\u00edvel do servidor.<\/td>Servidor prim\u00e1rio do banco de dados caiu.<\/td><\/tr>
emergency<\/code><\/strong><\/td>O sistema est\u00e1 inutiliz\u00e1vel (ex: crash<\/em> total).<\/td>Erro cr\u00edtico na inicializa\u00e7\u00e3o do framework.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n
3. \u270d\ufe0f Registrando Eventos<\/h2>\n\n\n\n
Voc\u00ea pode registrar logs de qualquer lugar do seu c\u00f3digo usando a Facade Log<\/code><\/strong> ou o helper<\/em> logger()<\/code><\/strong>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
A. Uso da Facade Log<\/code><\/h3>\n\n\n\n
Voc\u00ea chama o m\u00e9todo que corresponde ao n\u00edvel de severidade que deseja registrar.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
use Illuminate\\Support\\Facades\\Log;\n\n\/\/ 1. Log de Informa\u00e7\u00e3o\nLog::info('Usu\u00e1rio logado com sucesso no sistema.');\n\n\/\/ 2. Log de Erro\ntry {\n    \/\/ ... c\u00f3digo que pode falhar ...\n} catch (\\Exception $e) {\n    Log::error('Erro ao processar o formul\u00e1rio', ['exception' => $e->getMessage()]);\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
B. Logs Contextuais e Dados Adicionais<\/h3>\n\n\n\n
\u00c9 uma melhor pr\u00e1tica<\/strong> adicionar um array<\/em> de dados contextuais<\/strong> ao seu log. Isso facilita a depura\u00e7\u00e3o, fornecendo informa\u00e7\u00f5es \u00fateis no momento do evento.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
$userId = auth()->id();\n$postId = 42;\n\nLog::info('Post criado com sucesso.', [\n    'user_id' => $userId, \n    'post_id' => $postId, \n    'ip_address' => request()->ip()\n]);\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
C. Registrando em Canais Espec\u00edficos<\/h3>\n\n\n\n
Se o seu projeto tiver canais de log dedicados (ex: para auditoria ou produ\u00e7\u00e3o), voc\u00ea pode direcionar a mensagem:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
\/\/ Direciona a mensagem para o canal 'production' (definido em logging.php)\nLog::channel('production')->alert('Falha cr\u00edtica na API de terceiros!');\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
4. \ud83d\ude80 Melhores Pr\u00e1ticas de Logging<\/h2>\n\n\n\n