【実務・中級編】【テキストファイル内の特定キーワード前後行抽出】大容量ログからエラー発生前後のコンテキスト行を自動抽出するデバッグ支援ツール – VBScript (Visual Basic Scripting Edition)解析バイブル

スポンサーリンク

VBScriptで大容量ログを捌く:リングバッファによる「エラー前後コンテキスト」抽出の極意

現場のエンジニア諸君。ログ解析のために、数GBのテキストファイルをExcelに読み込ませてPCをフリーズさせていないか?

VBScriptは「古い言語」と揶揄されるが、Windows環境においてこれほど低コストかつ即効性のある自動化兵器は他にない。しかし、やり方を間違えればメモリを食いつぶし、実行は終わらない。今日は、「リングバッファ」というデータ構造をVBScriptで実装し、巨大ログからエラー前後の情報をピンポイントで抽出する、本番環境仕様の設計術を伝授する。

—

1. なぜ「全行読み込み」が罪なのか

初心者は、`ReadAll`でファイルをメモリに展開しようとする。これが間違いの元だ。数百万行あるログをメモリに載せれば、OSのページングが走り、I/O性能は壊滅する。

我々が目指すべきは「ストリーム処理」だ。ファイルを1行ずつ読み込み、不要なデータは即座に破棄する。そして、今まさに解析している行の「直前N行」を保持し続けるために、リングバッファ構造を採用する。

2. リングバッファ設計の神髄

リングバッファとは、配列のインデックスを循環的に使う手法だ。
例えば「前後5行」を保持したい場合、サイズ5の配列を用意し、新しい行が来るたびに古い行を上書きしていく。これなら、エラーが発生した瞬間に、配列の中身を書き出すだけで「直前5行」が手に入る。

3. 実践:プロダクションコード

このコードは、ファイルI/Oのオーバーヘッドを最小化しつつ、メモリ使用量を一定に保つよう設計されている。

‘ エラーコンテキスト抽出ツール
Option Explicit

Const ForReading = 1
Const ForWriting = 2
Const ContextLines = 5 ‘ 前後の行数

Dim fso, inFile, outFile
Dim line, ringBuffer(), i, ptr, count
Dim targetKeyword, isFound

targetKeyword = “ERROR_CRITICAL”
Set fso = CreateObject(“Scripting.FileSystemObject”)

‘ メモリ効率を考慮した固定長配列
ReDim ringBuffer(ContextLines)
ptr = 0
count = 0

Set inFile = fso.OpenTextFile(“C:\Logs\large_app.log”, ForReading)
Set outFile = fso.CreateTextFile(“C:\Logs\report.txt”, True)

Do Until inFile.AtEndOfStream
line = inFile.ReadLine

‘ リングバッファに格納(古い順に上書き)
ringBuffer(ptr) = line
ptr = (ptr + 1) Mod (ContextLines + 1)
if count < (ContextLines + 1) Then count = count + 1 ' キーワード検知 If InStr(line, targetKeyword) > 0 Then
outFile.WriteLine “— [DETECTED]: ” & line & ” —”
‘ バッファの内容を書き出し(順序を考慮)
For i = 0 To ContextLines
‘ 実際の実装ではポインタの進み具合に合わせて順序制御が必要
outFile.WriteLine ringBuffer((ptr + i) Mod (ContextLines + 1))
Next
outFile.WriteLine “————————————”
End If
Loop

inFile.Close
outFile.Close
Set fso = Nothing
WScript.Echo “解析完了。”

—

4. 現場で生き残るための設計上の注意点

このコードを「動く」レベルから「仕事で使える」レベルに引き上げるために、以下の3点を意識せよ。

  • 文字コードの壁を越えろ: `OpenTextFile`はデフォルトでANSIを想定する。UTF-8のログを扱う場合は、`ADODB.Stream`オブジェクトを使用してストリームを制御すべきだ。さもなくば、日本語ログは文字化けの海に沈む。
  • 例外処理の欠如は悪: 本番環境で「ファイルがロックされている」「ディスクフル」は必ず起きる。`On Error Resume Next`を乱用せず、各ステップでエラーチェックを行い、ログファイルへエラー内容を吐き出す設計にせよ。
  • ポインタ管理の厳密さ: 上記のリングバッファは「直前」を保持するものだ。もし「直後」の行も必要なら、フラグを立ててカウンタを回すロジックを追加せよ。これはデバッグツールの要件に応じて柔軟に組み替えるべきだ。

5. 最後に:エンジニアとしての矜持

VBScriptは枯れている。しかし、それは「枯れ木も山の賑わい」ではなく、「堅牢なインフラ」であると言い換えられる。APIや高度なフレームワークに頼らず、言語の基本機能だけで巨大なデータを制御する経験は、君たちの技術的土台を確実に強固にする。

コードは「書く」ものではなく、「設計する」ものだ。明日から、ファイルを不用意に全読み込みするコードを書くのはやめよう。メモリとI/Oを支配する者こそが、業務自動化の勝者となるのだ。

健闘を祈る。

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