# Workato ロギングサービス

動画ガイド:Workatoログサービスの使用方法

ログは、テスト、トラブルシューティング、デバッグにおいて重要なツールです。Workatoログサービスは、ログエントリを収集するための集中ストレージと、ログエントリを検索するための簡単な方法を提供します。

ログエントリデータ ログエントリデータの例

Workatoログサービスが見つからない場合

Workatoログサービスは追加の機能です。これにはログページとWorkatoによるロガーへのアクセスが含まれます。ワークスペースでこの機能が有効になっていることを確認するには、Workato CSMに確認してください。

また、役割にはWorkatoログサービス特権が必要です。

# Workatoログサービスの利点

動画ガイド:ループ内のトラブルシューティング手順

Workatoログは、レシピからのログエントリの集中ストレージです。

ループ内で繰り返されるステップは、ジョブレポートでは完全に表示されません。最後の実行のみが表示されます。ログを使用すると、ループ内にネストされたステップのトラブルシューティングとデバッグが容易になります。

顧客アカウントなどの一部のビジネスオブジェクトは、複数のワークフローに統合されています。ログを使用すると、レシピが特定の顧客(たとえば、顧客アカウントACME Corp)とやり取りするたびに追跡できます。ワークアトログサービスでは、検索語句やレシピIDでログをフィルタリングすることができます。ログエントリの検索方法の詳細をご覧ください。

Logger by Workatoを使用すると、ログエントリを簡単に追加できます。ログレベルを使用して、ログテーブルからログをフィルタリングできます。たとえば、ERRORログレベルを使用してエラーのあるログを検索できます。

# ログページの場所

必要な権限

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

ツール > ログに移動します。

Workatoログサービス Workatoログサービス

プロダクト内で開く

データセンターは独立しているため、次のリンクを使用してリージョンごとにWorkatoログサービスを開くことができます。

# ログエントリのクエリと検索

動画ガイド:ログ内の検索方法

各ログエントリには、作成日時、レシピとジョブによって作成されたことに関するメタデータが含まれています。フィルタを使用して、最も興味のあるログを検索することができます。また、ログデータの内容に基づいてログエントリを検索することもできます。

ログの検索 ログの検索

ログフィールド 説明
時間 このログエントリが作成された時間。ワークスペースのタイムゾーンで表示されます。
ソース ログエントリの元の場所。

注意: 現在、ログエントリはLogger by Workatoによってのみ作成できるため、このフィールドはフィルタとして使用できません。
ログレベル 可能なログレベルはINFOWARNERRORです。
データ Logger by Workatoからのログメッセージ
レシピID レシピID。
ジョブID ジョブID。
ステップ番号 このログを作成したレシピ内のアクションのステップ番号。
コネクタ ログエントリを作成したコネクタ。

注意: 現在、ログエントリはLogger by Workatoによってのみ作成できるため、このフィールドはフィルタとして使用できません。
アクション ログエントリを作成したアクション。

注意: 現在、ログエントリはLogger by Workatoによってのみ作成できるため、このフィールドはフィルタとして使用できません。

# ログエントリの詳細

ログエントリをクリックしてログデータを展開します。これにより、完全なログメッセージが表示されます。

ログメッセージ内でより詳細な検索を実行できます。

ログエントリデータ ログエントリデータ

# Logger by Workatoを使用してログエントリを追加する

1

アプリの選択で、選択したアプリを選びます。

2

WorkatoのLoggerを使用してください。

3

ログメッセージの内容をカスタマイズしてください。

4

Workato Logsに送信を切り替え、ログレベルを選択してください。可能なログレベルはINFOWARNERRORです。

これにより、テストジョブを含むすべてのジョブにログエントリが作成されます。

Logger by Workato Logger by Workato

ログを使用してリアルタイムでレシピジョブをモニタリングする

ログページは、各ログステップが完了するたびに更新されます。つまり、レシピジョブ全体の処理が完了するのを待つ必要はありません。これにより、長時間実行されるレシピのリアルタイムの進行状況を追跡することができます。

# ログの暗号化

ログは、ワークスペースと環境ごとに固有の暗号化キーを使用して、静止状態および転送中に暗号化されます(該当する場合)。

Workatoの暗号化キー管理でその動作を確認してください。

# ログの制限

各ログエントリは最大30日間保持され、ワークスペース内の他のコンポーネントのカスタマイズされた保持期間とは独立しています。

各ワークスペースと環境(該当する場合)は最大1,000,000のログエントリを保存できます。制限を超える場合、Workatoは新しいログエントリを追加し続けますが、最も古いエントリから削除されます。

# シナリオ1:ログエントリの制限超過

次のシナリオを考えてみましょう。 1週間以内に、環境で次のアクティビティが発生しました:

  • 開発環境で1,250,000のログエントリが作成されました。
  • テスト環境で1,000,000のログエントリが作成されました。
  • 本番環境で500,000のログエントリが作成されました。

ログページには次のように表示されます:

  • 開発環境では、最新の1,000,000のログエントリのみが表示されます。
  • テスト環境では、すべての1,000,000のログエントリが表示されます。
  • 本番環境では、すべての500,000のログエントリが表示されます。

# シナリオ2:ログの保持期間の超過

次のシナリオを考えてみましょう。 ワークスペースで2023年1月1日に10,000のログエントリが作成され、2023年2月1日に18,000のログエントリが作成されました。

2023年2月15日にログページを表示すると、2023年2月1日に作成された18,000のログエントリのみが表示されます。2023年1月1日に作成された10,000のログエントリは、最大保持期間30日のため削除されています。

# サイズ制限

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

# 文字エンコーディング

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


Last updated: 2024/2/13 16:59:53