失敗した実行を調査する

フローが期待どおりに動かなかったとき、その実行を見れば、どのステップで問題が起きたか、そのステップがどんなデータを扱っていたかがわかります。このページでは、実行を探し、失敗したステップを読み、もう一度試すまでの手順を説明します。

1. 実行を探す

サイドバーの 実行履歴 を開きます。一覧を絞り込むには:

フローエディターを開いているなら、実行履歴 の 最近の実行 から探すほうが早いこともあります。

一覧に表示されるのは過去 14 日間の実行だけです。実行履歴を参照してください。

実行をクリックします。実行ノード で、失敗したステップには失敗と表示されます。そのステップを選び、エラー タブで理由を確認します。たとえば HTTP ステータスと API のメッセージや、必須項目の不足などです。

ステータスが タイムアウト の場合は、最後に実行されたステップを探してください。実行が終了した時点で、たいていそのステップが実行中か待機中でした。

失敗の多くは、ステップそのものではなく、ステップに渡されたデータが原因です。次の順に確認します。

失敗したステップの入力タブ: 参照が埋め込まれた後の設定です。空の値や、メールアドレスがあるはずの場所に $.01JA9F….output.email のような参照の文字列が残っていないか確認します。どちらも参照が見つからなかったことを示します。
参照先のステップの出力: そのフィールドが存在するか、使った名前と一致しているか、リストの中など想定した位置にあるかを確認します。
このステップは実行されませんでした と表示されたステップ: 失敗したステップが、選ばれなかった分岐上のステップを参照している場合、その実行ではそのステップに出力がありません。

ループ内のステップなら、失敗した回を選びます。Call Sub Flow ステップなら サブフローの実行 を開き、サブフロー自身の実行を同じ方法で調べます。

実行後にフローが編集されたことを示すバナーがある場合、グラフは実行時点のフローで、エディターの内容とは異なることがあります。

実行をそのまま再実行するボタンはありません。フローを修正してから、もう一度実行します。

フローをエディタで開く をクリックします。
ステップや、ステップが参照しているデータを修正します。
実行でテストします。これには マニュアル トリガーが必要です。メール送信などテスト中に実際に起きてほしくない処理がある場合は、そのステップの ノード設定 で サンプルペイロード を設定します。作成中にテストするを参照してください。
実行履歴 で新しい実行を確認します。
公開します。Webhook・スケジュール・イベントのトリガーは公開済みのバージョンを実行するため、公開するまでは失敗したバージョンが実行され続けます。バージョンと公開を参照してください。

フォームの回答など元の入力が重要な場合は、公開後に発生元からイベントをもう一度送るか、失敗した実行のトリガーの出力をコピーしてテストケースを作り直します。

顧客が見つからず API が Not Found を返すなど、失敗が想定内のこともあります。そのステップの ノード設定 で エラーハンドリング を フローを続行 にし、パスで結果がない場合を処理します。ステップが失敗したときを参照してください。