Workato Logging Service ​

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

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

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

ログエントリデータの例

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

ループが繰り返されるステップについて、ループの完全な可視性がないワークスペースでは、ジョブレポートには最後に実行されたステップのみが表示されます。ステップの繰り返しを参照してください。ロギングを使用すると、繰り返しステップの各反復が可視化されるため、ループ内にネストされたステップのトラブルシューティングやデバッグを行うことができます。

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

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

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

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

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

ログエントリの表示 ​

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

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

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

ログ列 ​

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

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

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

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

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

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

ログエントリの更新 ​

WorkatoのLogging Serviceには、手動でログエントリを更新して自動更新を待たずに済むようにするRefreshボタンが含まれています。この機能により待ち時間が短縮され、最新のログ情報に素早くアクセスできます。

Refreshボタン

トリガーエラーのログ記録 ​

トリガーエラーが発生する理由を理解するために、エラーログを表示できます。エラーログにより、レシピトリガーのトラブルシューティングを効率的に行えます。トリガーエラーは、polling、webhook、またはtrigger filtersに関する問題など、さまざまな理由で発生する可能性があります。これらのエラーを特定して解決することは、レシピの機能を維持するために重要です。

エラーのフィルター

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

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

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

ポーリングエラー ​

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

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

次の例は、タイムアウトが原因のポーリングエラーに対するログデータを表示したものです。

ポーリングエラー

Webhookエラー ​

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

Webhookエラーには次の種類があります:

• Webhook Gatewayエラー

• これらのエラーはゲートウェイレベルで発生し、一般的にレート制限、検証の失敗、無効なリクエストなどが原因です。この種のエラーにより、Webhookイベントは処理段階に到達できません。

• Webhook Processingエラー

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

どちらの種類のWebhookエラーも自動的にログに記録され、同様の方法で処理されます。

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

Webhookエラー

詳細なトラブルシューティング情報については、WebhooksコネクターのDebug common errorsページを参照してください。

ログエントリの詳細 ​

Logger by Workatoによるログエントリの追加 ​

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

OPAバージョン23.0以降を使用し、Send to Workato logs設定を有効にしている場合は、ログをLogging Serviceに送信できます。この設定を有効にするには:

Workato Logging ServiceのOPAログ

ログの暗号化 ​

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

WorkatoのEncryption Key Managementでその仕組みを確認してください。

ログクォータ ​

各ログエントリには、最大保持期間30日または100万エントリが設定されています。このクォータは、ワークスペース内の他のコンポーネントに対するcustomized retention periodsとは独立しています。この保持期間を超えてログを維持するには、stream logs to an external destinationできます。

各ワークスペースまたはEnvironment内で、ログタイプソースごとの保持クォータはログエントリ1,000,000件です。この保持クォータにより、Logging Serviceの過負荷が防止され、古いログが新しいログを押し出さないようにします。このしきい値に達すると、そのログタイプソースに対する最も古いエントリが削除され、新しいログのための空きが確保されます。

サイズクォータ ​

各ログエントリのデータ列の最大サイズは10 KBです。クォータを超過すると、内容は切り詰められます。

文字エンコーディング ​

ログエントリにはUTF-8文字エンコーディングが使用され、国際的な文字がサポートされています（例: "こんにちは世界!"）。