オンプレミスエージェント（OPA）エラーのトラブルシューティング ​

Workatoオンプレミスエージェント（OPA）に関する一般的な問題のトラブルシューティングには、このガイドを使用してください。 これらのガイドでは、セットアップ、アップグレード、ランタイム動作、および拡張機能について説明します。

トラブルシューティングする問題に基づいてガイドを選択してください。

• セットアップとインストールの問題：エージェントの起動失敗、権限エラー、ディレクトリ作成の問題、およびプロキシ関連のSSLエラーについて説明します。
• アップグレードと設定の問題：アップグレード後の失敗、サービスアカウントのリセット、およびコネクションプロファイルの変更を修正します。
• ランタイムとパフォーマンスの問題：heap memoryのクラッシュと大きなレスポンスのバッファリングに関する問題を解決します。
• コネクションの問題：Java拡張機能エラー、およびSFTPとKafkaのコネクションエラーを解決します。

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 ​

Windowsサービスとして動作するオンプレミスエージェントの場合、ログファイルはデフォルトで%SYSTEMROOT%\System32\LogFiles\Workatoに保存されます。 このファイルには手動で移動することも、スタートメニューのすべてのアプリ＞Workatoにあるショートカットを使用することもできます。

ログの保存場所を変更するには、次の手順を実行します。

Linux ​

ログファイルは、systemdを通じてLinuxサービスとして動作するオンプレミスエージェントについて、デフォルトで/var/log/messagesに保存されます。 このファイルには他のLinuxサービスのログも含まれるため、OPA固有のログにアクセスするにはjournalctlコマンドを使用する必要があります。

journalctl -u [name of the OPA service].service

-uスイッチは、それらを作成したサービスに基づいて返されるログをフィルタリングします。 [name of the OPA service]を、インストール時にOPAに設定した名前に置き換えます。

次のコマンドを使用して、ログ検索をさらに絞り込むことができます:

• > [output-file]: journalctlの結果をファイルにエクスポートします。
• --since: 生成されるログを特定の日時より後のものに制限します。
• --until: 生成されるログを特定の日時より前のものに制限します。

例:

journalctl -u workato.service --since "2020-07-26 23:15:00" --until "2020-08-5 23:20:00" > OPALogs.txt

journalctlに関する追加情報については、Logglyのjournalctlの使用ガイドを参照してください。

ジョブ固有のトラブルシューティング ​

ジョブIDを使用してOPAログを検索し、すべてのステージにわたってジョブ実行を追跡します。 これにより、1つのジョブ内でOPA固有の操作を分離できます。 例：j-AHd9XdsW-JppW。

ジョブを見つける