To help developers know what is going on within their application, Laravel provides robust logging services that allow you to log messages to files, the system error log, and various other destinations.
In this tutorial, I will cover the following:
- Introduction to logging
- Overview of the Laravel log configuration file
- Setting up slack for real-time logging.
Introduction to logging
Logging in Laravel is channel-based, and each channel defines a specific way of writing log messages. For example, the single
channel writes log files to a single log file, while the daily
channel writes log to file based on date e.g. laravel-2023-01-09.log
, and the slack
channel sends log messages to Slack.
There are several cool packages that help to visualize our logs like ARCANEDEV/LogViewer, rap2hpoutre/laravel-log-viewer, and opcodesio/log-viewer
Also, you can check my previous article send logs to telegram where I covered how to set up a telegram bot to handle our application log.
Overview of Laravel Log Configuration file
Laravel provides you with great configuration flexibility which is housed in the config/logging.php
file. This file allows you to configure your application's log channels, so let's take a look at the default file below:
<?php
use Monolog\Handler\NullHandler;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\SyslogUdpHandler;
return [
'default' => env('LOG_CHANNEL', 'stack'),
'deprecations' => [
'channel' => env('LOG_DEPRECATIONS_CHANNEL', 'null'),
'trace' => false,
],
'channels' => [
'stack' => [
'driver' => 'stack',
'channels' => ['single'],
'ignore_exceptions' => false,
],
'single' => [
'driver' => 'single',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
],
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
'days' => 14,
],
'slack' => [
'driver' => 'slack',
'url' => env('LOG_SLACK_WEBHOOK_URL'),
'username' => 'Laravel Log',
'emoji' => ':boom:',
'level' => env('LOG_LEVEL', 'critical'),
],
'papertrail' => [
'driver' => 'monolog',
'level' => env('LOG_LEVEL', 'debug'),
'handler' => env('LOG_PAPERTRAIL_HANDLER', SyslogUdpHandler::class),
'handler_with' => [
'host' => env('PAPERTRAIL_URL'),
'port' => env('PAPERTRAIL_PORT'),
'connectionString' => 'tls://'.env('PAPERTRAIL_URL').':'.env('PAPERTRAIL_PORT'),
],
],
'stderr' => [
'driver' => 'monolog',
'level' => env('LOG_LEVEL', 'debug'),
'handler' => StreamHandler::class,
'formatter' => env('LOG_STDERR_FORMATTER'),
'with' => [
'stream' => 'php://stderr',
],
],
'syslog' => [
'driver' => 'syslog',
'level' => env('LOG_LEVEL', 'debug'),
],
'errorlog' => [
'driver' => 'errorlog',
'level' => env('LOG_LEVEL', 'debug'),
],
'null' => [
'driver' => 'monolog',
'handler' => NullHandler::class,
],
'emergency' => [
'path' => storage_path('logs/laravel.log'),
],
],
];
From the config file, you can see different options available for use. Let's review a few of these options and what they do. We will use the daily
option.
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => env('LOG_LEVEL', 'debug'),
'days' => 14,
],
driver
: This tells laravel the driver to use.
path
: This tells Laravel where to write the logs to.
level
: This tells Laravel the type of log to be handled by this channel. It can be debug
, critical
, warning
etc.
days
: The days
option tells Laravel how long the log should be retained before deleting.
You can read more about logging from the official documentation.
Setting up Slack for Logging
Let's proceed by creating an app on Slack. Click on the Create New App button and select the first option as seen in the image below.
Fill in the app name, select a workspace for the app and click the create app button to save the form.
Now that our app has been created, select the incoming webhooks
option and activate the toggle on the next screen shown to you.
Scroll down to the bottom of the page and click on Add New Webhook to Workspace. On the next screen shown to you, select a channel and click on Allow
Slack will now generate a webhook URL for us. Copy it, head over to your .env
file and add it to your app like below.
LOG_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/xxxxxxxxxx
Open up the logging.php
file then under channels array, since the default is set to stack, let's change the channels to slack
from single
and save the file.
'stack' => [
'driver' => 'stack',
'channels' => ['slack'],
'ignore_exceptions' => false,
],
Let's test it out by opening up Tinker and run the command below:
info("This is just a tutorial demo logging");
Voila!!!
Wrapping up
In this article, you have learned about logging in to Laravel and how to set up Slack to receive your application logs in real time.
Top comments (0)