啟用 Edge-router.log 的記錄檔輪替功能

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件

「記錄檔輪替」機制旨在簡化系統產生大量記錄檔的系統。這可讓記錄檔自動輪替、壓縮、移除和郵寄。

在 Private Cloud 的 Edge 中,每個 Apigee 元件的部分主要記錄檔都會採用預設的輪替機制,

舉例來說,在路由器元件中,下列檔案採用預設的旋轉機制:

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

不過,Apigee 元件中有部分記錄檔並未以預設輪替設定。對 Apigee 元件路由器 edge-router.log 檔案而言,該檔案在預設情況下不會設定記錄檔旋轉功能。

您可以使用不同公用程式/架構 (例如 logrotatelogbacklog4j) 來啟用記錄檔輪替功能。本文件說明如何使用 logrotatecrontab 設定 /opt/apigee/var/log/edge-router/edge-router.log 檔案的記錄輪替作業。

事前準備

為路由器啟用 Edge-router.log 的記錄檔輪替功能

本節說明如何在邊緣路由器上為 /opt/apigee/var/log/edge-router/edge-router.log 記錄檔啟用記錄檔輪替功能。

下列步驟說明如何為 edge-router.log 檔案啟用記錄輪替功能。

  1. 在編輯器中開啟路由器的 /opt/apigee/edge-router/logrotate/logrotate.conf 檔案。如果檔案不存在,請建立檔案。例如:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. 新增類似下列程式碼片段的程式碼片段:
    /opt/apigee/var/log/edge-router/edge-router.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
    
  3. 儲存變更。
  4. 使用下列指令開啟 Apigee 使用者的 crontab
    sudo crontab -u apigee -e
    
  5. 將下列 Cron 工作新增至 Apigee 使用者的 crontab
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
    
  6. 儲存 crontab,並監控下一個 Cron 工作時的記錄檔輪替。

正在驗證路由器的 Edge-router.log 輪替記錄

  1. 執行排定的 Cron 工作後,系統會輪替記錄檔。在上例中,Cron 工作已排定在每天上午 00:00 執行,以輪替 edge-router.log 檔案。
  2. 前往 /opt/apigee/var/log/edge-router/ 目錄,並確認 edge-router.log 檔案已輪替。

    記錄檔範例清單:

    ls -ltrh | grep 'edge-router'
    
    -rw-r--r--. 1 apigee apigee 6.0K Feb 16 00:00 edge-router.log.1.gz
    -rw-r--r--. 1 apigee apigee 3.0K Feb 16 01:23 edge-router.log
    

    上述輸出內容顯示 edge-router.log 檔案已輪替並儲存為 GZ 檔案。

  3. 如果未輪替 edge-router.log 檔案,請確認是否已按照 啟用路由器的 Edge-router.log 記錄檔的記錄功能中的所有步驟操作。如果您錯過任何步驟,請再次重複所有步驟。
  4. 如果仍無法讓記錄檔輪替正常運作,請與 Apigee Edge 支援團隊聯絡。