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

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

プロセス制御の極意:VBScriptにおけるウォッチドッグ・パターンによる堅牢な自動化基盤の構築

VBScript(Windows Script Host)を用いた自動化において、多くのエンジニアが陥る致命的な罠がある。それは「シングルスレッドの呪縛」だ。

COMオブジェクト(Excel、SQL Server、あるいは独自のActiveXコントロール)との通信において、対象のプロセスが応答を停止した瞬間、呼び出し元のスクリプトは「同期待ち(Synchronous Blocking)」の状態に陥り、永遠に制御を失う。この状態に陥ったスクリプトは、タスクスケジューラによって起動されていようが、メモリを食いつぶしていようが、外部からの介入なしには自浄作用を発揮できない。

本稿では、レガシー環境における自動化の信頼性を極限まで高めるための設計パターン、すなわち「ウォッチドッグ(番犬)実装」について、そのアーキテクチャと実装の真髄を解説する。

1. なぜ「タイムアウト」をスクリプト内で実装してはいけないのか

一般的な初級者は、ループ内に `WScript.Sleep` を挟み、経過時間をカウントして自ら終了しようとする。しかし、これは設計思想として根本的に誤っている。

COMオブジェクトのメソッド呼び出し(例:`objExcel.Quit` や `objConn.Execute`)が、対象プロセスのハングアップによってブロッキングされた場合、スクリプトの実行ポインタはその行で停止する。 つまり、タイムアウト判定を行うはずのコード自体が実行されなくなるのだ。

真の堅牢性を実現するためには、「実行プロセス」と「監視プロセス」を完全に分離(Decoupling)し、プロセスツリーの階層を利用した外部介入が必要となる。

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

我々が構築すべきは、以下の3層構造を持つ並列実行モデルである。

1. Worker Process (実業務プロセス): 実際のロジックを実行する。COMオブジェクトとのやり取りに失敗し、ハングアップする可能性がある。
2. Watchdog Process (監視プロセス): WorkerのPID(プロセスID)を捕捉し、経過時間を監視する。Workerが規定時間内に終了しない場合、OSレベルで強制終了(`taskkill`)を敢行する。
3. Controller (制御層): Watchdogを起動し、Workerの再試行回数(Retry Count)を管理する。

プロセス管理におけるメモリとリソースの考慮

VBScriptにおいて、オブジェクトの解放(`Set obj = Nothing`)は極めて重要だが、プロセスがハングしている場合は、スクリプト内の解放処理すら実行されない。したがって、「プロセスの強制終了」こそが、最強のメモリ解放手段となることを理解せよ。

3. 実装コード:堅牢なウォッチドッグ・パターン

以下に、実戦投入可能なレベルのコード例を示す。ここでは、`WshShell.Exec` を用いて実行プロセスを制御し、WMI(Windows Management Instrumentation)を用いてプロセスの生存確認を行うハイブリッドな手法を採用する。

【Worker.vbs】(業務ロジック:ハングアップをシミュレート)

' ===========================================================================
' Worker Script: 実業務を行うプロセス
' ===========================================================================
Option Explicit

Dim objExcel, i
On Error Resume Next ' 致命的なエラーでもプロセスを維持するため、あえて捕捉する

' シミュレーション:COMオブジェクトのハングアップ
' 本来はここでExcel等の操作を行う
Set objExcel = CreateObject("Excel.Application")

If Err.Number <> 0 Then
    WScript.Quit 1 ' 異常終了
End If

' --- 意図的なハングアップのシミュレーション ---
' 本来の業務処理がここでブロックされると想定
WScript.Echo "Worker: 業務処理を開始します..."
WScript.Sleep 60000 ' 60秒間、何もしない(あるいはCOM待ちで止まる)

' 正常終了のシミュレーション
objExcel.Quit
Set objExcel = Nothing
WScript.Echo "Worker: 正常終了しました。"
WScript.Quit 0

【Watchdog.vbs】(監視・制御プロセス)

' ===========================================================================
' Watchdog Script: 実行プロセスを監視し、タイムアウト時に強制介入する
' ===========================================================================
Option Explicit

Dim objShell, objWMI, objExec, strWorkerCmd
Dim intTimeout, intInterval, intMaxRetries, intRetryCount
Dim strWorkerName, strPID, boolIsRunning

