Giới thiệu

Để giúp bạn hiểu thêm về những gì đang xảy ra trong ứng dụng của bạn, Laravel cung cấp các dịch vụ ghi log mạnh mẽ cho phép bạn log các message vào file, log lỗi hệ thống hoặc thậm chí là cả Slack để thông báo cho toàn bộ team của bạn.

Laravel sử dụng thư viện Monolog để cung cấp và hỗ trợ nhiều cách xử lý log mạnh mẽ. Laravel giúp bạn dễ dàng cấu hình các cách xử lý này, cho phép bạn pha trộn và kết hợp chúng lại để tùy chỉnh việc xử lý log trong ứng dụng của bạn.

Cấu hình

Tất cả cấu hình cho hệ thống ghi log của ứng dụng của bạn được lưu trong file cấu hình config/logging.php. File này cho phép bạn cấu hình các channel log, vì vậy hãy đảm bảo là bạn đã xem qua các channel hiện có và các tùy chọn của chúng. Chúng ta cũng sẽ xem xét một số tùy chọn phổ biến ở bên dưới.

Mặc định, Laravel sẽ sử dụng channel stack để ghi log. Channel stack có thể được sử dụng để tổng hợp nhiều channel log thành một channel. Để biết thêm thông tin về cách xây dựng stack, hãy xem tài liệu ở bên dưới.

Configuring The Channel Name

Mặc định, Monolog được khởi tạo bởi "tên channel" phù hợp với môi trường hiện tại đang chạy ứng dụng, chẳng hạn như production hoặc local. Để thay đổi giá trị này, hãy thêm tùy chọn name vào cấu hình channel của bạn:

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

Driver Channel có sẵn

{tip} Xem tài liệu về tùy chỉnh channel nâng cao để tìm hiểu thêm về driver monolog và custom.

Configuring The Single and Daily Channels

Các channel single và daily có thêm ba tùy chọn cấu hình khác: bubble, permission, và locking.

Configuring The Papertrail Channel

Channel papertrail sẽ yêu cầu các tùy chọn cấu hình url và port. Bạn có thể lấy các giá trị này từ Papertrail.

Configuring The Slack Channel

Channel slack yêu cầu một cấu hình url. URL này phải khớp với một URL đã cho của một webhook mà bạn đã cấu hình trong nhóm Slack của bạn.

Tạo Log Stack

Như đã đề cập trước đây, driver stack cho phép bạn kết hợp nhiều channel thành một channel duy nhất. Để minh họa cho cách sử dụng stack log, hãy xem một cấu hình mẫu sau mà bạn có thể thấy trong ứng dụng thực tế:

'channels' => [
    'stack' => [
        'driver' => 'stack',
        'channels' => ['syslog', 'slack'],
    ],

    'syslog' => [
        'driver' => 'syslog',
        'level' => 'debug',
    ],

    'slack' => [
        'driver' => 'slack',
        'url' => env('LOG_SLACK_WEBHOOK_URL'),
        'username' => 'Laravel Log',
        'emoji' => ':boom:',
        'level' => 'critical',
    ],
],

Hãy cùng xem xét cấu hình này. Đầu tiên, hãy để ý đến channel stack của chúng ta, nó được tổng hợp từ hai channel khác nhau thông qua tùy chọn channels của nó: syslog và slack. Vì vậy, khi ghi log message, cả hai channel này đều sẽ được ghi log message.

Log Levels

Hãy lưu ý tùy chọn cấu hình level có trong cấu hình channel syslog và slack có trong ví dụ ở trên. Tùy chọn này sẽ xác định xem "mức độ" tối thiểu mà một message phải có để có thể được channel ghi log. Monolog hỗ trợ các service ghi log của Laravel, cung cấp tất cả các cấp độ log được định nghĩa trong đặc tả RFC 5424: emergency, alert, critical, error, warning, notice, info, và debug.

Vì thế, code dưới đây là chúng ta đang ghi log một message bằng phương thức debug:

Log::debug('An informational message.');

Dựa vào cấu hình ở phía trên, thì channel syslog sẽ ghi message này vào trong system log; tuy nhiên, vì message này không phải là loại critical hoặc lớn hơn, nên nó sẽ không được gửi đến Slack. Tuy nhiên, nếu chúng ta ghi lại một log message là emergency, thì nó sẽ được gửi đến cả system log và Slack vì mức độ emergency sẽ cao hơn mức độ mà chúng ta đã cài đặt cho cả hai channel:

Log::emergency('The system is down!');

Viết Log Messages

Bạn có thể ghi thêm thông tin vào log bằng cách sử dụng facade Log. Như đã đề cập ở trên, log sẽ cung cấp tám cấp độ ghi log được định nghĩa trong đặc tả RFC 5424: emergency, alert, critical, error, warning, notice, info và debug:

Log::emergency($message);
Log::alert($message);
Log::critical($message);
Log::error($message);
Log::warning($message);
Log::notice($message);
Log::info($message);
Log::debug($message);

Vì vậy, bạn có thể gọi bất kỳ phương thức nào trong các phương thức này để ghi log một message cho một cấp độ tương ứng. Mặc định, message sẽ được ghi vào channel log như được cấu hình bởi file cấu hình config/logging.php của bạn:

<?php

namespace App\Http\Controllers;

use App\User;
use Illuminate\Support\Facades\Log;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * Show the profile for the given user.
     *
     * @param  int  $id
     * @return Response
     */
    public function showProfile($id)
    {
        Log::info('Showing user profile for user: '.$id);

        return view('user.profile', ['user' => User::findOrFail($id)]);
    }
}

