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

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

記錄輪替機制可讓您輕鬆管理產生大量記錄檔的系統。可讓您自動輪替、壓縮、移除及郵寄記錄檔。

在 Edge for Private Cloud 中,各個 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 工作執行後,記錄檔就會輪替。在上述範例中,已排定在每天上午 00:00 執行 Cron 工作來輪替 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 支援團隊聯絡。