プレビュー版
このガイドはプレビュー版です。内容は今後変わることがあります。
スキャンでエラーが出て、結果が更新されないとき#
困ったときに読む
スキャンのエラーは、問い合わせの多いつまずきの1つです。まず、どこにどんなエラーが出ているかを確かめてから、下の原因を順に見てください。
まず確認してください#
- どこに出ているエラーか：スキャン履歴の「エラー」表示、
scan.logのメッセージ、エラーのお知らせメールの本文のどれかを確かめます。 - スキャンの種類：Linux のローカルスキャン、Windows、Trivy、Docker（ECR など）のどれか。種類によって見る場所が変わります。
- スキャナが最新か：スキャナの不具合の修正は、最新の版にだけ入ります。古い版のままだとエラーになることがあります（スキャナの更新）。
よくある原因と対処#
A. Timed Out と出る
スキャンの処理が、既定の待ち時間（300秒）を超えています。待ち時間を長くすると解消することがあります。
- Linux：
/opt/vuls-saas/vuls-saas.shを開き、./vuls scan -ips ...を./vuls scan -timeout 600 -ips ...に変えます。 - Windows：
C:\Program Files\vuls-saas\vuls-saas.batを開き、vuls.exe scan ...に-timeout 600を足します。
B. scan.log に Permission Denied と出る
root ユーザで手動スキャンすると、設定ファイル config.toml の持ち主が root に変わり、いつもスキャンを実行している vuls-saas ユーザが使えなくなります。
chown -R vuls-saas:vuls-saas /opt/vuls-saas/を実行して、持ち主を戻します。- 手動でスキャンするときも、vuls-saas ユーザで実行してください。
C. ログ上はスキャンが成功しているのに、結果が画面に出ない
スキャンの種類ごとに確認する点が違います。Linux と Trivy は、下の関連記事をご覧ください。
D. エラーの数十分後に、自動でスキャンがやり直される
仕様です。一時的なエラーに備えて、自動でやり直しています。
E. Windows 11 26H2 のサーバで、更新プログラム（KB）の状況が取れない
Windows 11 26H2 には、スキャナ v0.42.0 以降が必要です。古いスキャナでは 25H2 として扱われ、KB の適用状況を取得できません。スキャナを更新してください。
つまずいたとき#
このページで解決しない場合は、お問い合わせ窓口からご連絡ください。scan.log（Linux は /opt/vuls-saas/）を添えていただくと、調査が早くなります。