第2章 よくあるエラー状態
ほとんどのエラーは、Collector の起動中に、Collector が自身を設定して eBPF プローブをシステムにロードするときに発生します。
Collector の起動プロセスには、次の段階が含まれます。
- 解析設定
- ホスト分析
- Sensor への接続
- eBPF プローブのロード
いずれのステップでも発生した失敗はすべて致命的とみなされます。起動手順のいずれかの部分が失敗した場合、ログにはどのステップが成功または失敗したかの詳細を含む診断概要が表示されます。
次のログファイルの例は、正常な起動を示しています。
[INFO 2025/07/24 10:05:54] == Collector Startup Diagnostics: ==
[INFO 2025/07/24 10:05:54] Connected to Sensor? false
[INFO 2025/07/24 10:05:54] Kernel driver candidates:
[INFO 2025/07/24 10:05:54] core_bpf (available)
[INFO 2025/07/24 10:05:54] Driver loaded into kernel: core_bpf
[INFO 2025/07/24 10:05:54] ====================================
ログ出力は、Collector がセンサーに接続され、eBPF プローブがロードされたことを確認します。このログを使用して、Collector が正常に起動したかどうかを確認できます。
2.1. Sensor に接続できない リンクのコピーリンクがクリップボードにコピーされました!
起動したら、まず Sensor に接続できるかを確認します。Sensor は、ネットワークイベントを処理するためのカーネルドライバーと CIDR ブロックのダウンロードを実行し、起動プロセスの重要な部分となっています。次のログは、Sensor に接続できないことを示しています。
Collector Version: 3.15.0
OS: Ubuntu 20.04.4 LTS
Kernel Version: 5.4.0-126-generic
[...]
[INFO 2023/05/13 12:20:43] Sensor configured at address: sensor.stackrox.svc:9998
[INFO 2023/05/13 12:20:43] Attempting to connect to Sensor
[INFO 2023/05/13 12:21:13]
[INFO 2023/05/13 12:21:13] == Collector Startup Diagnostics: ==
[INFO 2023/05/13 12:21:13] Connected to Sensor? false
[INFO 2023/05/13 12:21:13] Kernel driver candidates:
[INFO 2023/05/13 12:21:13] ====================================
[INFO 2023/05/13 12:21:13]
[FATAL 2023/05/13 12:21:13] Unable to connect to Sensor at 'sensor.stackrox.svc:9998'.
このエラーは、Sensor が正しく起動していないか、Collector の設定が正しくないことを意味している可能性があります。この問題を解決するには、Collector の設定を確認して、Sensor アドレスが正しく、Sensor Pod が正しく実行されていることを確認する必要があります。
Collector ログを表示して、設定された Sensor アドレスを具体的に確認します。または、次のコマンドを実行できます。
$ kubectl -n stackrox get pod <collector_pod_name> -o jsonpath='{.spec.containers[0].env[?(@.name=="GRPC_SERVER")].value}'
各項目の説明:
<collector_pod_name>-
Collector Pod の名前を指定します(例:
collector-vclg5)。