Contextual Information

Một mảng dữ liệu có thể được truyền vào cho các phương thức log. Các dữ liệu này sẽ được định dạng và hiển thị cùng với thông báo log:

Log::info('User failed to login.', ['id' => $user->id]);

Viết cho một Channel cụ thể

Đôi khi bạn cũng có thể muốn ghi log một message vào một channel khác, khác với channel mặc định của ứng dụng của bạn. Bạn có thể sử dụng phương thức channel trên facade Log để lấy ra và log message vào bất kỳ channel nào mà đã được định nghĩa trong file cấu hình của bạn:

Log::channel('slack')->info('Something happened!');

Nếu bạn muốn tạo một stack để ghi log ở nhiều channel khác nhau, bạn có thể sử dụng phương thức stack:

Log::stack(['single', 'slack'])->info('Something happened!');

Tuỳ biến Monolog Channel nâng cao

Tuỳ biến Monolog cho Channel

Thỉnh thoảng bạn có thể cần kiểm soát cách cấu hình Monolog cho một channel. Ví dụ: bạn có thể muốn cấu hình một implementation Monolog FormatterInterface tùy biến cho các xử lý của một channel nhất định.

Để bắt đầu, hãy định nghĩa một mảng tap trong cấu hình channel của bạn. Mảng tap phải chứa một danh sách các class để tùy biến (hoặc "sửa") instance Monolog sau khi nó được tạo ra.

'single' => [
    'driver' => 'single',
    'tap' => [App\Logging\CustomizeFormatter::class],
    'path' => storage_path('logs/laravel.log'),
    'level' => 'debug',
],

Sau khi bạn đã cấu hình tùy chọn tap trong file cấu hình channel của bạn, bạn đã sẵn sàng để định nghĩa class sẽ tùy biến instance Monolog. Class này chỉ cần một phương thức duy nhất: __invoke phương thức này nhận vào một instance Illuminate\Log\Logger. Instance Illuminate\Log\Logger sẽ chuyển hướng tất cả các cuộc gọi phương thức đến trực tiếp instance Monolog để thực hiện:

<?php

namespace App\Logging;

class CustomizeFormatter
{
    /**
     * Customize the given logger instance.
     *
     * @param  \Illuminate\Log\Logger  $logger
     * @return void
     */
    public function __invoke($logger)
    {
        foreach ($logger->getHandlers() as $handler) {
            $handler->setFormatter(...);
        }
    }
}

{tip} Tất cả các class "tap" của bạn đều được service container resolve, vì vậy mọi phụ thuộc trong hàm constructor sẽ tự động được đưa vào.

Tạo Monolog xử lý Channel

Monolog có nhiều xử lý có sẵn. Trong một số trường hợp, loại log mà bạn tạo muốn tạo là một driver Monolog với một instance xử lý đặc biệt. Thì các channel này có thể tạo bằng cách dùng driver monolog.

Khi sử dụng driver monolog, tùy chọn cấu hình handler sẽ chỉ định xử lý nào sẽ được khởi tạo. Còn các tham số khác thì đều có thể được chỉ định thông qua cách sử dụng tùy chọn cấu hình with:

'logentries' => [
    'driver'  => 'monolog',
    'handler' => Monolog\Handler\SyslogUdpHandler::class,
    'with' => [
        'host' => 'my.logentries.internal.datahubhost.company.com',
        'port' => '10000',
    ],
],

Monolog Formatters

Khi sử dụng driver monolog, Monolog LineFormatter sẽ được sử dụng làm định dạng mặc định. Tuy nhiên, bạn có thể tùy chỉnh loại định dạng mà bạn muốn bằng cách sử dụng tùy chọn cấu hình formatter và formatter_with:

'browser' => [
    'driver' => 'monolog',
    'handler' => Monolog\Handler\BrowserConsoleHandler::class,
    'formatter' => Monolog\Formatter\HtmlFormatter::class,
    'formatter_with' => [
        'dateFormat' => 'Y-m-d',
    ],
],

Nếu bạn đang sử dụng xử lý Monolog mà có khả năng cung cấp một định dạng của riêng nó, thì bạn có thể set giá trị của tùy chọn cấu hình formatter thành default:

'newrelic' => [
    'driver' => 'monolog',
    'handler' => Monolog\Handler\NewRelicHandler::class,
    'formatter' => 'default',
],

Tạo Channel thông qua Factory

Nếu bạn muốn định nghĩa một channel tùy biến, trong đó bạn có toàn quyền kiểm soát về việc khởi tạo và cấu hình Monolog, bạn có thể chỉ định loại driver custom trong file cấu hình config/logging.php của bạn. Cấu hình của bạn nên chứa tùy chọn via để trỏ đến class factory sẽ được gọi để tạo instance Monolog:

'channels' => [
    'custom' => [
        'driver' => 'custom',
        'via' => App\Logging\CreateCustomLogger::class,
    ],
],

Sau khi bạn đã cấu hình xong channel custom, bạn đã sẵn sàng để định nghĩa class sẽ tạo instance Monolog của bạn. Class này chỉ cần một phương thức __invoke duy nhất sẽ trả về instance logger Monolog.

<?php

namespace App\Logging;

use Monolog\Logger;

class CreateCustomLogger
{
    /**
     * Create a custom Monolog instance.
     *
     * @param  array  $config
     * @return \Monolog\Logger
     */
    public function __invoke(array $config)
    {
        return new Logger(...);
    }
}