内部エラーとアップストリーム/ダウンストリームアプリケーションエラー ​

ソリューション内でエラーの発生元を特定することは、効果的なトラブルシューティングに不可欠です。 問題がWorkato内、中間のミドルウェアレイヤー、またはバックエンドデータベースで発生したかを理解することで、作業を効率化し、迅速な解決を実現できます。

内部エラーと外部エラーを区別することは、トリガーとアクションの両方にとって重要です。 アクションエラーは複雑であるため、通常はより多くの注意が払われます。 ただし、トリガーエラーへの対処も重要です。特に外部システムとやり取りする場合、接続または設定の問題を示している可能性があります。

次のセクションでは、各エラータイプに固有のトラブルシューティング手順を説明します。

内部エラー ​

Workatoのプラットフォーム固有のアクションにおける内部エラーの一般的なシナリオとトラブルシューティング方法については、次のセクションを参照してください。

SQL Collection by Workato ​

SQL Collection by WorkatoはSQLiteを使用します。 SQLiteコードがSQLiteバージョン3.42.0の標準に準拠していることを確認します。

発生したシナリオに基づくトラブルシューティングのヒントについては、該当するタブを参照してください。

パーサーとリーダー（XML/JSON/CSV） ​

パーサーのエラーは通常、期待される形式と一致しないデータ入力が原因で発生します。

パーサーとリーダーをトラブルシューティングするには、次の手順を完了します。

レシピOps ​

レシピOpsアクションは、Workatoレシピのトラブルシューティングとエラー処理の自動化に役立ちます。 エラーを効果的に管理および解決するための主な機能には、次のものがあります。

• エラーの集約

• レシピOpsを使用して、さまざまなジョブとレシピからエラーを収集します。

• レシピの再起動

• 通常はトリガーエラーが原因で中断されたレシピを再起動します。

• アクション再試行スコープ

• On Error blockで再試行を実装し、Monitor block内の特定のアクションを再試行します。

• 完全な再実行

• 元のトリガーデータを使用して、すべてのジョブアクションを繰り返します。

• システムリカバリ

• サーバーのダウンタイムや重大なエラーなど、頻繁なシステム停止時のリカバリ戦略をサポートします。

レシピOpsに関連するエラーは一般的ではありません。 レシピOpsの詳細を確認します。

アップストリーム/ダウンストリームアプリケーションエラー ​

アップストリームおよびダウンストリームアプリケーションエラーは、Workato自体ではなく、Workatoに接続されたアプリケーションから発生します。 これらは、外部システムまたは内部システムに接続する際によく発生します。

一般的なシナリオには、次のものがあります。

• クラウドコネクション

• Salesforce、Netsuite、ServiceNowなどの外部クラウドサービスとのやり取りに関するエラー。

• オンプレミスコネクション

• SAPなどのオンプレミスソリューションを扱う際に発生する問題。

• データベース操作

• データベースとのやり取り時に発生する、コネクションタイムアウト、データの不一致、またはスキーマ変更によるエラー。

• HTTPリクエスト

• 不正なエンドポイント、タイムアウト、ペイロードの形式の問題など、Workato HTTPアクションに関する問題。

• カスタムコネクター

• カスタムコネクターに関連するエラーは、古いAPI、不正な設定、またはサービスのダウンタイムが原因で発生する可能性があります。

• ファイルシステムコネクション

• アクションがSFTPやFTPなどのファイルシステムに関係する場合、権限の問題、不正なファイルパス、またはサーバーのダウンタイムによってエラーが発生する可能性があります。

これらのアプリケーションエラーを処理するには、外部システムを深く理解している必要があります。 Workatoサポートは一般的なガイダンスを提供できますが、特定の外部アプリケーションの専門家に相談することで、問題を迅速に特定して解決できます。

外部クラウドコネクションのトラブルシューティング ​

Workatoで外部クラウドシステムに関連するアクションを管理する場合、エラーの性質と発生元を理解することが重要です。 これらの問題をトラブルシューティングするには、次の手順を完了します。

Workato HTTPアクションのトラブルシューティング ​

WorkatoでHTTP connectorアクションを使用して外部エンドポイントに接続する場合は、潜在的な問題をトラブルシューティングするために次の手順を完了します。

HTTPステータスレスポンスの分類 ​

接続性、IP許可リストへの登録、および受信呼び出しの検証に対処した後、次のタブで説明するステータスコードに従ってエラーを分類します。

オンプレミス接続性のトラブルシューティング ​

オンプレミスの接続性の問題をトラブルシューティングする場合、潜在的な問題に関するInsightsを得るにはログファイルが重要です。

オンプレミスエージェント（OPA）ロガーは、オンプレミスシステムの時刻に従って、毎日の始まりに新しいログファイルを作成します。 さらに、ファイルサイズが20 MBを超えると、新しいログファイルが生成されます。 このサイズ制限により1日に複数のログファイルが作成される場合、区別するために順番に番号が付けられます。 例:

• /agent-2019-11-01.0.log: これはその日に作成された最初のファイルです。 その日のログが20MBを超えない場合、これが唯一のファイルです。
• /agent-2019-11-01.1.log: これは、その日に追加のログが必要な場合に作成される次のログファイルです。 その特定の日にさらにファイルが必要な場合、ファイル名の最後の番号が増加します。

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の使用ガイドを参照してください。

IP許可リスト登録 ​

外部アプリケーションで必要な場合は、必要なIP許可リスト登録手順を完了していることを確認します。