障害発生時、ログが残っておらず調査ができなかった…という経験はありませんか？残念ながら、ジョブの実行量が多い環境では往々にして発生しうる問題です。特にエラーが多発すると、ログがあっという間にローテーションしてしまうこともあります。

本記事では、JP1 V12.5で実装された「エージェントのログ強化」についてご紹介します。

今までのログ調査

ジョブ実行は、マネージャーがエージェントに実行命令を行うことで開始され、エージェントが実行結果を返すことで終了します。この時、マネージャーとエージェントの間の通信に問題が発生すると「マネージャーからの実行命令を受け取れない」「実行結果をエージェントからマネージャーへ返すことができない」などのエラーにつながります。

ジョブ情報の管理はマネージャーで行うため、ジョブの実行結果はマネージャー側に残ります。しかし、上記のような問題が発生すると、マネージャーが情報を受け取れずジョブの実行結果を確認することができません。
この場合、ジョブが正常終了したか否かは、実行ファイル側のログなどから確認するしかありません。

また、「処理がどこで止まったか※」を調査する場合、マネージャーとエージェントのログの両方が残っていなければなりません。

※JP1/AJS3の処理の範囲です。実行ファイル内の処理内容をJP1から調査することはできません。

対象ホストで実行されるジョブ数自体は少なくても、マネージャーが管理する総ジョブ数が多い場合、マネージャー側のログがすぐにローテーションしてしまい、事象発生時のログを確認することができなかった、というパターンも残念ながら少なくありません。

エージェントのログが強化されてできるようになった2つのポイント

エージェントのログが強化されてできるようになった、大きなポイントを2点ご紹介します。

1.マネージャーに残らないエラーログがエージェント側で確認できる

JP1 V12.5から、エージェント側でジョブの実行結果を確認できるようになりました。
例えば、以下のような情報がエージェント側に保存されます。

上記ログでは、ルートジョブネット1配下のPCジョブAが終了コード0で正常終了したこと、またPCジョブAで実行している実行ファイルがC:\temp\job.batであることなど、多くの情報が確認できます。

つまり、マネージャー側でログが取得できなくても、エージェント側のログが残っていれば、事象発生時の状況確認することができます。

また、ログが残っている範囲であれば、保存世代数を超えてしまった実行結果や、実行登録解除したジョブの実行結果も確認できます。

2.マネージャ側のログがローテーションしても障害調査ができる

障害調査の観点においても、エージェント側のログ強化にはメリットがあります。

既述のとおり、基本的にジョブの情報はマネージャーが保持しており、エージェント側のログはあくまでその補助的な立ち位置でした。例えば、マネージャーは各ジョブをジョブ番号で管理していますが、エージェントのログではジョブ番号のみが出力されており、対象のジョブ名などを確認することはできませんでした。

ログ強化によりエージェント側のログにもジョブ名などの詳細情報が出力されるのでマネージャー側のログがローテーションしてしまっても調査を行えるようになっています

まとめ

エージェントのログ強化はJP1 V12.5からの新機能ですが、マネージャー側のバージョンは問いません。エージェントのみバージョンアップしてセットアップすればすぐにご利用いただけます。また、新規でJP1 V12.5をインストールすれば、本機能はデフォルトで有効になっているため、ぜひご活用ください。

JP1ブログをご覧いただいているみなさまへご案内

いつもJP1サポート技術者ブログをご覧いただきありがとうございます。

本ブログの執筆を担当しているアシストJP1サポートセンターは、「JP1認定技術者」の資格を持つサポート技術者の対応が支持され、お客様満足度は10年連続90%以上を維持しています。

紹介サイトでは、サポートセンターが誇る3つの特徴とJP1の最新情報満載の提供サービスを、お客様の声とともにご紹介しています。是非ご覧ください。

また、アシストとJP1保守契約を締結されている方は、Webサポートセンター「AWSC-2」をご利用いただけます。本ブログサイトではご紹介しきれない2,000件以上のFAQを公開していますので、是非ご利用ください。詳細は、下記リンクよりご確認ください。