edge-router.log のログ ローテーションを有効にする

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。

ログ ローテーションは、大量のログファイルを生成するシステムの管理を容易にすることを目的としたメカニズムです。ログファイルの自動ローテーション、圧縮、削除、送信を行えます。

Edge for Private Cloud では、各 Apigee コンポーネントの主要なログファイルの一部が、デフォルトのローテーション メカニズムを使用して構成されます。

たとえば、Router コンポーネントでは、次のファイルがデフォルトの回転メカニズムを使用して構成されます。

  • /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 コンポーネントの Router edge-router.log ファイルは、ログ ローテーションがデフォルトで構成されていないファイルの一つです。

ログ ローテーションは、logrotatelogbacklog4j などのさまざまなユーティリティやフレームワークを使用して有効にできます。このドキュメントでは、logrotatecrontab を使用して /opt/apigee/var/log/edge-router/edge-router.log ファイルのログ ローテーションを構成する方法について説明します。

始める前に

Router で edge-router.log のログ ローテーションを有効にする

このセクションでは、Edge Router で /opt/apigee/var/log/edge-router/edge-router.log ログのログ ローテーションを有効にする方法について説明します。

edge-router.log ファイルのログ ローテーションを有効にする手順は以下のとおりです。

  1. Router マシン上の /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. Apigee ユーザーの crontab に、次の cron ジョブを追加します。
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
    
  6. crontab を保存し、cron ジョブの次回実行時にログのローテーションをモニタリングします。

Router で 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 が表示されない場合は、 Router で edge-router.log のログ ローテーションを有効にするに記載されているすべての手順が正しく適用されていることを確認してください。どのステップも見逃した場合は、すべてのステップを正しく繰り返します。
  4. それでもログのローテーションができない場合は、Apigee Edge サポートにお問い合わせください。