プリフライトストレステスト

tools\Run-PreflightStress.ps1 は、HotPDFPreflight コンソールツールをコンパイルし、大規模な PDF ディレクトリに対して 1 ファイルずつ実行し、ファイルごとのレポートとログを書き込み、JSON / Markdown のパフォーマンスベースラインを記録します。各ファイルはタイムアウトの背後に分離されているため、1つの重い PDF が実行全体をブロックすることはありません。デフォルトのタイムアウトは120秒で、大規模な実装制限ファイルが終了するのを許可しつつ、病的な入力を分離します。

デフォルトの実行

powershell -NoProfile -ExecutionPolicy Bypass -File tools\Run-PreflightStress.ps1

デフォルトのサンプルルートは D:\PDFdoc\PDF-Samples です。実行の出力は Tests\PreflightStress\runs\ の下に書き込まれますが、レポートとログはマシン固有であるため、Git では無視されます。

カスタムサンプルルート

powershell -NoProfile -ExecutionPolicy Bypass -File tools\Run-PreflightStress.ps1 `
  -SampleRoot D:\PDFdoc\PDF-Samples `
  -OutputRoot D:\Temp\HotPDFPreflightStress `
  -MaxFiles 1000 `
  -MaxBytes 5242880 `
  -MaxSecondsPerFile 120

メトリクス

ベースラインは、入力ファイルの総数、選択されたファイル数、合計バイト数、選択された最大および最小の入力サイズ、処理済み / 合格 / 失敗 / タイムアウトの数、経過秒数、1秒あたりのファイル数、1秒あたりのMiB、出力形式、選択されたプリセット、ファイルごとのCSVパス、レポートルート、およびログルートをキャプチャします。

失敗の解釈

失敗した行またはタイムアウトした行は、1 つの PDF が現在の実行制限内で処理できなかったことを意味します。スクリプトは引き続きベースラインを書き込み、正常に終了するため、回帰ジョブは証拠を保持できます。失敗、タイムアウト行の急増、またはスループットの急激な低下は、ファイルごとのログとレポートディレクトリを検査するシグナルとして扱ってください。

関連トピック