【実務・中級編】【ウォッチドッグ実装】親スクリプトのハングアップを検知して強制終了・再試行させる、監視用子プロセスの並列実行とタイムアウト管理 – VBScript (Visual Basic Scripting Edition)解析バイブル

スポンサーリンク
スポンサーリンク

ゾンビプロセスを許すな:VBScriptにおける「ウォッチドッグ・パターン」による堅牢な自動化基盤の設計

「スクリプトは正常に終了したはずなのに、なぜかExcelのプロセスが残っている」「ネットワークの瞬断でCOMオブジェクトが応答待ちになり、処理が永遠に止まってしまった」

業務自動化の現場で、君たちはこうした「ゾンビプロセス」の恐怖に直面したことはないだろうか?

多くの開発者は `On Error Resume Next` を使い、エラーを握りつぶすことで「動いているように見せる」ことに腐心する。だが、それは設計放棄に等しい。真のプロフェッショナルが目指すべきは、エラーを回避することではなく、「異常な状態を検知し、システムを自己修復させる」ことだ。

本稿では、VBScript/WSH環境において、ハングアップした親プロセスを外部から監視・強制終了・再試行させる「ウォッチドッグ(番犬)パターン」の極致を伝授する。

1. なぜ単一のスクリプトでは「堅牢」になれないのか

VBScriptの最大の弱点は、その実行モデルがシングルスレッドであり、かつCOMオブジェクト(Excel, Access, SQL Server等)のライフサイクルを完全に制御しきれない点にある。

例えば、以下のような状況を想定してほしい。
1. スクリプトが外部のデータベースへクエリを投げる。
2. ネットワークの瞬断により、データベース側からの応答が「タイムアウト」も「エラー」も返さず、OSレベルで「応答待ち(Waiting)」状態になる。
3. VBScriptの実行エンジンは、COMオブジェクトからのレスポンスを待ち続ける。

このとき、スクリプト内部に書いたエラーハンドリングは一切機能しない。なぜなら、エラーが発生したのではなく、「正常に待ち続けている」状態だからだ。スクリプトは死んでいないが、仕事もしていない。これが「ゾンビプロセス」の正体である。

これを解決するには、「自分自身を監視する、独立した別のプロセス」が必要不可欠となる。

2. ウォッチドッグ・アーキテクチャの設計思想

堅牢なバッチ処理基盤を構築するには、以下の2つの役割を分離した「2プロセス構成」を採用すべきである。

A. Workerプロセス(実行主体)

実際の業務ロジック(ファイル操作、DB連携、Excel操作)を担う。
重要なのは、「自分は生きている」という証(ハートビート)を外部に刻み続けることだ。

B. Watchdogプロセス(監視主体)

Workerプロセスを起動し、その生存を確認する。
Workerが一定時間「証」を更新していない、あるいはプロセス自体が消失した(あるいは異常な長時間生存をしている)場合に、強制介入(Kill)と再起動を行う。

3. 実装:プロダクションレベルのウォッチドッグ・コード

以下に、実務でそのまま利用可能な、ハートビート方式を用いたウォッチドッグの実装例を示す。

【Worker.vbs】業務ロジックの実装

Workerは、自身の生存を示すタイムスタンプをファイルに書き込み続ける。

' =================================================================
' Worker.vbs: 業務ロジックを実行するメインスクリプト
' =================================================================
Option Explicit

Dim objFSO, objHeartbeatFile, strHeartbeatPath
Set objFSO = CreateObject("Scripting.FileSystemObject")

' ハートビート(生存証明)用のファイルパス
strHeartbeatPath = "C:\Temp\worker_heartbeat.txt"

On Error Resume Next

' --- メイン処理ループ ---
Dim i
For i = 1 To 100
    ' 1. ハートビートの更新(自分が生きていることを示す)
    UpdateHeartbeat strHeartbeatPath
    
    ' 2. 実際の業務ロジック(例:重い処理をシミュレート)
    ' ここでCOMオブジェクトのハングアップが起きると想定
    PerformBusinessLogic i
    
    WScript.Sleep 2000 ' 2秒間隔で実行
Next

WScript.Echo "業務処理が正常に完了しました。"

' --- サブルーチン ---

Sub UpdateHeartbeat(path)
    On Error Resume Next
    Dim objFile
    Set objFile = objFSO.CreateTextFile(path, True)
    objFile.WriteLine Now ' 現在時刻を書き込み
    objFile.Close
    Set objFile = Nothing
End Sub

Sub PerformBusinessLogic(step)
    ' ここにExcel操作やDB操作を記述
    ' シミュレーションとして、特定のステップでハングアップを模倣
    If step = 5 Then
        WScript.Echo "Step 5: ハングアップをシミュレート中..."
        WScript.Sleep 100000 ' 長すぎる待機(実務ではここで止まる)
    End If
    
    ' 本来の処理
    ' WScript.Echo "Processing step: " & step
End Sub

【Watchdog.vbs】監視・制御の実装

Watchdogは、WorkerのプロセスIDを管理し、タイムスタンプの鮮度をチェックする。

' =================================================================
' Watchdog.vbs: Workerを監視し、異常時に強制介入する番犬
' =================================================================
Option Explicit

Dim objShell, objWMI, objProcess, strWorkerCmd, strHeartbeatPath
Dim intTimeoutSeconds, intMaxAgeSeconds, intRetryCount
Dim objFSO, dtLastHeartbeat, dtNow