' --- 設定パラメータ ---
strWorkerCmd = "wscript.exe ""C:\Path\To\Worker.vbs""" ' Workerの実行コマンド
intTimeout   = 10 ' タイムアウト秒数(Workerの想定実行時間より長く設定)
intInterval  = 2  ' 監視間隔(秒)
intMaxRetries = 3 ' 最大再試行回数
intRetryCount = 0

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

Do While intRetryCount <= intMaxRetries
    WScript.Echo "--- 試行回数: " & (intRetryCount + 1) & " ---"
    
    ' 1. Workerプロセスの起動
    ' Execメソッドを使用することで、実行プロセスへのハンドル(objExec)を取得する
    Set objExec = objShell.Exec(strWorkerCmd)
    
    ' 2. 監視ループ
    Dim startTime, elapsed
    startTime = Timer
    boolIsRunning = True
    
    Do While boolIsRunning
        elapsed = Timer - startTime
        
        ' タイムアウト判定
        If elapsed > intTimeout Then
            WScript.Echo "CRITICAL: タイムアウト検知 (" & intElapsed & "s). プロセスを強制終了します。"
            TerminateProcessByCommand objExec.ProcessID
            boolIsRunning = False
            intRetryCount = intRetryCount + 1
        Else
            ' プロセスの生存確認
            If objExec.Status = 0 Then ' 0 = WshRunning
                WScript.Sleep intInterval
            Else
                ' プロセスが正常終了(Status != 0)
                WScript.Echo "INFO: Workerが正常終了しました。"
                WScript.Quit 0
            End If
        End If
    Loop
    
    WScript.Echo "INFO: 再試行準備中..."
    WScript.Sleep 5000 ' プロセスが完全にクリーンアップされるのを待つ
Loop

WScript.Echo "FATAL: 最大再試行回数に達しました。システムを停止します。"
WScript.Quit 1

' ---------------------------------------------------------------------------
' サブルーチン: プロセスIDを指定して強制終了
' ---------------------------------------------------------------------------
Sub TerminateProcessByCommand(pid)
    On Error Resume Next
    ' taskkill /F (強制) /PID (プロセスID指定)
    ' これにより、COMのブロッキング状態にあるプロセスもOSレベルで切断できる
    objShell.Run "taskkill /F /PID " & pid, 0, True
    If Err.Number <> 0 Then
        WScript.Echo "ERROR: プロセスの強制終了に失敗しました。PID: " & pid
    Else
        WScript.Echo "SUCCESS: プロセスを強制終了しました。PID: " & pid
    End If
    On Error GoTo 0
End Sub

4. アーキテクトの視点:レガシー環境における「死の連鎖」を防ぐ

この実装において、シニアエンジニアが留意すべきは「ゾンビプロセスの発生」である。

VBScriptが`objShell.Exec`で起動したプロセスが、親プロセス(Watchdog)の終了と共に共に消滅するとは限らない。特に、Workerがさらに別のCOMオブジェクト(Excel等)を生成していた場合、Worker自体を `taskkill` しても、背後でExcelのインスタンスだけがメモリに残り続ける「孤児プロセス」が発生する。

これを防ぐための極限の知見は以下の通りだ:

1. ツリー全体の抹殺:
可能であれば、PID単体ではなく、`taskkill /T /F /PID [PID]` のように `/T` オプション(子プロセスを含むツリー全体の終了)を検討せよ。ただし、環境によっては意図しないシステムプロセスを巻き込むリスクがあるため、Workerのプロセス名(`wscript.exe`など)を特定して `taskkill /F /IM wscript.exe` とする手法との使い分けが必要だ。
2. WMIによるクリーンアップ:
再試行(Retry)を開始する前に、WMIを用いて、前回の実行で残存しているWorkerプロセスや、関連するCOMオブジェクトのプロセスが完全に消滅しているかを厳格にチェックする工程を挟むこと。これが、システムの「自己修復能力」の境界線となる。

結言

VBScriptは、現代のマイクロサービスアーキテクチャから見れば脆弱な言語に見えるかもしれない。しかし、その挙動(シングルスレッド・同期通信)を完全に理解し、OSレベルのプロセス制御を組み合わせることで、レガシーなWindows環境においても、極めて堅牢なバッチ基盤を構築することが可能だ。

「プログラムは必ず失敗する」という前提に立ち、失敗した際のプロセスライフサイクルを設計すること。それこそが、真のエンジニアリングである。

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