ワークフローの実行結果にアクセスする

Workflows を使用すると、実行の出力の検査、ステップのステータスの確認、ランタイム エラーの診断を行うことができます。ワークフローを 実行すると、これらの 結果を Google Cloud コンソールで表示するか、Google Cloud CLI を使用して表示できます。

Console

  1. コンソール Google Cloud で [**ワークフロー**] ページに移動します。

    [ワークフロー] に移動

  2. ワークフローの実行結果にアクセスするには、ワークフローの名前をクリックして [ワークフローの詳細] ページに移動します。

  3. 特定の実行の詳細を確認するには、[実行] タブでリスト内の実行 ID をクリックして、[実行の詳細] ページに移動します。

  4. [Summary] タブでは、実行ごとに次の情報が表示されます。

    • 実行 ID: ワークフロー実行の固有識別子。
    • 実行の状態: 現在または最後のワークフロー ステップを含むワークフローの終了状態を示します。
    • 実行の作成: 実行が開始された日時。
    • 実行開始: 実行が開始され、ステップが実行された日時。
    • 実行終了: 実行が終了した日時。
    • 実行期間: 合計経過時間。これは、ネットワーク エラーまたは接続の問題を示す場合があります。
    • ワークフロー名: ワークフローの名前。
    • ワークフロー リビジョン: 実行時点での現在のリビジョン。
    • 通話履歴レベル: 実行中に適用される通話ロギングのレベル。詳細については、 コールロギングをご覧ください。
    • 入力: ワークフローに渡されるランタイム引数（存在する場合）。
    • 出力: ワークフローの出力。実行が失敗した場合は、実行の失敗の原因となる例外が含まれます。このドキュメントでは、 実行エラーマップをご覧ください。

  5. ワークフローの実行履歴をステップ エントリのリストとして表示するには、[ステップ] タブをクリックします。詳細については、実行ステップの履歴を表示するをご覧ください。

  6. ワークフローの実行のログを表示するには、[ログ] タブをクリックします。

  7. 実行ログをフィルタするには、テーブルの上部にある [フィルタ] フィールドを使用します。たとえば、失敗した実行の試行のみを表示するには、フィルタのテキスト フィールドに「failed」を入力します。

gcloud

  1. ワークフローの実行の完全なリストを確認するには、次のコマンドを入力します。

    gcloud workflows executions list WORKFLOW_NAME

    WORKFLOW_NAME は、ワークフローの名前に置き換えます。 目的の実行の実行 ID をコピーします。

  2. ワークフローの実行ログを表示するには、次のコマンドを入力します。

    gcloud workflows executions describe \
    --workflow=WORKFLOW_NAME \
    EXECUTION_ID

    以下のように置き換えます。

    • WORKFLOW_NAME: ワークフローの名前
    • EXECUTION_ID: 実行の一意の ID

    このコマンドは、次のような出力を返します。 

    argument: 'null'
endTime: '2022-07-19T12:40:07.070039707Z'
error:
 context: |-
    The argument of 'in' must be a dict or an array; got: null
    in step "checkSearchTermInInput", routine "main", line: 12
 payload: "{"message":"The argument of 'in' must be a dict or an array; got: null"
    
    ,"tags":["TypeError"]}"
 stackTrace:
    elements:
    - position:
       column: '26'
       length: '24'
       line: '12'
       routine: main
       step: checkSearchTermInInput
name: projects/1051295516635/locations/us-central1/workflows/myFirstWorkflow/executions/17ffc89c-0a27-4d2f-8356-e681d949a3d3
startTime: '2022-07-19T12:40:07.024823663Z'
state: FAILED
status:
 currentSteps:
 - routine: main
    step: checkSearchTermInInput
workflowRevisionId: 000001-ac2
    出力には次の情報が含まれます。

    • argument: ワークフローに渡されるランタイム引数（存在する場合）。
    • endTime: 実行が終了した日時。
    • error: 実行の失敗につながった例外の一部としてスローされたエラー メッセージ。
    • name: 実行の完全な名前（プロジェクトの名前、ワークフローのロケーション、ワークフローの名前、実行 ID を含む）。
    • startTime: 実行が開始された日時。
    • state: ワークフローの終了状態を示します
    • status: 実行の現在または最後のワークフロー ステップ。
    • workflowRevisionID: 実行時点でのリビジョン。

実行エラーマップ

ワークフローが実行中に、 try/exceptブロックでキャッチされないエラーをスローする場合、 実行は失敗し、エラーを説明するエラーマップ（JSON 辞書）が 返されます。

raise custom errors をraise構文を使用して発生させることもできます。

次のステップ