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" } }
このレスポンスは標準フォーマットに従っており、正常に完了した場合は結果に次のフィールドが含まれます。
Field | 型 | 説明 |
---|---|---|
message | 文字列 | 正常に完了した場合、次のメッセージが含まれています。The log file was closed and reopened. |
考えられるエラー
- いずれかの汎用エラータイプ。