logrotate

[ソース]

logrotateコマンドは、ログファイルを閉じて再度開きます。これは、Linuxファイルシステムでのログローテーションを促進することを目的としています。

通常、Linuxシステムには、logrotateプログラムがプリインストールされていますが、このコマンドとは異なります。アプリケーション固有のログローテーションスクリプトは、/etc/logrotate.dに配置されています。

次のスクリプトは、/etc/logrotate.d/rippledとして作成できるサンプルです。

/var/log/rippled/*.log {
  daily
  minsize 200M
  rotate 7
  nocreate
  missingok
  notifempty
  compress
  compresscmd /usr/bin/nice
  compressoptions -n19 ionice -c3 gzip
  compressext .gz
  postrotate
    /opt/ripple/bin/rippled --conf /opt/ripple/etc/rippled.cfg logrotate
  endscript
}

保持するログの量に応じて、minsizeやrotateなどのパラメーターを構成できます。rippled.cfgファイルのlog_level設定を使用して、サーバのログの詳細度を設定します。このサンプルスクリプトは標準のlog_levelに基づいており、約2週間分のログを圧縮形式で保存します。

rippled 1.3以降、スクリプト/etc/logrotate.d/rippledは、DEBおよびRPMパッケージによって自動的にインストールされます。この設定は、必要に応じて変更できます。パッケージのアップグレード時に変更内容が上書きされることはありません。

注記: システムのlogrotateスクリプトは、アプリケーションごとに1つしか持てません。同じディレクトリを処理するログローテーションが他にないことを確認してください。

logrotateメソッドは、権限のないユーザは実行できない管理メソッドです。

リクエストのフォーマット

リクエストのフォーマットの例:

{
    "id": "lr1",
    "command": "logrotate"
}

リクエストにはパラメーターが含まれていません。

レスポンスのフォーマット

処理が成功したレスポンスの例:

200 OK

{
   "result" : {
      "message" : "The log file was closed and reopened.",
      "status" : "success"
   }
}

このレスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれます。

考えられるエラー

• いずれかの汎用エラータイプ。