Logging configuration in Laravel - Mini Project: Build & Apply

Logging Configuration in Laravel

📖 Scenario: You are building a Laravel web application that needs to keep track of important events and errors. Proper logging helps developers find and fix problems quickly.

🎯 Goal: Configure Laravel logging to write logs to a single file and then customize the log level to only record warnings and errors.

📋 What You'll Learn

Create a logging configuration array in config/logging.php with a single channel named single that writes to storage/logs/laravel.log

Add a variable logLevel set to warning to control the minimum log level

Modify the single channel to use the logLevel variable for its level setting

Print the current log channel and log level to verify the configuration

💡 Why This Matters

🌍 Real World

Logging is essential in real applications to track errors and important events. Laravel uses configuration files to manage logging behavior.

💼 Career

Understanding logging configuration helps developers and DevOps engineers monitor applications and troubleshoot issues efficiently.

1

Create basic logging configuration

Create a PHP array called loggingConfig with a key channels that contains a single channel. The single channel should have driver set to single and path set to storage/logs/laravel.log.

Laravel

<?php
// Your code here

Hint

Use a PHP array with nested arrays for channels and the single channel configuration.

2

Add log level configuration variable

Add a variable called logLevel and set it to the string 'warning'.

Laravel

 [
        'single' => [
            'driver' => 'single',
            'path' => 'storage/logs/laravel.log',
        ],
    ],
];
// Your code here

Hint

Declare a simple string variable named logLevel with value 'warning'.

3

Set log level in the single channel

Add a level key to the single channel inside $loggingConfig and set its value to the variable $logLevel.

Laravel

 [
        'single' => [
            'driver' => 'single',
            'path' => 'storage/logs/laravel.log',
            // Your code here
        ],
    ],
];

$logLevel = 'warning';

Hint

Inside the single array, add 'level' => $logLevel.

4

Print the current log channel and level

Write two print statements to display the current log channel name 'single' and the log level stored in $logLevel.

Laravel

 [
        'single' => [
            'driver' => 'single',
            'path' => 'storage/logs/laravel.log',
            'level' => $logLevel,
        ],
    ],
];

$logLevel = 'warning';
// Your code here

Hint

Use print("Current log channel: single\n") and print("Log level: $logLevel\n").

Practice

1. What is the main purpose of Laravel's logging configuration?

easy

A. To configure user authentication methods

B. To control where logs are saved and what details are recorded

C. To manage database connections

D. To set up email notifications

Solution

1. Step 1: Understand logging configuration role

   Logging configuration in Laravel defines how and where logs are stored and what level of detail is recorded.

2. Step 2: Compare with other options

   Database connections, authentication, and email notifications are unrelated to logging configuration.

3. Final Answer:

   To control where logs are saved and what details are recorded -> Option B

4. Quick Check:

   Logging config = control log storage and detail [OK]

Hint: Logging config sets log storage and detail level [OK]

Common Mistakes:

• Confusing logging with database setup
• Mixing logging with authentication settings
• Thinking logging controls email features

2. Which of the following is the correct way to define a single log channel in Laravel's config/logging.php?

easy

A. 'single' => ['driver' => 'single', 'path' => storage_path('logs/laravel.log'), 'level' => 'debug']

B. 'single' => ['driver' => 'file', 'path' => 'storage/logs/laravel.log', 'level' => 'info']

C. 'single' => ['driver' => 'stack', 'channels' => ['daily'], 'level' => 'error']

D. 'single' => ['driver' => 'daily', 'path' => storage_path('logs/laravel.log'), 'days' => 7]

Solution

1. Step 1: Identify correct driver and keys for single channel

   The 'single' channel uses 'driver' => 'single', a 'path' with storage_path helper, and a 'level' key.

2. Step 2: Check options for syntax and correctness

   'single' => ['driver' => 'single', 'path' => storage_path('logs/laravel.log'), 'level' => 'debug'] matches correct syntax. 'single' => ['driver' => 'file', 'path' => 'storage/logs/laravel.log', 'level' => 'info'] uses wrong driver 'file'. 'single' => ['driver' => 'stack', 'channels' => ['daily'], 'level' => 'error'] uses 'stack' driver incorrectly. 'single' => ['driver' => 'daily', 'path' => storage_path('logs/laravel.log'), 'days' => 7] misses 'level' key and has wrong driver.

3. Final Answer:

   'single' => ['driver' => 'single', 'path' => storage_path('logs/laravel.log'), 'level' => 'debug'] -> Option A

4. Quick Check:

   Single channel = driver 'single' + path + level [OK]

Hint: Single channel uses driver 'single' with path and level keys [OK]

Common Mistakes:

• Using 'file' instead of 'single' as driver
• Confusing 'stack' driver with 'single'
• Omitting required keys like 'level'

3. Given this logging configuration snippet in config/logging.php:

'stack' => [
    'driver' => 'stack',
    'channels' => ['single', 'slack'],
    'ignore_exceptions' => false,
],
'single' => [
    'driver' => 'single',
    'path' => storage_path('logs/laravel.log'),
    'level' => 'debug',
],
'slack' => [
    'driver' => 'slack',
    'url' => env('LOG_SLACK_WEBHOOK_URL'),
    'level' => 'critical',
    'username' => 'Laravel Log',
],

