実行ログ
パイプラインサービスの出力するログにはいくつかの種類があります。
システムログ
パイプラインサービスが実行中に出力するログです。
システムログの出力されるフォルダとファイル名
パイプラインサービスのシステムログはすべて [INSTALL_DIR]/pipeline/log に出力されます。
| pipeline.log | パイプラインサービス全体のログです。主にパイプライン起動時、停止時のログが出力されます。ライセンスエラーなどのログなどが出力されます。通常、それほどサイズが大きくなることはありません。 |
| pipeline-access.log | パイプラインサービスに内蔵されたHTTPリスナーのアクセスログです。コーディネーターのアクセスログとセンサー用のHTTPリスナーのログが出力されます。 コーディネーターのアクセスログも出力されるので、開発時にはファイルが大きくなる可能性があります。 運用時にはHTTPリスナーを使ったセンサーがなければほとんど増えることはありません。 |
| pipeline-client.log | コーディネーターにアクセスしたときに出力されるログです。コーディネーター内部のサーブレットが動いた時やコンパイルなどが実行された場合に出力されます。 開発時には頻繁に出力されますが、通常の運用時にはそれほどサイズが大きくなることはありません。 |
| pipeline-compile.log | パイプラインをコンパイルした時のログです。パイプラインが開始される時や、コーディネーターから保存したときに出力されます。 |
| pipeline-console.log | PIPELINE-Serviceの中でプロセスが標準出力や標準エラー出力に出力したものが出力されます。 通常はほとんど出力されません。 |
| pipeline-engine.log | パイプラインの処理エンジンのログです。起動時に登録されたアクションなどの情報が出力されたり、処理エンジン全体のエラーが出力されたりします。 通常はそれほどサイズが大きくなることはありません。 |
| pipeline-ftp.log | パイプラインサービスに内蔵されたFTPサービスのログです。センサー用のFTPサービスを利用している場合にアップロードされた時などのログが出力されます。 |
| pipeline-queue.log | パイプラインサービス内部で使用しているActiveMQのログです。 |
| pipeline-shceduler.log | パイプラインサービスのスケジュール型アクションで利用しているスケジューラーのログが出力されます。スケジュール型アクションをセンサーに持つパイプラインが開始、停止された時や、アクションが実行されたときに出力されます。 |
システムログのローテーション
システムログの各ログファイルは、次のように出力およびファイルのローテーションを行います。
ログは常に同じファイル名で出力されていきます（例：pipeline.log）。従って、外部のログ監視システムなどからは、単一のログファイルのみを監視しておくといった使い方が可能になります。日付が変わると、それまで開いていたログファイルを閉じてファイル名を前日の日付を付与したものにリネームします。その後、また同じ名前のファイルを作成して同様に追記を開始します。前日以前の日付の入ったファイルが更新されることはありません。
パイプラインログ
パイプラインログは各パイプラインが実行されたときに出力するログで、パイプライン単位に出力されます。
パイプラインログの出力されるフォルダとファイル名
パイプラインログはすべて [INSTALL_DIR]/pipeline/log/application/pipeline-<pipeline_id>-LOG.logというファイル名で出力されます。<pipeline_id>にはパイプラインIDが入ります。
パイプラインログにはパイプラインの各ステージが実行されたときに出力されるメッセージや、各アクションで発生したエラーなどが出力されます。パイプラインログに出力されるログのサイズはパイプラインが実行される頻度や使用しているアクションにより異なります。
パイプラインログのローテーション
パイプラインログの各ログファイルは、次のように出力およびファイルのローテーションを行います。
ログは常に同じファイル名で出力されていきます（例：pipeline-pl_00001-LOG.log）。従って、外部のログ監視システムなどからは、単一のログファイルのみを監視しておくといった使い方が可能になります。日付が変わると、それまで開いていたログファイルを閉じてファイル名を前日の日付を付与したものにリネームします。その後、また同じ名前のファイルを作成して同様に追記を開始します。前日以前の日付の入ったファイルが更新されることはありません。
ログのサイズとメンテナンス
システムログやパイプラインログの出力サイズは上記のように運用形態やパイプラインの内容により変わります。これらの情報をもとに、ハードディスク容量とテスト運用時のログ出力のサイズを比較し、前日以前の日付の入った各種ログファイルをそのままにしておくか、アーカイブを行うか、バックアップして削除をするか、そのまま削除するかといった運用形態を決定します。