このページでは、イベントストリーミングクライアントの操作方法とトラブルシューティングに関するヘルプ情報を提供します。
保守作業
- 強制的な設定更新（2分ごとに自動的に実行されます）：
docker restart nsstreamingclient - すべてのイベントがすべてのSIEMに送信されないようにするには：宛先オブジェクトを無効にします
- ストリーミングクライアントのいずれかがイベントを受信および処理するのを停止します: クライアントオブジェクトを無効にします
- SIEMターゲットのイベント受信を停止する：関連する宛先ターゲットを無効にする
- イベントフォーマットの変更：新しいフォーマットを作成し、宛先のフォーマットIDを置き換えます（必要に応じて簡単にロールバックできるようにするため）。
- プロトコル、クライアント、フォーマットタイプの変更: 本番環境で互換性のない変更を行う場合は、新しい宛先を作成し、有効な宛先を切り替える (宛先オブジェクトとログストリーミング構成の両方で) ことで、簡単にロールバックできるようにすることをお勧めします。アクティブな宛先を編集することも可能です。
- ストリーミングクライアントの追加/削除: 永続的な変更を行うには、宛先オブジェクトを編集してターゲットを追加/削除します。一時的な変更を行う場合は、クライアントオブジェクトまたはターゲットを無効にすることをお勧めします。
- イベントストリーミングクライアントの手動アップグレード：インストールスクリプトを
reinstallオプション付きで実行します。
トラブルシューティング
バージョン識別
インストーラーとコンテナの両方には、識別可能なバージョンがあります。
- インストーラーは実行時にバージョンをプロンプトします(
I.2025.11.1のようなI.を使う 開始バージョン)
>python3 netskope_event_streamingclient_installer.py NETSKOPE LOG STREAM CLIENT INSTALLER I.2025.11.1 Please specify an option: 1. install - Set up and configure the container 2. reinstall - Remove and recreate the container 3. uninstall - Remove the container and cleanup Enter option (install/reinstall/uninstall):
- コンテナは開始時にバージョンをログに記録しており、コマンド
docker logs nsstreamingclient 2>/dev/null |grep "client version"(C.のようなC.2025.11.1を伴うバージョン開始)
で確認できます。例:
# docker logs nsstreamingclient 2>/dev/null |grep "client version"
Install Log: NS Streaming client version number : C.2025.11.1
{"level":"info","timestamp":"2025-12-03T14:23:22.389Z","caller":"log/log.go:86","msg":"NS Streaming client version number : C.2025.11.1"}
既知の動作
- ログストリーミングをストリーミングクライアントに初期設定すると、有効になるまでに1時間かかる場合があります。
- ログストリーミングAPIから返されるステータスが「実行中」であることを確認してください（15分後）。
- 設定後、最大1時間お待ちください。
- 別の宛先IDへのログストリーミングの更新は、反映されるまでに15分かかります。
SIEMでログが受信されない場合のトラブルシューティング手順
- Dockerログとディスク上のログを確認してメッセージを確認してください。
- 設定が完了していることを確認してください。
- ログストリーミング
- Destination
- すべてのオブジェクトが有効になっていることを確認してください。
- クライアント
- Destination
- 目的地
- SIEMがイベントストリーミングクライアントからのSyslogを受け入れるように構成されていることを確認してください（TCPかUDPかを確認してください）。
- リクエストが生成されていることを確認するには、以下のいずれかを確認してください。
- 現在のトランザクションイベントログのエクスポート
- Skope IT: インラインアクセス方法のページイベント
メッセージの詳細
gRPC接続エラー
{"level":"info","timestamp":"2025-08-29T11:23:08.666Z","caller":"log/log.go:77","msg":"GRPC connection error, retrying","error":"rpc error: code = Unavailable desc = connection error: desc = \"transport: Error while dialing: dial tcp 31.xxx.xxx.xxx:50051: connect: connection refused\"","attempt":5}
理由：ポート50051はファイアウォールによってブロックされている可能性が高い。
コンテナグループは無効になっています
{"level":"info","timestamp":"2025-09-02T12:01:44.602Z","caller":"log/log.go:86","msg":"Container group is disabled, skipping stream creation","containerId":"0198f0"}
イベントストリーミングクライアントの設定が完了していません。このクライアントにはイベントは送信されません。
設定成功
{"level":"info","timestamp":"2025-08-29T11:25:49.060Z","caller":"log/log.go:77","msg":"Successfully registered with Proxy","groupId":"0198ebf7c785","connID":"c2a8f8e1c9c45c4f"}
{"level":"info","timestamp":"2025-08-29T11:25:49.060Z","caller":"log/log.go:77","msg":"Starting the Log streamer","containerId":"0198f545010"}
{"level":"info","timestamp":"2025-08-29T11:25:49.060Z","caller":"log/log.go:77","msg":"Starting the Log reader","groupId":"0198eb585","connID":"c2a8b651"}
ログ処理が正常に完了しました
{"level":"info","timestamp":"2025-08-29T11:35:35.304Z","caller":"log/log.go:77","msg":"Start to receive file","fname":"0c3be6ff8c2f5f"}
{"level":"info","timestamp":"2025-08-29T11:35:35.493Z","caller":"log/log.go:77","msg":"Successfully processed file","fname":"0c35f","dt":28,"crt":47,"ct":135,"st":109,"t":189,"end2endMs":189,"ContainerId":"0198f544-6890","ConnectionId":"922e4f87"}
すべての値はミリ秒単位です。
dt: 減圧時間crt: csv 読む時間ct変換時間st: syslog 時刻tおよびend2end: エンドツーエンド時間