Protokollrotation für Edge-Message-Processor.log aktivieren

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Logrotation – der Prozess, bei dem mehrere Logdateien in und aus der Verwendung rotiert werden – vereinfacht die Verwaltung von Systemen, die eine große Anzahl von Logdateien generieren. Die Logrotation ermöglicht die automatische Rotation, Komprimierung, Entfernung und den Versand von Logdateien.

In Edge for Private Cloud ist für einige der Hauptlogdateien auf jeder apigee Komponente ein Standardrotationsmechanismus konfiguriert. Bei der Message Processor-Komponente sind beispielsweise die folgenden Dateien mit einem Standardrotations mechanismus konfiguriert, der logback verwendet:

  • /opt/apigee/var/log/edge-message-processor/logs/system.log
  • /opt/apigee/var/log/edge-message-processor/logs/events.log
  • /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
  • /opt/apigee/var/log/edge-message-processor/logs/configurations.log
  • /opt/apigee/var/log/edge-message-processor/logs/transactions.log

Ähnliche Dateien gibt es für andere edge-*-Komponenten (deren Namen mit edge- beginnen), z. B. edge-management-server, edge-router, edge-postgres-server und edge-qpid-server.

Jede dieser edge-*-Komponenten generiert auch eine zusätzliche Logdatei, die eine umgeleitete Ausgabe der Konsole der jeweiligen Komponente ist. Bei der Message Processor-Komponente heißt diese Datei /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Andere edge-*-Komponenten generieren eine ähnliche Datei. Die Rotation dieser Dateien erfolgt nicht durch die logback-Bibliothek, sondern mit logrotate und crontab.

Hinweis

  • Wenn Sie mit logrotate-Konfigurationen nicht vertraut sind, lesen Sie das logrotate-Handbuch.
  • Wenn Sie mit crontab Konfigurationen nicht vertraut sind, lesen Sie das crontab-Handbuch.

Logrotation aktivieren

Dieser Abschnitt gilt für Edge for Private Cloud-Versionen 4.50.00 und 4.51.00.

Die Logrotation ist ein Mechanismus, der die Verwaltung von Systemen vereinfachen soll, die eine große Anzahl von Logdateien generieren. Sie ermöglicht die automatische Rotation, Komprimierung, Entfernung und den Versand von Logdateien.

Standardmäßig ist für einige der Hauptlogdateien auf jeder der apigee Komponenten ein Standardrotationsmechanismus konfiguriert. Bei der Message Processor-Komponente sind beispielsweise die folgenden Dateien mit einem Standard Rotationsmechanismus konfiguriert:

  • /opt/apigee/var/log/edge-message-processor/logs/system.log
  • /opt/apigee/var/log/edge-message-processor/logs/events.log
  • /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
  • /opt/apigee/var/log/edge-message-processor/logs/configurations.log
  • /opt/apigee/var/log/edge-message-processor/logs/transactions.log

Für andere Logdateien in apigee-Komponenten ist jedoch keine Standardrotation konfiguriert. Beispielsweise ist die Logrotation standardmäßig nicht für die apigee-Komponente Message Processor-Datei edge-message-processor.log konfiguriert.

Die Logrotation kann mit verschiedenen Dienstprogrammen/Frameworks wie logrotate, logback, oder log4j aktiviert werden. In diesem Abschnitt wird erläutert, wie Sie die Log rotation für die /opt/apigee/var/log/edge-message-processor/edge-message-processor.log Datei mit logrotate und crontab konfigurieren.

Logrotation für edge-message-processor.log auf Message Processors aktivieren

In diesem Abschnitt wird erläutert, wie Sie die Logrotation für /opt/apigee/var/log/edge-message- processor/edge-message-processor.log Logs auf den Edge Message Processors aktivieren.

In den folgenden Schritten wird beschrieben, wie Sie die Logrotation für die Datei edge-message-processor.log aktivieren:

  1. Öffnen Sie die Datei /opt/apigee/edge-message-processor/logrotate/logrotate.conf auf dem Message Processor-Computer in einem Editor. Wenn die Datei nicht vorhanden ist, erstellen Sie sie. Beispiel: 
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
  2. Fügen Sie der Datei ein Snippet hinzu, das dem unten gezeigten ähnelt: 
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
    missingok
    copytruncate
    rotate 5
    size 10M
    compress
    delaycompress
    notifempty
    nocreate
    sharedscripts
    }
  3. Speichern Sie die Änderungen.
  4. Öffnen Sie die crontab-Datei des apigee-Nutzers mit dem folgenden Befehl: 
    sudo crontab -u apigee -e
  5. Fügen Sie der crontab-Datei des apigee-Nutzers den folgenden Cronjob hinzu : 
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -s /opt/apigee/var/run/edge-message-processor/logrotate.status -f /opt/apigee/edge-message-processor/logrotate/logrotate.conf
  6. Speichern Sie die crontab-Datei und beobachten Sie die Logrotation bei der nächsten Ausführung des Cronjobs.

Logrotation für edge-message-processor.log auf dem Message Processor überprüfen

  1. Sobald der geplante Cronjob ausgeführt wird, wird die Logdatei rotiert. Im obigen Beispiel wird der Cronjob täglich um 00:00 Uhr ausgeführt, um die Datei edge-message- processor.log zu rotieren.

  2. Rufen Sie das Verzeichnis /opt/apigee/var/log/edge-message-processor/ auf und prüfen Sie, ob die Datei edge-message-processor.log rotiert wurde.

    Beispiel für eine Liste von Logdateien

    ls -ltrh | grep 'edge-message-processor'

    -rw-r--r--. 1 apigee apigee  17K Feb  7 00:00 edge-message-processor.log.1.gz
-rw-r--r--. 1 apigee apigee 5.3K Feb  7 09:12 edge-message-processor.log

    Die obige Ausgabe zeigt, dass die edge-message-processor.log Dateien rotiert und als GZ-Datei gespeichert wurden.

  3. Wenn die edge-message-processor.log Dateien nicht rotiert werden, prüfen Sie, ob Sie alle Schritte unter Logrotation für edge-message-processor.log auf Message Processors aktivieren korrekt ausgeführt haben. Wenn Sie einen Schritt ausgelassen haben, wiederholen Sie alle Schritte noch einmal.
  4. Wenn die Logrotation immer noch nicht funktioniert, wenden Sie sich an den Apigee Edge-Support.