Application Integration でサポートされているコネクタをご覧ください。

実行のリプレイ

Application Integration では、元の統合を新しい統合実行として再実行することで、実行をリプレイできます。Application Integration フローは、異なるシステム間の通信とデータ交換をオーケストレートするように設計されています。これらのフローは複雑で、複数のステップが含まれ、多くの場合、外部のサードパーティ システムとのやり取りに依存します。そのため、次のようなさまざまな理由で実行が失敗することがあります。

  • フロー内のエラー: インテグレーション フローに、誤ったデータ変換や設定ミスのあるステップなど、誤ったロジックが含まれています。
  • 外部システムに関する問題: 統合フローがやり取りするサードパーティ システム（データベース、ウェブサービス、API など）で発生した問題や停止。
  • 一時的なネットワーク エラー: 統合に関連するシステム間の接続性の一時的な不具合。

公開された統合でエラーをデバッグしたら、統合の実行をリプレイできます。実行をリプレイすると、フローが再生成され、元の統合が新しい統合実行として再処理されます。

必要なロール

実行のリプレイに必要な権限を取得するには、プロジェクトに対する Application Integration の起動元 （roles/integrations.integrationInvoker）の IAM ロールの付与を管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセスを管理するをご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

実行のリプレイ

実行をリプレイする手順は次のとおりです。

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

    [Application Integration Logs] に移動

  2. ナビゲーション メニューの [ログ] をクリックします。実行ログのページが表示されます。
  3. リプレイする実行で、 をクリックし、[リプレイ] をクリックします。[リプレイする理由] ペインが表示されます。
  4. 実行をリプレイする理由を追加し、[リプレイ] をクリックします。

利点

実行のリプレイは、次のような場合に便利です。

  • 外部システムからのイベントのモック: 失敗した実行を再実行する際にリプレイが役立ちますが、実行に外部システムのモックが必要となります。たとえば、Jira などの外部アプリケーションからイベントを受信するとトリガーされる Pub/Sub トリガーとの統合があるとします。実行をリプレイすると、Jira から同じイベントをトリガーするのが難しい場合があるため、Pub/Sub からのトリガー イベントが実行されます。
  • 失敗した実行の再試行: 一時的なエラーや外部システムの問題が原因で統合が失敗した場合は、実行をリプレイしてフローを再実行し、統合を完了できます。

考慮事項

実行のリプレイには、次の考慮事項が適用されます。

  • 実行ステータス: 実行ステータスが「成功」、「失敗」、「キャンセル」の実行をリプレイできます。他の状態の実行をリプレイするには、まず実行をキャンセルする必要があります。
  • 互換性のある公開バージョン: 公開された統合バージョンに変更を加えた後に実行をリプレイする場合は、それらの変更が元の実行と互換性があることを確認してください。たとえば、元の実行で 2 つの入力変数が必要で、更新された統合バージョンで 1 つの入力変数のみが必要な場合、リプレイ実行は失敗します。
  • 実行モード: 統合バージョンが変更された場合でも、リプレイ実行は元の実行と同じ実行モードに従います。

制限事項

デフォルトでは、リプレイされた実行の期限は 10 分です。実行が期限内に完了しなかった場合、実行ステータスは CANCELLED に設定されます。

次のステップ