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

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

記錄輪替 (旋轉和不使用多個記錄檔的過程)， 簡化系統管理 會產生大量記錄檔使用記錄檔旋轉功能，即可自動旋轉、壓縮 移除和郵寄記錄檔。

在 Edge for Private Cloud 中，各個apigee的主要記錄檔 元件已設定預設的旋轉機制。舉例來說 訊息處理器元件，下列檔案採用預設旋轉角度設定 與邏輯機制互動

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

其他 edge-* 元件 (名稱) 已有類似的檔案 開頭是 edge-)，例如 edge-management-server edge-router、edge-postgres-server和edge-qpid-server。

每個 edge-* 元件都會產生一個額外的記錄檔，並將重新導向 顯示個別元件控制台的輸出內容就「訊息處理者」元件來說 這個檔案的名稱為 /opt/apigee/var/log/edge-message-processor/edge-message-processor.log。 其他 edge-* 元件會產生類似的檔案。這些檔案的這並非旋轉工作的方式 回呼程式庫，而是使用 logrotate 和 crontab。

事前準備

啟用記錄輪替

本節適用於 Private Cloud 4.50.00 和 4.51.00 版。

記錄輪替機制是方便管理所產生系統的機制 大量記錄檔它能自動旋轉、壓縮、移除和郵寄 記錄檔

根據預設，每個 apigee 元件上的部分主要記錄檔都會採用 預設輪播機制 例如，在「訊息處理者」元件中，下列檔案已設定為預設值 輪替機制

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

不過，apigee 元件中的其他記錄檔並不是使用預設旋轉角度設定。 舉例來說，apigee 元件訊息預設不會設定記錄旋轉功能 處理器檔案 edge-message-processor.log。

您可使用其他公用程式/架構啟用記錄檔輪替功能，例如 logrotate、 logback 或 log4j。本節說明如何設定記錄檔 旋轉 /opt/apigee/var/log/edge-message-processor/edge-message-processor.log 檔案。logrotate和 crontab。

為訊息處理器啟用 Edge-message-processor.log 的記錄輪替功能

本節說明如何為邊緣訊息處理器記錄啟用記錄輪替。/opt/apigee/var/log/edge-message- processor/edge-message-processor.log

下列步驟說明如何啟用記錄檔輪替功能 edge-message-processor.log 檔案：

  1. 開啟 /opt/apigee/edge-message-processor/logrotate/logrotate.conf 檔案 「訊息處理器」機器上。如果檔案不存在，請建立一個。 例如：
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
  2. 在檔案中加入類似如下的程式碼片段： 
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.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 -s /opt/apigee/var/run/edge-message-processor/logrotate.status -f /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    敬上
  6. 儲存 crontab，並在下次執行 Cron 工作時監控記錄檔輪替。

驗證訊息處理器的 Edge-message-processor.log 記錄旋轉資訊

  1. 排定的 Cron 工作執行後，記錄檔就會輪替。以上範例 Cron 工作已排定於每天凌晨 00:00 執行，輪替 edge-message- processor.log 檔案。

  2. 前往 /opt/apigee/var/log/edge-message-processor/ 目錄，然後 驗證 edge-message-processor.log 檔案是否已旋轉。

    記錄檔清單範例

    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

    上述輸出內容表示 edge-message-processor.log 檔案會自動輪替並儲存為 GZ 檔案。

  3. 如果 edge-message-processor.log 檔案並未旋轉， 請確認您已遵循 正確為訊息處理器啟用 Edge-message-processor.log 的記錄旋轉功能。 如果您漏掉任何步驟，請再次正確重複所有步驟。
  4. 如果仍無法執行記錄檔輪替，請與 Apigee Edge 支援團隊聯絡。