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

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Die Log-Rotation – der Vorgang des Rotierens mehrerer Logdateien im Einsatz oder nicht – vereinfacht die Verwaltung von Systemen, die eine große Anzahl von Logdateien generieren. Die Log-Rotation ermöglicht die automatische Rotation, Komprimierung, Entfernung und Zustellung von Protokolldateien.

In Edge for Private Cloud sind einige der Hauptlogdateien auf jeder apigee-Komponente mit einem Standardrotationsmechanismus konfiguriert. Auf der Message Processor-Komponente sind beispielsweise die folgenden Dateien mit einem Standardrotationsmechanismus unter Verwendung von Logback 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 edge-*-Komponenten, deren Namen mit edge- beginnen, gibt es ähnliche Dateien, z. B. edge-management-server, edge-router, edge-postgres-server und edge-qpid-server.

Jede dieser edge-*-Komponenten generiert außerdem eine zusätzliche Logdatei, die eine weitergeleitete Ausgabe der Konsole der jeweiligen Komponente ist. Im Fall 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 von der Logback-Bibliothek, sondern mithilfe von 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.

Log-Rotation aktivieren

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

Die Logrotation ist ein Mechanismus, der die Verwaltung von Systemen vereinfacht, die eine große Anzahl von Logdateien generieren. Er ermöglicht das automatische Drehen, Komprimieren, Entfernen und Versenden von Protokolldateien.

Standardmäßig sind einige der Hauptlogdateien auf jeder der apigee-Komponenten mit einem Standardrotationsmechanismus konfiguriert. Auf der Message Processor-Komponente sind beispielsweise die folgenden Dateien mit dem Standardrotationsmechanismus 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

Andere Protokolldateien in apigee-Komponenten sind jedoch nicht mit der Standardrotation konfiguriert. Beispielsweise ist die Log-Rotation nicht standardmäßig für die Nachrichtenprozessordatei der apigee-Komponente 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 Datei /opt/apigee/var/log/edge-message-processor/edge-message-processor.log mit logrotate und crontab konfigurieren.

Protokollrotation 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 Processorn aktivieren.

In den folgenden Schritten wird beschrieben, wie Sie die Log-Rotation 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 ähnlich der folgenden hinzu:
    /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 das crontab des apigee-Nutzers mit dem folgenden Befehl:
    sudo crontab -u apigee -e
    
  5. Fügen Sie dem crontab 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 den crontab und überwachen Sie die Log-Rotation bei der nächsten Ausführung des Cronjobs.

Protokollrotation für Edge-message-processor.log auf dem Message Processor verifizieren

  1. Sobald der geplante Cronjob ausgeführt wird, wird die Protokolldatei rotiert. Im obigen Beispiel wird der Cronjob jeden Tag 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 Protokolldateien

    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 gibt an, dass die edge-message-processor.log-Dateien rotiert und als GZ-Datei gespeichert werden.

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