Kontakt

System in den Debug-Modus versetzen

So stellen Sie TAO für die Protokollierung und Fehlerbehebung auf Debuggen ein.

Wenn Sie versuchen, einen Fehler aufzuspüren, ist es wichtig, Ihr System auf Debuggen einzustellen, um die Menge an Informationen in Ihren Protokollen zu erhöhen.

Um dies zu tun, müssen Sie SSH auf Ihren Server, und dann cd dorthin, wo Sie TAO installiert haben. Sie bearbeiten dann config/generis.conf.php und stellen Sie sicher DEBUG_MODE ist eingestellt auf true wie unten gezeigt:

// mode
define('DEBUG_MODE', true);

Wenn Sie eine detailliertere Protokollierung benötigen, verfügt TAO über einen Logger, der eine PSR-3-Logger-Schnittstelle. Der Logger verwendet TaoMonoLog die ein Wrapper für Monolog ist. Es besteht zwar Abwärtskompatibilität zu common_log, durch TaoLog Diese Funktionalität ist veraltet.

Der Logger kann konfiguriert werden in config/generis/log.conf.phpund enthält mehrere verschiedene Beispiele. Diese Beispiele können verwendet werden, um verschiedene Methoden zum Streamen von Protokollen in eine Datei, eine Webkonsole, Slack usw. zu konfigurieren.

Die vom Logger verwendeten Protokollierungsebenen sind wie folgt:

  • DEBUG (100): Detaillierte Debug-Informationen.
  • INFO (200): Interessante Ereignisse. Beispiele: Benutzer meldet sich an, SQL-Protokolle.
  • HINWEIS (250): Normale, aber signifikante Ereignisse.
  • WARNUNG (300): Außergewöhnliche Vorkommnisse, die keine Fehler sind. Beispiele:
    Verwendung veralteter APIs, schlechte Verwendung einer API, unerwünschte Dinge, die nicht
    nicht unbedingt falsch sind.
  • ERROR (400): Laufzeitfehler, die keine sofortige Aktion erfordern, aber
    sollten typischerweise protokolliert und überwacht werden.
  • KRITISCH (500): Kritische Bedingungen. Beispiel: Anwendungskomponente
    nicht verfügbar, unerwartete Ausnahme.
  • ALERT (550): Es müssen sofort Maßnahmen ergriffen werden. Beispiel: Gesamte Website
    down, Datenbank nicht verfügbar, etc. Dies sollte die SMS-Warnungen auslösen und
    Sie auf.
  • NOTFALL (600): Notfall: System ist unbrauchbar.

Im Folgenden wird ein Beispiel für die Konfiguration von config/generis/log.conf.php zu senden debuggen Level-Protokolle in eine Datei, in diesem Fall /var/www/html/tao/logs/test-log.log:

return new oat\oatbox\log\LoggerService(array(
    'logger' => array(
        'class' => \oat\oatbox\log\logger\TaoMonolog::class,
        'options' => array(
            'name' => 'tao',
            'handlers' => array(
                array(
                    'class' => \Monolog\Handler\StreamHandler::class,
                    'options' => array(
                        '/var/www/html/tao/logs/test-log.log',
                        \Monolog\Logger::DEBUG
                    )
                )
            )
        )
)));
return new oat\oatbox\log\LoggerService();