What happens when you log an error with level 'error' using the 'stack' channel?

medium

A. The message is ignored because 'ignore_exceptions' is false

B. The message is sent to Slack but not saved to the log file

C. The message is saved to the single log file but not sent to Slack

D. The message is saved to the log file and sent to Slack

Solution

1. Step 1: Understand channel levels and stack behavior

   The 'stack' channel sends logs to both 'single' and 'slack' channels. 'single' logs at 'debug' level, 'slack' at 'critical'.

2. Step 2: Compare log level 'error' with channel levels

   'error' is lower than 'critical', so Slack ignores it. 'single' accepts 'error' since 'debug' is lower level threshold.

3. Final Answer:

   The message is saved to the single log file but not sent to Slack -> Option C

4. Quick Check:

   Stack sends to channels; level filters Slack but not single [OK]

Hint: Stack sends to all channels; level filters each channel separately [OK]

Common Mistakes:

• Assuming all channels receive every log regardless of level
• Confusing 'ignore_exceptions' with log filtering
• Thinking Slack receives 'error' level logs when set to 'critical'

4. You have this incorrect logging channel configuration in config/logging.php:

'daily' => [
    'driver' => 'daily',
    'path' => storage_path('logs/laravel.log'),
    'days' => '7',
    'level' => 'info',
],

What is the error and how do you fix it?

medium

A. The 'days' value should be an integer, not a string; change '7' to 7

B. The 'path' should not use storage_path helper; use a string path instead

C. The 'level' key is invalid for daily driver and should be removed

D. The 'driver' should be 'single' instead of 'daily'

Solution

1. Step 1: Identify type error in 'days' key

   The 'days' key expects an integer number of days to keep logs, but it is given as a string '7'.

2. Step 2: Correct the data type

   Change 'days' => '7' to 'days' => 7 to fix the type mismatch.

3. Final Answer:

   The 'days' value should be an integer, not a string; change '7' to 7 -> Option A

4. Quick Check:

   'days' must be integer, not string [OK]

Hint: Numeric config values must be integers, not quoted strings [OK]

Common Mistakes:

• Leaving numeric values as strings causes config errors
• Removing valid keys like 'level' mistakenly
• Changing driver unnecessarily

5. You want to create a custom logging channel in Laravel that writes logs to a daily rotating file and also sends critical errors to Slack. Which configuration correctly combines these requirements?

hard

A. 'custom' => ['driver' => 'stack', 'channels' => ['single'], 'ignore_exceptions' => true], 'single' => ['driver' => 'single', 'path' => storage_path('logs/custom.log'), 'level' => 'debug']

B. 'custom' => ['driver' => 'daily', 'path' => storage_path('logs/custom.log'), 'level' => 'critical', 'days' => 14], 'slack' => ['driver' => 'stack', 'channels' => ['daily'], 'url' => env('LOG_SLACK_WEBHOOK_URL')],

C. 'custom' => ['driver' => 'slack', 'url' => env('LOG_SLACK_WEBHOOK_URL'), 'level' => 'debug'], 'daily' => ['driver' => 'daily', 'path' => storage_path('logs/custom.log'), 'level' => 'critical', 'days' => 7],

D. 'custom' => ['driver' => 'stack', 'channels' => ['daily', 'slack'], 'ignore_exceptions' => false], 'daily' => ['driver' => 'daily', 'path' => storage_path('logs/custom.log'), 'level' => 'debug', 'days' => 14], 'slack' => ['driver' => 'slack', 'url' => env('LOG_SLACK_WEBHOOK_URL'), 'level' => 'critical', 'username' => 'Custom Logger']

Solution

1. Step 1: Understand requirements for combined logging

   You need a stack channel combining 'daily' file logging and 'slack' for critical errors.

2. Step 2: Check each option for correct driver and channel setup

   'custom' => ['driver' => 'stack', 'channels' => ['daily', 'slack'], 'ignore_exceptions' => false], 'daily' => ['driver' => 'daily', 'path' => storage_path('logs/custom.log'), 'level' => 'debug', 'days' => 14], 'slack' => ['driver' => 'slack', 'url' => env('LOG_SLACK_WEBHOOK_URL'), 'level' => 'critical', 'username' => 'Custom Logger'] correctly defines 'custom' as a stack channel with 'daily' and 'slack' channels. 'daily' logs debug and above, 'slack' logs critical only. Other options misuse drivers or channels.

3. Final Answer:

   'custom' => ['driver' => 'stack', 'channels' => ['daily', 'slack'], 'ignore_exceptions' => false], 'daily' => ['driver' => 'daily', 'path' => storage_path('logs/custom.log'), 'level' => 'debug', 'days' => 14], 'slack' => ['driver' => 'slack', 'url' => env('LOG_SLACK_WEBHOOK_URL'), 'level' => 'critical', 'username' => 'Custom Logger'] -> Option D

4. Quick Check:

   Stack channel combines daily + slack with correct levels [OK]

Hint: Use stack driver to combine daily file and Slack channels [OK]

Common Mistakes:

• Using wrong driver for stack channel
• Misplacing Slack inside daily channel
• Setting ignore_exceptions true when not needed