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

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an.
info

Die Protokollauslagerung, bei der mehrere Protokolldateien nacheinander verwendet und dann wieder entfernt werden, vereinfacht die Verwaltung von Systemen, die eine große Anzahl von Protokolldateien generieren. Mit der Protokollrotation können Protokolldateien automatisch rotiert, komprimiert, entfernt und per E-Mail gesendet werden.

In Edge for Private Cloud sind einige der Hauptprotokolldateien jeder apigee-Komponente mit einem standardmäßigen Rotationsmechanismus konfiguriert. Für die Nachrichtenprozessorkomponente sind beispielsweise die folgenden Dateien mit einem Standardrotationsmechanismus mit 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

Ä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 Protokolldatei, 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. Bei anderen edge-*-Komponenten wird eine ähnliche Datei generiert. Die Rotation dieser Dateien erfolgt nicht über die Logback-Bibliothek, sondern über 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.

Protokollrotation aktivieren

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

Die Protokollauslagerung ist ein Mechanismus, der die Verwaltung von Systemen mit einer großen Anzahl von Protokolldateien vereinfacht. Es ermöglicht die automatische Rotation, Komprimierung, Entfernung und das Versenden von Protokolldateien.

Standardmäßig sind einige der Hauptprotokolldateien auf jeder der apigee-Komponenten mit einem Standardrotationsmechanismus konfiguriert. In 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 für die Standardrotation konfiguriert. Beispielsweise ist die Protokollauslagerung in der Message Processor-Datei edge-message-processor.log der Komponente apigee standardmäßig nicht konfiguriert.

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

Protokollauslagerung 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-Nachrichten-Prozessoren aktivieren.

In den folgenden Schritten wird beschrieben, wie Sie die Protokollauslagerung 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-Rechner 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 mit dem folgenden Befehl die crontab des Nutzers apigee:
    sudo crontab -u apigee -e
    
  5. Fügen Sie dem crontab des Nutzers apigee den folgenden Cron-Job 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 crontab und überwachen Sie die Protokollrotation bei der nächsten Ausführung des Cron-Jobs.

Protokollrotation für „edge-message-processor.log“ auf dem Nachrichtenverarbeiter prüfen

  1. Sobald der geplante Cron-Job ausgeführt wird, wird die Protokolldatei rotiert. Im obigen Beispiel wird der Cronjob so geplant, dass er jeden Tag um 00:00 Uhr ausgeführt wird, um die edge-message- processor.log-Datei 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 zeigt an, dass die Dateien edge-message-processor.log rotiert und als GZ-Datei gespeichert werden.

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