実行ログを表示する

Console

1. [Application Integration] で、[ログ] ページに移動します。

   Application Integration のログに移動

2. ナビゲーション メニューの [ログ] をクリックします。または、ナビゲーション メニューの [統合] をクリックし、どの統合のログを表示するかを選択します。[この統合の実行ログを表示する] をクリックします。実行ログのページが表示されます。
3. [Region] リストからリージョンを選択して、統合のリージョン固有の実行ログを表示します。[ログを更新します] をクリックして、現在のログリストを再読み込みすることもできます。

   次の図は、Application Integration の実行ログページの例を示しています。

   

   実行ログ メッセージごとに次の属性が表示されます。

   • Integration name: 統合の名前。
   • Execution ID: 統合の実行ごとに生成される一意の識別子。
   • Status: 統合実行のステータス。
     • 処理中: 統合が現在実行中であることを示します。
     • Succeeded: 統合が正常に実行されたことを示します。
     • 失敗: 統合の実行が失敗したことを示します。
     • キャンセル: 統合実行がユーザーによってキャンセルされたことを示します。
     • On hold: 統合実行が一時停止し、イベントまたはアクションの完了を待機していることを示します。
     • Retry on hold: 統合の実行が失敗し、再試行を待機していることを示します。
     • Suspended: 統合の実行が一時停止し、統合を再開するには手動での操作が必要であることを示します。
   • Start time: 統合の実行が開始したタイムスタンプ。
   • Duration: 統合の実行にかかる時間。
   • Integration Version: 実行された統合のバージョン。
   • Trigger ID: トリガーの ID 値。
   • Cloud Logging: Cloud Logging にログを記録するように統合が構成されているかどうかを示します。Cloud Logging が有効になっている場合、このフィールドには Cloud Logging でログを表示するためのリンクが表示されます。Cloud Logging が有効になっていない場合、このフィールドは [無効] に設定されます。
   • 再生元: 統合実行が再生された場合、このフィールドには再生された実行の実行 ID が示されます。以前の実行と同じパラメータで統合を再実行する場合は、公開された統合の実行をリプレイできます。たとえば、タイムアウト エラーが原因で統合が失敗した場合や、統合の出力が期待どおりでない場合は、実行を再生できます。実行を再生する方法については、実行を再生するをご覧ください。

4. [Filter] フィールドにフィルタを追加します。統合名、実行 ID、日付または期間、実行ステータス、変数のタイプ、変数の名前または値などの条件に基づいて、ログをフィルタリングできます。検索をさらにカスタマイズするには、[API] タブで説明されているように projects.locations.integrations.executions.list メソッドを使用します。

   テストケース実行のフィルタを追加するには、次の形式を使用します。

   Integration name:INTEGRATION_NAME:TEST_CASE_NAME。

   以下を置き換えます。

   • INTEGRATION_NAME: 機能テストを含む統合名。
   • TEST_CASE_NAME: テスト実行を一覧表示するテストケースの名前。

   例: Integration name:example-integration-name:example-test-case

API

実行ログのサイズが 300 MB を超えると、Application Integration は Response too large error エラーをスローし、ログは [実行ログ] ページで読み込まれません。この場合、projects.locations.integrations.executions.list メソッドを使用してログを取得する必要があります。API メソッドを使用してログを表示する手順は次のとおりです。

1. 実行ログを表示する実行 ID を取得するために、projects.locations.integrations.executions.list メソッドを使用する GET リクエストを作成し、snapshotMetadataWithoutParams パラメータを TRUE に設定します。

   curl -v -X -G GET
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'snapshotMetadataWithoutParams=true'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   複数の実行 ID がレスポンスで返されます。ログを表示したい実行 ID をコピーします。

2. その実行 ID の実行ログを取得するために、projects.locations.integrations.executions.list メソッドを使用する POST リクエストを作成し、前のステップでコピーした実行 ID でのフィルタを指定します。

   curl -v -X -G GET 
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'filter=execution_id="EXECUTION_ID"'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   レスポンスの ExecutionDetails フィールドでログの詳細を確認します。

   または、Google Cloud コンソールで、実行 ID で実行ログをフィルタすることもできます。

例: ログをフィルタする

レスポンスのフィルタリングを行い、1 つの統合を除くすべての統合のログを一覧表示するには、次の形式を使用します。

curl -v -X -G GET 
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter= workflowName!="INTEGRATION_NAME"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'

クエリ形式

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

例

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"