Einführung
Konfigurieren
• Protokollstapel erstellen
Protokoll schreiben Nachricht
• wird in den angegebenen Kanal geschrieben
erweitert Anpassung des Monolog-Protokollkanals
• Benutzerdefinierter Monolog-Kanal
  Monolog erstellen Kanäle verwalten
  Kanäle über Fabrik erstellen

Einführung

Damit Sie besser verstehen, was in Ihrer Anwendung passiert, bietet Laravel einen leistungsstarken Protokollierungsdienst, mit dem Sie Protokollnachrichten und Systemfehlerprotokolle in Dateien aufzeichnen und sogar Slack-Benachrichtigungen für Ihre Anwendung verwenden können gesamtes Team.

Im Laravel-Framework verwendet Laravel die Monolog-Bibliothek, die Unterstützung für eine Vielzahl leistungsstarker Protokollverarbeitung bietet. Mit Laravel können Sie diese Handler einfach konfigurieren, sodass Sie sie für die benutzerdefinierte Verarbeitung von Anwendungsprotokollen kombinieren können.

Konfiguration

Die gesamte Konfiguration des Anwendungsprotokollierungssystems befindet sich in der Konfigurationsdatei config/logging.php. Mit dieser Datei können Sie Ihre Anwendungsprotokollkanäle konfigurieren. Überprüfen Sie daher unbedingt jeden verfügbaren Kanal und seine Optionen. Natürlich gehen wir im Folgenden auf einige der häufig verwendeten Optionen ein.

Standardmäßig verwendet Laravel stack zum Protokollieren von Nachrichten. Der Stack-Kanal wird verwendet, um mehrere Protokollkanäle in einem einzigen Kanal zusammenzufassen. Weitere Informationen zum Stack finden Sie in der Dokumentation unten.

Kanalnamen konfigurieren

Standardmäßig wird Monolog mit einem „Kanalnamen“ instanziiert, der der aktuellen Umgebung entspricht, z. B. production oder local. Um diesen Wert zu ändern, fügen Sie Ihrer Kanalkonfiguration eine name-Option hinzu:

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

Verfügbare Kanaltreiber

{Tipp} Informationen zu monolog- und custom-Treibern finden Sie unter Erweiterte Kanalanpassung

Konfigurieren einzelner und täglicher Kanäle

single und daily Der Kanal enthält drei optionale Konfigurationselemente: bubble, permission und locking.

Konfigurieren eines Slack-Kanals

slack Kanäle erfordern die Konfigurationsoption url. Diese URL sollte mit einem eingehenden Webhook übereinstimmen, den Sie für Ihr Slack-Team konfiguriert haben.

Erstellen eines Protokollstapels

Wie bereits erwähnt, ermöglicht Ihnen der stack-Treiber die Integration mehrerer Protokollkanäle in einem einzigen Protokollkanalkanal. Schauen wir uns ein Beispiel für eine Anwendungskonfiguration auf Produktionsebene an, um zu sehen, wie der Protokollstapel verwendet wird: :

'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',    
         ],
   ],

Lassen Sie uns diese Konfiguration analysieren. Als erstes ist zu beachten, dass stack mithilfe seiner Option channels zwei weitere Kanäle aggregiert: syslog und slack . Daher haben beim Protokollieren einer Protokollnachricht beide Kanäle die Möglichkeit, die Aufzeichnung der Protokollnachricht abzuschließen:

Protokollebene

Bitte beachten Sie die syslog und < in der obiges Beispiel slack Konfigurationselemente, die in 🎜> vorhanden sind. Diese Option bestimmt die Mindestprotokollierungsstufe, die von diesem Kanal protokolliert werden muss. Monolog (ein leistungsstarker Laravel-Protokollierungsdienst) akzeptiert alle in der RFC 5424-Spezifikation definierten Stufen: levelNotfall, Alarm, kritisch, Fehler, Warnung, Hinweis, Info und Debug.

-Methode, um die Nachricht zu protokollieren: debug

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

-Kanal die Nachricht jedoch im Systemprotokoll Wenn die Nachricht nicht syslog oder höher ist, wird sie nicht an Slack gesendet. Wenn wir eine critical-Nachricht protokollieren, wird diese an Syslog und Slack gesendet, da der Level von emergency höher ist als die Mindestlevelgrenze für beide Kanäle: emergency

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

-Fassade verwenden Schreiben Sie Informationen in das Protokoll. Wie bereits erwähnt, stellt die Protokollierung die verfügbaren Protokollierungsstufen bereit, die in der RFC 5424-Spezifikation definiert sind: LogNotfall, Alarm, kritisch, Fehler, Warnung, Hinweis, info und 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);

-Konfigurationsdatei definiert ist: config/logging.php

<?php
   namespace App\Http\Controllers;use App\User;
   use Illuminate\Support\Facades\Log;
   use App\Http\Controllers\Controller;
   class UserController extends Controller{   
    /**
     * 显示给定用户的配置信息。
     *
     * @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)]);   
       }
    }

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

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

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

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

<?php
   namespace App\Logging;
   class CustomizeFormatter{   
    /**
     * 自定义给定的日志实例。
     *
     * @param  \Illuminate\Log\Logger  $logger
     * @return void
     */   
   public function __invoke($logger)   
    {      
      foreach ($logger->getHandlers() as $handler) {        
          $handler->setFormatter(...);      
         }  
      }
   }

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

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

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

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

<?php
  namespace App\Logging;use Monolog\Logger;
  class CreateCustomLogger{    
      /**
     * 创建一个 Monolog 实例.
     *
     * @param  array  $config
     * @return \Monolog\Logger
     */   
    public function __invoke(array $config) 
      {     
         return new Logger(...);  
       }
     }