' --- 設定エリア ---
strWorkerCmd = "wscript.exe C:\Temp\Worker.vbs" ' Workerの起動コマンド
strHeartbeatPath = "C:\Temp\worker_heartbeat.txt"
intTimeoutSeconds = 5      ' Workerの処理間隔(秒)
intMaxAgeSeconds = 15      ' 何秒間更新がなければ「ハング」とみなすか
intMaxRetries = 3          ' 最大再試行回数
' ------------------

Set objShell = CreateObject("WScript.Shell")
Set objWMI = GetObject("winmgmts:{impersonationLevel=impersonate}!\\.\root\cimv2")
Set objFSO = CreateObject("Scripting.FileSystemObject")

intRetryCount = 0

Do While intRetryCount < intMaxRetries
    WScript.Echo "--- Watchdog: Workerを起動します ---"
    
    ' Workerの起動(非同期実行)
    objShell.Run strWorkerCmd, 1, False
    
    ' Workerのプロセスを監視するループ
    Do While True
        WScript.Sleep 5000 ' 5秒ごとにチェック
        
        If CheckWorkerHealth(strHeartbeatPath, intMaxAgeSeconds) Then
            ' 正常稼働中
            WScript.Echo "Status: OK (Heartbeat detected)"
        Else
            ' 異常検知(ハングアップまたはプロセス消失)
            WScript.Echo "Status: CRITICAL! 異常を検知しました。介入を開始します。"
            KillWorkerProcess "wscript.exe" ' プロセスを強制終了
            Exit Do ' 監視ループを抜けて再起動プロセスへ
        End If
    Loop
    
    intRetryCount = intRetryCount + 1
    WScript.Echo "Retry Attempt: " & intRetryCount & " / " & intMaxRetries
Loop

WScript.Echo "Watchdog: 最大再試行回数に達しました。手動確認が必要です。"

' --- 関数エリア ---

Function CheckWorkerHealth(hbPath, maxAge)
    ' 1. ファイルが存在するか、およびタイムスタンプが最新かを確認
    If Not objFSO.FileExists(hbPath) Then
        CheckWorkerHealth = False
        Exit Function
    End If
    
    On Error Resume Next
    Dim objFile, strContent, dtLast
    Set objFile = objFSO.OpenTextFile(hbPath, 1)
    strContent = objFile.ReadLine
    objFile.Close
    
    If Err.Number <> 0 Then
        CheckWorkerHealth = False ' ファイルロック等による読み取り失敗も異常とみなす
        Exit Function
    End If
    
    dtLast = CDate(strContent)
    dtNow = Now
    
    ' 現在時刻とハートビートの差分を計算
    If DateDiff("s", dtLast, dtNow) > maxAge Then
        CheckWorkerHealth = False
    Else
        CheckWorkerHealth = True
    End If
End Function

Sub KillWorkerProcess(procName)
    ' WMIを使用して特定のプロセスを強制終了する
    Dim colProcesses, objProc
    Set colProcesses = objWMI.ExecQuery("Select * from Win32_Process Where Name = '" & procName & "'")
    
    For Each objProc In colProcesses
        ' 注意: 本来はWorkerのPIDを特定してKillすべきだが、
        ' 実務上の簡易化のため、wscript.exe全体を対象とする例を示している。
        ' 厳密には、Worker起動時に取得したPIDを用いること。
        objProc.Terminate()
        WScript.Echo "Process terminated: " & objProc.ProcessId
    Next
End Sub

4. 運用における「極限の注意点」

この設計をプロダクション環境に投入する際、以下の3点を必ず考慮せよ。

① プロセス識別の厳密化

上記のコードでは簡略化のため `wscript.exe` を一括で `Terminate` しているが、これは他の正常なスクリプトまで巻き込むリスクがある。
実務では、`objShell.Run` の戻り値からPIDを取得するか、Worker起動直後にWMIで自身が生成したプロセスを特定し、その PID(Process ID)のみをターゲットに Kill する 設計に昇華させなければならない。

② ファイルロックとI/Oの競合

ハートビートに使用するファイルは、Workerが書き込み、Watchdogが読み取る。
書き込みの瞬間にWatchdogが読み込もうとすると、ファイルロックによりエラーが発生する。`On Error Resume Next` でエラーを無視するのではなく、「読み取り失敗時は数秒待機してリトライする」といった、I/Oの競合を考慮した堅牢な読み取りロジックを組み込むべきだ。

③ データベース・リソースのクリーンアップ

プロセスを `Terminate`(強制終了)させることは、いわば「電源プラグを抜く」行為だ。
もしWorkerがデータベースのトランザクションの最中に強制終了された場合、DB側に未完了のセッションやロックが残る可能性がある。

  • DB側で適切な `Idle Timeout` が設定されているか?
  • リトライ時に、前回の残骸が影響しないか?

これらを設計段階で検証しておくことが、真のアーキテクトの責務である。

結論

VBScriptは古くからある言語だが、その限界を知り、適切なデザインパターン(ウォッチドッグ)を適用することで、エンタープライズレベルの堅牢な自動化基盤へと進化させることができる。

「動けばいい」という思考を捨て、「どう壊れるか」を予測し、それを制御する仕組みを組み込め。それが、君たちの作るツールの信頼性を決定づける。

タイトルとURLをコピーしました