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

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Rotacja dzienników – proces rotacji wielu plików dziennika – upraszcza administrowanie systemami, które generują dużą liczbę plików dziennika. Rotacja dzienników umożliwia automatyczną rotację, kompresję, usuwanie i wysyłanie plików dziennika.

W Edge for Private Cloud niektóre główne pliki dziennika w każdym apigee komponencie są skonfigurowane z domyślnym mechanizmem rotacji. Na przykład w komponencie Message Processor te pliki są skonfigurowane z domyślnym mechanizmem rotacji za pomocą logback:

  • /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 istnieją 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 z konsoli odpowiedniego komponentu. W przypadku komponentu Message Processor, ten plik nazywa się /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ą logrotate i crontab.

Zanim zaczniesz

Włączanie rotacji dzienników

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

Rotacja dzienników to mechanizm, który ułatwia administrowanie systemami generującymi dużą liczbę plików dziennika. Umożliwia automatyczną rotację, kompresję, usuwanie i wysyłanie plików dziennika.

Domyślnie niektóre główne pliki dziennika w każdym komponencie apigee są skonfigurowane z domyślnym mechanizmem rotacji. Na przykład w komponencie procesora komunikatów te pliki są skonfigurowane z domyślnym mechanizmem rotacji:

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

Jednak inne pliki dziennika w komponentach apigee nie są skonfigurowane z domyślną rotacją. Na przykład rotacja logów nie jest domyślnie skonfigurowana w pliku edge-message-processor.log komponentu apigee Message Processor.

Rotację dzienników można włączyć za pomocą różnych narzędzi lub platform, takich jak logrotate, logback, czy log4j. W tej sekcji dowiesz się, jak skonfigurować rotację logów w przypadku pliku /opt/apigee/var/log/edge-message-processor/edge-message-processor.log za pomocą logrotate i crontab.

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

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

Poniższe kroki opisują, jak włączyć rotację dzienników w przypadku pliku edge-message-processor.log file:

  1. Otwórz plik /opt/apigee/edge-message-processor/logrotate/logrotate.conf na maszynie procesora komunikatów w edytorze. 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 kodu 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 crontab użytkownika apigee za pomocą tego polecenia: 
    sudo crontab -u apigee -e
  5. Dodaj to zadanie cron do crontab użytkownika apigee : 
    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 crontab i monitoruj rotację dzienników podczas następnego uruchomienia zadania cron.

Weryfikowanie rotacji dzienników dla pliku edge-message-processor.log w procesorze komunikatów

  1. Po uruchomieniu zaplanowanego zadania cron plik dziennika zostanie zrotowany. W powyższym przykładzie, zadanie cron jest zaplanowane na uruchamianie codziennie o północy, aby zrotować plik edge-message- processor.log.

  2. Otwórz katalog /opt/apigee/var/log/edge-message-processor/ i sprawdź, czy plik edge-message-processor.log został zrotowany.

    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 są rotowane i zapisywane jako pliki GZ.

  3. Jeśli nie widzisz, że pliki edge-message-processor.log są rotowane, sprawdź, czy prawidłowo wykonano wszystkie czynności opisane w sekcji Włączanie rotacji dzienników w przypadku pliku edge-message-processor.log w procesorach komunikatów prawidłowo. Jeśli pominiesz jakiś krok, powtórz wszystkie czynności.
  4. Jeśli nadal nie możesz włączyć rotacji dzienników, skontaktuj się z zespołem pomocy Apigee Edge.