Workato Logging Service ​

ロギングは、テスト、トラブルシューティング、デバッグに不可欠なツールです。 Workatoロギングサービスは、ログエントリを収集および検索するための一元化されたストレージを提供します。 ロガー by Workatoコネクターを使用して、レシピにログエントリを追加できます。

ログページでは、レシピID、ログデータ内の検索語句などでログをフィルタリングできます。 たとえば、ERRORログレベルを使用して、エラーのあるログを検索できます。 詳細については、ログエントリのフィルタリングを参照してください。

OPAログをWorkatoロギングサービスに送信することもできます。 詳細については、オンプレミスドキュメントを参照してください。

ログエントリデータの例

Workatoロギングサービスのユースケース ​

ループ内で繰り返されるステップは、ジョブレポートから完全には表示されません。そのステップの最後の実行のみが表示されるためです。 ロギングにより、繰り返しステップの各反復を可視化できます。 これにより、ループ内にネストされたステップのトラブルシューティングとデバッグが容易になります。

顧客ワークスペースなど、一部のビジネスオブジェクトは複数のワークフローに統合されています。 ロギングを使用すると、レシピが特定の顧客（たとえば、顧客ワークスペースACME Corp）とやり取りするたびに追跡できます。

ログページへのアクセス方法 ​

ログページを表示するには、次のいずれかが必要です。

• Environment adminロール、またはレガシーAdminコラボレーターロール。
• ログ権限。

ログページを表示するには、次の手順を実行します。

ログエントリの表示 ​

ログページでログエントリを表示するには、次の手順を実行します。

各ログエントリには、ログが作成された日時と方法に関するメタデータを含むフィールドがあります。 この情報はログページの列に表示されます。

ログページに表示されたすべての列

ログ列 ​

ログエントリのフィルタリング ​

ログ列セクションに一覧表示されている各列でログエントリをフィルタリングできます。

複数のフィルターがデフォルトで表示されます。 +（プラス）アイコンをクリックし、表示するフィルターを選択して追加のフィルターを選択します。

ログページに表示するフィルターを選択

例：データでエントリをフィルタリング ​

Dataフィールド内の語句を検索してエントリをフィルタリングするには、次の手順を実行します。

ログエントリの更新 ​

WorkatoのロギングサービスにはRefreshボタンがあり、自動ログ更新を待たずにログエントリを手動で更新できます。 この機能により待ち時間が短縮され、最新のログ情報によりすばやくアクセスできます。

Refreshボタン

トリガーエラーロギング ​

トリガーエラーが発生する理由を理解するために、エラーロギングを表示できます。 エラーロギングを使用すると、レシピのトリガーを効果的にトラブルシューティングできます。 トリガーエラーは、ポーリング、Webhook、トリガーフィルターの問題など、さまざまな理由で発生する可能性があります。 これらのエラーを特定して解決することは、レシピの機能を維持するために重要です。

エラーのフィルター

トリガーフィルターエラー ​

トリガーフィルターエラーは、トリガーフィルターで設定された条件が無効な場合、またはデータが想定される形式と一致しない場合に発生します。

トリガーフィルターエラーは自動的にログに記録されます。 自動ロギングは、トリガーフィルターに関連する問題を効果的に診断およびトラブルシューティングするのに役立ちます。

ポーリングエラー ​

ポーリングエラーは、主に次の3つの条件で発生します。

• ポーリングリクエストが失敗した場合
• ポーリングレスポンスを正常に解析できない場合
• 取得したデータサイズが50 MBのトリガーイベントサイズクォータを超えた場合

次の例は、タイムアウトの問題によるポーリングエラーのログデータを示しています。

ポーリングエラー

Webhookエラー ​

Webhookイベントの受け入れまたは処理に問題がある場合、Webhookエラーが発生します。 これらのエラーは、無効なリクエスト、不正なURL、サーバーの問題など、さまざまな理由で発生する可能性があります。 Webhookベースのトリガーの信頼性を確保するには、Webhookエラーに対処することが不可欠です。

Webhookエラーには2つのタイプがあります。

• Webhook Gatewayエラー

• これらのエラーはゲートウェイレベルで発生し、通常はレート制限、検証失敗、無効なリクエストが原因です。 これらのエラーにより、Webhookイベントが処理ステージに到達できなくなります。

• Webhook Processingエラー

• これらのエラーは、Webhookイベントがゲートウェイに受け入れられた後、その処理中に発生します。 データ解析の問題、処理ロジックの失敗、ダウンストリームサービスのエラーが原因となる場合があります。

どちらのタイプのWebhookエラーも自動的にログに記録され、同様に処理されます。

次の例は、webhookエラーのログデータを示しています:

Webhookエラー

トラブルシューティングの詳細については、Webhooksコネクターの一般的なエラーのデバッグページを参照してください。

ログエントリの詳細 ​

ロガー by Workatoでログエントリを追加 ​

OPAからログエントリを追加 ​

OPAバージョン23.0以降を使用し、Send to Workato logs設定を有効にしている場合、ログをロギングサービスに送信できます。 この設定を有効にするには、次の手順を実行します。

Workato Logging ServiceのOPAログ

ログ暗号化 ​

ログは、各ワークスペースおよびEnvironment（該当する場合）に一意の暗号化キーを使用して、保存時および転送時に暗号化されます。

WorkatoのEncryption Key Managementでどのように機能するかを確認してください。

ログ制限 ​

各ログエントリの最大保持期間は30日または100万エントリです。 この制限は、ワークスペース内の他のコンポーネントのカスタマイズされた保持期間とは独立しています。 この保持期間を超えてログを維持するには、ログを外部宛先にストリーミングできます。

各ワークスペースまたはEnvironmentでは、すべてのログタイプソースに1,000,000件のログエントリの保持制限があります。 この保持制限により、ロギングサービスの過負荷を防ぎ、古いログが新しいログを置き換えないようにします。 このしきい値に達すると、システムはその特定のログタイプソースの最も古いエントリを削除して、受信ログ用のスペースを確保します。

サイズ制限 ​

各ログエントリのデータ列の最大制限は10KBです。 制限を超えると、内容は切り捨てられます。

文字エンコード ​

UTF-8文字エンコードはログエントリで使用され、国際文字をサポートしています（例："こんにちは世界!"）。