Are you an LLM? You can read better optimized documentation at /ja/recipes/design-time-errors/opa-errors.md for this page in Markdown format
オンプレミスエージェント（OPA）エラーのトラブルシューティング
このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。 Workatoオンプレミスエージェント（OPA）に関する一般的な問題のトラブルシューティングには、このガイドを使用してください。これらのガイドでは、セットアップ、アップグレード、ランタイム動作、および拡張機能について説明します。
ログの確認
OPAログ内のエラーを見つけて調査するには、次のセクションを参照してください。
トラブルシューティングする問題に基づいてガイドを選択してください。
OPAログの生成と保持
OPAログを使用して、実行中のエージェントの動作とシステムの問題を特定できます。 OPAは、オンプレミスシステム時刻に基づいて毎日新しいログファイルを生成します。ログファイルが1日以内に20 MBを超えると、新しいログファイルが作成され、連番が付けられます。たとえば、/agent-2019-11-01.0.logがその日の最初のログである場合、同じ日の追加ログは/agent-2019-11-01.1.logおよび/agent-2019-11-01.2.logになります。 OPAは、最新の60個のログファイルまたは最大20 GBのログを保持します。
OPAログの場所
OPAの問題をトラブルシューティングするには、ログファイルの場所を特定する必要があります。ご使用のオペレーティングシステムに応じて、WindowsまたはLinux向けの次の手順を実行してください。
Windowsサービスとして動作するオンプレミスエージェントの場合、ログファイルはデフォルトで%SYSTEMROOT%\System32\LogFiles\Workatoに保存されます。このファイルには手動で移動することも、スタートメニューのすべてのアプリ＞Workatoにあるショートカットを使用することもできます。
ログの保存場所を変更するには、次の手順を実行します。
3
設定するエージェントのService Wrapper Configuration（サービスラッパーの設定）アプリを開きます。
5
Log pathフィールドに新しいログの保存場所を入力します。このフィールドでは、Windowsサービスラッパーのライフサイクルログ（Agent.<date>.log）、標準出力と標準エラー出力のキャプチャファイル（<service-name>-stdout.<date>.logおよび<service-name>-stderr.<date>.log）、サービスのPIDファイル（workato.pid）の保存先を指定します。
7
Arguments（引数）フィールドに移動し、--logs=引数を更新して、新しいログの保存先を指定します。この引数は、OPAのアプリケーションログ（agent.log）を設定します。
OPAログの内容
OPAログに含まれる詳細のレベルは、エージェント構成によって異なります。詳細については、Workatoのログレベルセクションを参照してください。
ログファイルは、systemdを通じてLinuxサービスとして動作するオンプレミスエージェントについて、デフォルトで/var/log/messagesに保存されます。このファイルには他のLinuxサービスのログも含まれるため、OPA固有のログにアクセスするにはjournalctlコマンドを使用する必要があります。
shelljournalctl -u [name of the OPA service].service
-uスイッチは、それらを作成したサービスに基づいて返されるログをフィルタリングします。 [name of the OPA service]を、インストール時にOPAに設定した名前に置き換えます。
次のコマンドを使用して、ログ検索をさらに絞り込むことができます:
> [output-file]: journalctlの結果をファイルにエクスポートします。--since: 生成されるログを特定の日時より後のものに制限します。--until: 生成されるログを特定の日時より前のものに制限します。
例:
shelljournalctl -u workato.service --since "2020-07-26 23:15:00" --until "2020-08-5 23:20:00" > OPALogs.txt
journalctlに関する追加情報については、Logglyのjournalctlの使用ガイドを参照してください。
OPAログの内容
OPAログに含まれる詳細のレベルは、エージェント構成によって異なります。詳細については、Workatoのログレベルセクションを参照してください。
ジョブ固有のトラブルシューティング
ジョブIDを使用してOPAログを検索し、すべてのステージにわたってジョブ実行を追跡します。これにより、1つのジョブ内でOPA固有の操作を分離できます。例：j-AHd9XdsW-JppW。
ジョブを見つける