Włącz rotację logów dla pliku edge-message-processor.log

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Rotacja logów to proces zastępowania plików logów innymi. Upraszcza on administrację systemów, które generują dużą liczbę plików logów. Rotacja logów umożliwia automatyczne obracanie, kompresowanie, usuwanie i wysyłanie plików logów.

W Edge for Private Cloud niektóre główne pliki dziennika w każdym komponencie apigee są skonfigurowane za pomocą domyślnego mechanizmu rotacji. Na przykład w komponencie przetwarzania wiadomości za pomocą logbacka domyślny mechanizm rotacji jest skonfigurowany w przypadku tych plików:

  • /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

Podobne pliki występują też w przypadku innych komponentów edge-* (których nazwy zaczynają się od edge-), takich jak edge-management-server, edge-router, edge-postgres-server i edge-qpid-server.

Każdy z tych komponentów edge-* generuje też dodatkowy plik dziennika, który jest przekierowanym wyjściem konsoli danego komponentu. W przypadku komponentu Message Processor ten plik ma nazwę /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Inne komponenty edge-* generują podobny plik. Rotacja tych plików nie jest wykonywana przez bibliotekę logback, ale za pomocą funkcji logrotate i crontab.

Zanim zaczniesz

Włączanie rotacji logów

Ta sekcja dotyczy wersji Edge for Private Cloud 4.50.00 i 4.51.00.

Rotacja logów to mechanizm, który ułatwia administrowanie systemami generującymi dużą liczbę plików logów. Umożliwia automatyczne obracanie, kompresowanie, usuwanie i wysyłanie plików dziennika.

Domyślnie niektóre z głównych plików logów w każdym z komponentów apigee są skonfigurowane z domyślnym mechanizmem rotacji. Na przykład w komponencie Procesor wiadomości domyślny mechanizm rotacji jest skonfigurowany w przypadku tych plików:

  • /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

Inne pliki dziennika w komponentach apigee nie są jednak skonfigurowane z użyciem domyślnej rotacji. Na przykład rotacja logów nie jest domyślnie skonfigurowana w pliku apigee komponentu Message Processor (Procesor wiadomości) edge-message-processor.log.

Rotację logów można włączyć za pomocą różnych narzędzi lub frameworków, takich jak logrotate, logback czy log4j. W tej sekcji opisano konfigurowanie rotacji logów w pliku /opt/apigee/var/log/edge-message-processor/edge-message-processor.log za pomocą parametrów logrotate i crontab.

Włączanie rotacji dzienników edge-message-processor.log na procesorach wiadomości

Z tej sekcji dowiesz się, jak włączyć rotację logów w przypadku logów /opt/apigee/var/log/edge-message- processor/edge-message-processor.log na procesorach wiadomości Edge.

Aby włączyć rotację logów w pliku edge-message-processor.log:

  1. Otwórz plik /opt/apigee/edge-message-processor/logrotate/logrotate.conf w edytorze na maszynie Message Processor. Jeśli plik nie istnieje, utwórz go. Na przykład: 
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
  2. Dodaj do pliku fragment podobny do tego: 
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
    missingok
    copytruncate
    rotate 5
    size 10M
    compress
    delaycompress
    notifempty
    nocreate
    sharedscripts
    }
  3. Zapisz zmiany.
  4. Otwórz apigee użytkownika crontab za pomocą tego polecenia: 
    sudo crontab -u apigee -e
  5. Dodaj do konta użytkownika apigee (crontab) następujące zadanie cron : 
    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. Zapisz plik crontab i monitoruj rotację dzienników podczas następnego uruchomienia zadania cron.

Sprawdzanie rotacji logów edge-message-processor.log na Message Processor

  1. Po uruchomieniu zaplanowanego zadania cron plik dziennika zostanie zastąpiony. W tym przykładzie zadanie cron jest zaplanowane do wykonywania codziennie o godzinie 00:00 w celu rotacji pliku edge-message- processor.log.

  2. Przejdź do katalogu /opt/apigee/var/log/edge-message-processor/ i sprawdź, czy plik edge-message-processor.log jest obrócony.

    Przykładowa lista plików dziennika

    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

    Powyższe dane wyjściowe wskazują, że pliki edge-message-processor.log zostały obrócone i zapisane jako plik GZ.

  3. Jeśli nie widzisz, że pliki edge-message-processor.log są rotowane, sprawdź, czy wszystkie czynności zostały wykonane prawidłowo zgodnie z artykułem Włączanie rotacji logów edge-message-processor.log w usługach Message Processor. Jeśli pominięto jakiś krok, powtórz wszystkie czynności.
  4. Jeśli nadal nie możesz uruchomić rotacji dzienników, skontaktuj się z zespołem pomocy Apigee Edge.