HULFT Squareで障害検知の仕組みを作ってみた

Posted at 2026-10-30

はじめに

データ連携では、一時的な通信エラーやファイル不備など、さまざまな要因で処理が失敗する可能性があります。そのため、エラー発生時の検知だけでなく、リトライ処理による再実行や、リトライ後も復旧しなかった場合の障害検知を実装することが重要です。

本記事では、HULFT Squareを使用して以下の仕組みを実装する方法を紹介します。

・エラー監視
・リトライ処理
・障害検知

実際の設定画面を交えながら、各コネクターの配置方法や設定内容について解説します。

実施手順

以下の手順を実施します。
１. エラー監視処理作成
２. リトライ処理＆障害検知処理作成

１. エラー監視処理作成

① 例外監視処理を作成
例外監視処理を配置することで、監視対象処理で発生した例外をcatchアイコンで捕捉できるようになります。

[ツールパレット] ⇒ [基本] ⇒ [フロー] ⇒ [例外監視]コネクターを使用します。

[Start]アイコンの先に置きます。

[例外監視]コネクターの詳細については、例外監視処理を参照ください。

② 監視対象の処理を作成
エラー監視対象の処理を作成し、[try]アイコンの先に置きます。
今回はCSVファイル読み取り（csv_read）とCSVファイル書き込み（csv_write）を作成します。

③ 例外通知処理を作成
[ツールパレット] ⇒ [基本] ⇒ [処理] ⇒ [例外通知]コネクターを使用します。

[catch]アイコンの先に例外通知を置きます。

[例外通知処理のプロパティ]の[メッセージ]にログ出力したいメッセージを入力します。

[例外通知]コネクターの詳細については、例外通知処理を参照ください。

例外通知処理で設定したメッセージは、[モニタリング] ⇒ [サービス] ⇒ [HULFT Integrate] のイベントログに出力されます。
[イベントログ]の詳細については、HULFT Integrateを参照ください。

２. リトライ処理＆障害検知処理作成

１. エラー監視処理作成で作成したスクリプトにリトライ処理とリトライ後の障害検知処理を追加します。

① リトライ処理を作成
スクリプト変数（retry_count）を作成します。スクリプト変数（retry_count）はリトライ回数を保持するための変数です。
[プロジェクトエクスプローラ]のスクリプト名を右クリックし、[新規作成] ⇒ [スクリプト変数]を選択して作成します。
[変数型]に整数型、[初期値]にリトライ回数を設定します。

[ツールパレット] ⇒ [基本] ⇒ [フロー] ⇒ [繰り返し(条件指定)]コネクターを使用します。

[Start]アイコンの先に置きます。

ループ回数（loop:count）がretry_countより小さい間ループする条件にします。

[繰り返し(条件指定)]コネクターの詳細については、繰り返し(条件指定)処理を参照ください。

② 変数代入処理を作成
スクリプト変数（success_flag）を作成します。スクリプト変数（success_flag）は処理結果（成功／失敗）を保持するための変数です。
[プロジェクトエクスプローラ]のスクリプト名を右クリックし、[新規作成] ⇒ [スクリプト変数]を選択して作成します。
[変数型]に真偽値型、[初期値]にfalseを設定します。

[ツールパレット] ⇒ [基本] ⇒ [処理] ⇒ [変数代入]コネクターを使用します。

監視対象の処理の先に置きます。

[ツールパレット] ⇒ [条件] ⇒ [真偽値定数]を使用します。
[真偽値定数]からスクリプト変数(success_flag)に線を引きます。

[真偽値定数]の[定数]にtrueを設定します。

[変数代入]コネクターの詳細については、ドキュメントMapper/変数Mapper（詳細）を参照ください。
[真偽値定数]の詳細については、真偽値定数を参照ください。

③ 待機処理を作成
スクリプト変数（wait_time）を作成します。スクリプト変数（wait_time）はリトライ時の待機時間（秒）を保持するための変数です。
[プロジェクトエクスプローラ]のスクリプト名を右クリックし、[新規作成] ⇒ [スクリプト変数]を選択して作成します。
[変数型]に整数型、[初期値]に待機時間（秒）を設定します。