失敗した実行の再開

実行に失敗したランブックを失敗した箇所から再開することができます。以下では、再開の方法と、再開したときの動作について説明します。

実行履歴一覧からの再開

実行履歴一覧では、ステータスが「失敗」の実行履歴行の右端に「︙」が表示されます。「︙」をクリックするとメニューが表示されるため「再開」をクリックします。

ステータスが「開始待ち」「処理中」「完了」の場合、「︙」は表示されません。

実行履歴一覧。ステータスが「失敗」の行にだけ右端に「︙」があり、クリックすると「再開」メニューが表示されている

実行履歴詳細画面からの再開

ステータスが「失敗」の実行履歴の詳細画面で、画面右上の「︙」をクリックして表示されるメニューから「再開」をクリックします。

ステータスが「開始待ち」「処理中」「完了」の場合、「再開」は表示されません。

また、詳細画面から辿れるステップ詳細画面では「︙」をクリックしても「再開」は表示されません。

実行履歴の詳細画面。右上の「︙」のメニューに「実行履歴」「再開」「編集」「削除」が並んでいる

再開確認

「再開」をクリックすると、下図のような確認ダイアログが表示されます。

「ランブックの再開」ダイアログ。「このランブック実行を再開してもよろしいですか?」の下に、再開するステップの表示名と種別が表示され、「いいえ」「はい」ボタンがある

ダイアログにはどのステップから再開されるかが表示されます。問題がなければ「はい」をクリックしてください。実行が再開されます。

再開の起点となるステップは以下のように決まります。

  • ステップ実行履歴の最後に記録されたステップが正常に完了していた場合:
    • ステップ種別がブランチステップの場合:最後に記録されたブランチステップから再開
    • ステップ種別がブランチステップ以外の場合:最後に記録されたステップの次のステップから再開
  • ステップ実行履歴の最後に記録されたステップが正常に完了していなかった場合:
    • 最後に記録されたステップから再開
  • ステップ実行履歴が1行もない場合:
    • フローの最初のステップから再開

フローの最後のステップが完了した後に実行履歴のステータスが「失敗」になり、再開しても実行するステップがない場合は下図のようなダイアログが表示されます。

「ランブックの再開」ダイアログ。「実行するステップはありません。再開してもステップは実行されず、この実行履歴は完了になります」と表示され、ステップの表示はない

この場合も「はい」をクリックすることで実行が再開されますが、どのステップも実行されずに実行履歴のステータスが「完了」になります。

他のタブや他のユーザーによる再開操作、再開 API 呼び出し等により、「再開」をクリックした時点で実行履歴のステータスが変化している場合があります。そのような場合は下図のようなダイアログが表示されます。

「再開できません」ダイアログ。「他の操作により状態が変化したため再開できません」と表示され、「閉じる」ボタンがある

この場合は再開できませんので、「閉じる」をクリックしてダイアログを閉じた後、ページを再読み込みして最新の状態に更新してください。

再開時に使用するフロー

実行を再開すると、初回実行時のフローを使用します。実行後にランブックのフローを変更していても、再開した実行には反映しません。

そのため、ステップの設定の誤りが原因で失敗した場合は、フローを修正してから再開しても、同じ原因で再び失敗します。

再開時に使用するアクションの設定

アクションステップで実行されるアクションは、再開処理を行った時点での最新の設定が使用されます。初回実行後にアクションの設定(通知先や本文等)を変更した場合であっても、再開時は変更後の最新設定で実行されます。

なお、アクション自体の設定変更(本文や宛先等)は再開時に反映されますが、アクションステップで実行するアクションを別のアクションへ差し替える操作は『フローの変更』とみなされます。そのため、再開時は差し替え後の新しいアクションではなく、初回実行時のアクションがそのまま実行されます。

ステップの再実行

「再開確認」 で説明した通り、実行を再開するとステップ実行履歴の最後に記録されたステップを再実行する場合があります。

ステップを再実行すると、そのステップの実行履歴を新しい実行結果で上書きします。再実行前の情報は保持しません。

再開前のステップの実行履歴例
再開前のステップ実行履歴。最後の行のアクションステップ「メール送信」のステータスが「失敗」になっている
再開後のステップの実行履歴例
再開後のステップ実行履歴。「メール送信」の行のステータスが「完了」になり、開始日時と終了日時が再開した時刻に更新されている

再開後に結果が変わる可能性のあるステップ

ランブックを失敗・停止した位置から再開する場合、再開処理を実行した「その瞬間(リアルタイム)」のシステム状態や日時に基づいて後続のステップが処理されます。(※初回実行時に「完了」し、再開によって再実行されないステップの処理結果や、ランブックが実行される起因となったメッセージの情報は初回実行時のものが保持されます。)

そのため、初回の実行から再開までに時間が経過している場合、時間差によって次のステップの実行結果が変化することがあります。

確実に「再開時点のデータ」に変わるステップ
  • 「現在の日時を取得する」 オペレーターステップ
    • 変化内容:初回実行時の日時ではなく、再開後にそのステップが実行された時点の日時を取得します
    • 注意点:取得した日時を基に「日中帯/夜間帯」等の時間帯分岐を行っている場合、初回実行時とは異なる分岐へ進む可能性があります
環境や状態の変化によって「結果が変わる可能性がある」ステップ
  • 「アクションステップ」(メール送信・Webhook・Pigeon 電話通報)
    • 変化内容:呼び出し先(外部システムや通報先担当者)の再開時点の状態に応じて結果が変わります
    • 注意点:時間経過によりネットワーク状態や担当者の受電可否、API キーの有効性等が変わっていると、成功・失敗の結果やレスポンス内容が初回実行時と異なる場合があります
  • 「イベントステップ」(スコープの深刻度の変更)
    • 対象スコープを条件指定している場合:再開までの間に対象スコープの属性(ホスト名やタグ等)が編集されていると、対象となるスコープが変更される(または対象が存在しなくなる)ことがあります
    • 深刻度を増減する場合:再開までの間に対象スコープの現在の深刻度が変化(自動復旧や別のアラート受信による上昇)していると、計算後の最終的な深刻度や、それに伴うトリガー実行の判定結果が初回想定と異なることがあります
    • 深刻度を設定する場合:再開までの間に対象スコープの現在の深刻度が変化していても最終的な深刻度は変わりませんが、変化前の深刻度が異なることにより、トリガー実行の判定結果が初回想定と異なることがあります