第18章 Network Observability CLI
18.1. Network Observability CLI のインストール リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI (oc netobserv) は、クラスターのネットワークトラフィックのデバッグとトラブルシューティングに使用されるスタンドアロンの OpenShift CLI (oc) プラグインです。これは、Network Observability Operator とは独立して動作し、ネットワークのパフォーマンスに関する即時診断情報を収集します。
18.1.1. ネットワーク可観測性 CLI の概要 リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI (oc netobserv) を使用して、ネットワークの問題を迅速にデバッグおよびトラブルシューティングします。このツールを使用することで、Network Observability Operator をインストールしなくても、フローとパケットに関するライブ分析情報が即座に提供されます。
Network Observability CLI は、eBPF エージェントを利用して収集したデータを一時的なコレクター Pod にストリーミングするフローおよびパケット可視化ツールです。キャプチャー中に永続的なストレージは必要ありません。実行後、出力がローカルマシンに転送されます。
CLI のキャプチャーは、8 - 10 分などの短い期間のみ実行されるように設計されています。実行時間が長すぎると、実行中のプロセスを削除するのが難しくなる可能性があります。
18.1.2. ネットワーク可観測性 CLI のインストール リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI は、ネットワークオブザーバビリティーのデバッグおよびトラブルシューティングを迅速に行う軽量な方法です。これは、別途インストールする必要があります。
Network Observability CLI (oc netobserv) のインストールは、Network Observability Operator のインストールとは別の手順です。つまり、Operator がソフトウェアカタログからインストールされている場合でも、CLI を別途インストールする必要があります。
ユーザーは、必要に応じて、Krew を使用して netobserv CLI プラグインをインストールできます。詳細は、「Krew を使用した CLI プラグインのインストール」を参照してください。
前提条件
-
OpenShift CLI (
oc) をインストールしておく。 - macOS または Linux オペレーティングシステムがある。
-
dockerまたはpodmanをインストールする必要があります。
インストールコマンドの実行には、podman または docker を使用できます。この手順では podman を使用します。
手順
次のコマンドを実行して、Red Hat レジストリー にログインします。
$ podman login registry.redhat.io次のコマンドを実行して、イメージから
oc-netobservファイルを抽出します。$ podman create --name netobserv-cli registry.redhat.io/network-observability/network-observability-cli-rhel9:1.11 $ podman cp netobserv-cli:/oc-netobserv . $ podman rm netobserv-cli次のコマンドを実行して、抽出したファイルをシステムの
PATHにあるディレクトリー (/usr/local/bin/など) に移動します。$ sudo mv oc-netobserv /usr/local/bin/
検証
oc netobservが利用可能であることを確認します。$ oc netobserv versionこのコマンドを実行すると、次の例のような結果が生成されるはずです。
Netobserv CLI version <version>
18.2. Network Observability CLI の使用 リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI は、ネットワークフローとパケットテレメトリーを端末内で直接フィルタリングおよび可視化します。このツールは、サードパーティーの分析ユーティリティーとのシームレスな統合のために、取得したデータを JSON、データベースファイル、またはパケットキャプチャー (PCAP) ファイルとしてエクスポートします。
18.2.1. キャプチャーフロー リンクのコピーリンクがクリップボードにコピーされました!
ネットワークフローをキャプチャーし、リソースまたはゾーンに基づいてフィルターを CLI で直接適用します。これは、2 つの異なるゾーン間のラウンドトリップタイム (RTT) を可視化するなど、複雑なユースケースを解決するために役立ちます。
CLI 上で表形式の可視化を行うことで、データの閲覧やフローの検索が可能になります。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
Network Observability CLI (
oc netobserv) プラグインがインストールされている。
手順
次のコマンドを実行して、フィルターを有効にしてフローをキャプチャーします。
$ oc netobserv flows --enable_filter=true --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051ターミナルの
live table filterプロンプトでフィルターを追加して、受信するフローをさらに絞り込みます。以下に例を示します。live table filter: [SrcK8S_Zone:us-west-1b] press enter to match multiple regular expressions at once- PageUp キーと PageDown キーを使用して、None、Resource、Zone、Host、Owner、および all of the above を切り替えます。
-
キャプチャーを停止するには、Ctrl+C を押します。キャプチャーされたデータは、CLI のインストールに使用したのと同じパスにある
./outputディレクトリー内の 2 つの異なるファイルに書き込まれます。 キャプチャーされたデータを、JSON ファイル
./output/flow/<capture_date_time>.jsonで確認します。このファイルには、キャプチャーされたデータの JSON 配列が含まれています。JSON ファイルの例:
{ "AgentIP": "10.0.1.76", "Bytes": 561, "DnsErrno": 0, "Dscp": 20, "DstAddr": "f904:ece9:ba63:6ac7:8018:1e5:7130:0", "DstMac": "0A:58:0A:80:00:37", "DstPort": 9999, "Duplicate": false, "Etype": 2048, "Flags": 16, "FlowDirection": 0, "IfDirection": 0, "Interface": "ens5", "K8S_FlowLayer": "infra", "Packets": 1, "Proto": 6, "SrcAddr": "3e06:6c10:6440:2:a80:37:b756:270f", "SrcMac": "0A:58:0A:80:00:01", "SrcPort": 46934, "TimeFlowEndMs": 1709741962111, "TimeFlowRttNs": 121000, "TimeFlowStartMs": 1709741962111, "TimeReceived": 1709741964 }SQLite を使用して、
./output/flow/<capture_date_time>.dbデータベースファイルを検査できます。以下に例を示します。次のコマンドを実行してファイルを開きます。
$ sqlite3 ./output/flow/<capture_date_time>.dbSQLite
SELECTステートメントを実行してデータをクエリーします。次に例を示します。sqlite> SELECT DnsLatencyMs, DnsFlagsResponseCode, DnsId, DstAddr, DstPort, Interface, Proto, SrcAddr, SrcPort, Bytes, Packets FROM flow WHERE DnsLatencyMs >10 LIMIT 10;出力例
12|NoError|58747|10.128.0.63|57856||17|172.30.0.10|53|284|1 11|NoError|20486|10.128.0.52|56575||17|169.254.169.254|53|225|1 11|NoError|59544|10.128.0.103|51089||17|172.30.0.10|53|307|1 13|NoError|32519|10.128.0.52|55241||17|169.254.169.254|53|254|1 12|NoError|32519|10.0.0.3|55241||17|169.254.169.254|53|254|1 15|NoError|57673|10.128.0.19|59051||17|172.30.0.10|53|313|1 13|NoError|35652|10.0.0.3|46532||17|169.254.169.254|53|183|1 32|NoError|37326|10.0.0.3|52718||17|169.254.169.254|53|169|1 14|NoError|14530|10.0.0.3|58203||17|169.254.169.254|53|246|1 15|NoError|40548|10.0.0.3|45933||17|169.254.169.254|53|174|1
18.2.2. キャプチャーパケット リンクのコピーリンクがクリップボードにコピーされました!
ネットワークパケットをキャプチャーするには、Network Observability CLI を使用します。正確なリアルタイムデバッグを実現するために、ターミナル内でフィルターを適用して調整できます。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
Network Observability CLI (
oc netobserv) プラグインがインストールされている。
手順
フィルターを有効にしてパケットキャプチャーを実行します。
$ oc netobserv packets --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051ターミナルの
live table filterプロンプトでフィルターを追加して、受信するパケットを絞り込みます。フィルターの例は次のとおりです。live table filter: [SrcK8S_Zone:us-west-1b] press enter to match multiple regular expressions at once- PageUp キーと PageDown キーを使用して、None、Resource、Zone、Host、Owner、および all of the above を切り替えます。
- キャプチャーを停止するには、Ctrl+C を押します。
キャプチャーされたデータを確認します。このデータは、CLI のインストールに使用したのと同じパスにある
./output/pcapディレクトリー内の 1 つのファイルに書き込まれます。-
./output/pcap/<capture_date_time>.pcapファイルは Wireshark で開くことができます。
-
18.2.3. メトリクスを取得する リンクのコピーリンクがクリップボードにコピーされました!
サービスモニターを使用して、Prometheus でオンデマンドネットワークオブザーバビリティーダッシュボードを生成します。これにより、ネットワークメトリクスをすばやく表示および分析できます。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
Network Observability CLI (
oc netobserv) プラグインがインストールされている。
手順
次のコマンドを実行して、フィルターを有効にしてメトリクスをキャプチャーします。
出力例
$ oc netobserv metrics --enable_filter=true --cidr=0.0.0.0/0 --protocol=TCP --port=49051ターミナルで提供されているリンクを開いて NetObserv / On-Demand ダッシュボードを表示します。
URL の例
https://console-openshift-console.apps.rosa...openshiftapps.com/monitoring/dashboards/netobserv-cli注記有効になっていない機能は空のグラフとして表示されます。
18.2.4. ネットワーク可観測性 CLI のクリーニング リンクのコピーリンクがクリップボードにコピーされました!
oc netobserv cleanup を使用して、Network Observability CLI によってインストールされたすべてのコンポーネントをクラスターから手動で削除します。クライアントはキャプチャー後にこのコマンドを自動的に実行しますが、接続の問題が発生した場合は手動で実行する必要があります。
手順
以下のコマンドを実行します。
$ oc netobserv cleanup
18.3. OpenSSL で暗号化されたネットワークトラフィックからプレーンテキストを取得する リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI を使用して、OpenSSL で暗号化されたネットワークパケットからプレーンテキストのコンテンツをキャプチャーして表示します。この CLI のみの機能は、eBPF プローブを使用して、TLS 証明書または Operator 設定を必要とせずに、暗号化されていないデータをインターセプトおよび表示します。
18.3.1. OpenSSL で暗号化されたトラフィックのプレーンテキストのパケットキャプチャー リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI パケットキャプチャー機能は、OpenSSL 暗号化ネットワークトラフィックの暗号化されていないコンテンツを傍受して表示できます。
この機能は、暗号化されていないペイロードデータを検査する必要がある場合に、暗号化された接続をデバッグするのに役立ちます。
CLI は eBPF プローブを使用して、暗号化前および復号化後に OpenSSL ライブラリー機能を傍受し、TLS 証明書または鍵を必要とせずにプレーンテキストのコンテンツを取得します。
これは、Operator またはエージェント設定を必要としない CLI のみの機能です。
この機能は、次のタスクで特に価値があります。
- OpenSSL で暗号化されたトラフィックでアプリケーションレベルのプロトコルの問題のデバッグ
- サービス間の API 要求および応答ペイロードの確認
- TLS を無効にせずに暗号化されたトラフィックコンテンツを分析します。
- 証明書にアクセスできない暗号化接続のトラブルシューティング
プレーンテキストキャプチャーは現在、OpenSSL で暗号化されたトラフィックのみをサポートします。この機能は、フローレベルのキャプチャーではなく、パケットレベルのキャプチャーに対して oc netobserv packets サブコマンドで動作します。
18.3.1.1. プレーンテキストのキャプチャーの仕組み リンクのコピーリンクがクリップボードにコピーされました!
パケットキャプチャー中にプレーンテキストのキャプチャーを有効にすると、以下のアクションが発生します。
- CLI は、eBPF プローブをターゲットプロセスの OpenSSL ライブラリー関数に割り当てます。
- プローブは、暗号化前(送信トラフィック用)および復号化(着信トラフィック)後にデータをインターセプトします。
- プレーンテキストのコンテンツがキャプチャーされ、標準のパケット情報とともに表示されます。
- 特定のトラフィックに集中するために、Pod の IP、ポート、またはその他の条件でキャプチャーをフィルターできます。
18.3.1.2. 主な考慮事項 リンクのコピーリンクがクリップボードにコピーされました!
プレーンテキストのキャプチャーを使用する場合は、以下の条件を考慮してください。
- 特権アクセス
- CLI では、eBPF プローブを実行中のプロセスに割り当てるのに十分なパーミッションが必要です。cluster-admin 権限または同等のアクセス権がある。
- OpenSSL のみ
-
この機能は、動的にリンクされた
OpenSSLまたはlibsslのみを使用するアプリケーションからプレーンテキストをキャプチャーします。静的OpenSSLまたはその他の TLS ライブラリーを使用するアプリケーションはサポートされません。 - パケットキャプチャーのみ
-
プレーンテキストのキャプチャーは、パケットレベルの集計用の
oc netobserv パケットで動作しますが、フローレベルの集約用のoc netobserv フローでは機能しません。 - パフォーマンスへの影響
- eBPF プローブのパフォーマンスへの影響は最小限ですが、大容量のプレーンテキストデータを取得すると、追加のリソースを消費する可能性があります。フィルターを使用して、実稼働環境でのキャプチャースコープを制限します。
- セキュリティーおよびコンプライアンス
- キャプチャーされたプレーンテキストデータには、パスワード、API キー、個人データなどの機密情報が含まれる場合があります。適切なアクセス制御および保持ポリシーが適用されていることを確認します。
18.3.2. プレーンテキストのパケットキャプチャーの準備 リンクのコピーリンクがクリップボードにコピーされました!
お使いの環境が OpenSSL 暗号化ネットワークトラフィックからプレーンテキストをキャプチャーするための要件を満たしていることを確認します。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
Network Observability CLI (
oc netobserv)プラグインがインストールされている。 -
特権操作を実行する
cluster-admin権限または同等のアクセス権がある。
手順
次のコマンドを実行して、Network Observability CLI プラグインがインストールされていることを確認します。
$ oc netobserv version出力例
NetObserv CLI version 1.12.0次のコマンドを実行して、パケットキャプチャーのターゲットアプリケーションを特定します。
$ oc get pods -n <namespace>-
<
;namespace> を、Pod がデプロイされている namespace の名前に置き換えます。 - TLS 暗号化に OpenSSL を使用するアプリケーションの Pod 名と namespace をメモします。
-
<
次のコマンドを実行して、Pod IP アドレスを取得します。
$ oc get pod <pod_name> -n <namespace> -o jsonpath='{.status.podIP}'次のコマンドを実行して、アプリケーションがリッスンするポートを特定します。
$ oc get pod <pod_name> -n <namespace> -o jsonpath='{.spec.containers[*].ports[*].containerPort}'
検証
以下の例を使用して、パケットキャプチャーに必要な情報があることを確認します。
-
Pod IP アドレス(
10.131.0.15など) -
ポート番号(
8443など) - Pod は TLS 暗号化に OpenSSL を使用します
-
Pod IP アドレス(
これで、OpenSSL プレーンテキスト を使用してパケットキャプチャーに進むことができます。
18.3.3. OpenSSL プレーンテキストが含まれるパケットをキャプチャーします。 リンクのコピーリンクがクリップボードにコピーされました!
ネットワークパケットを取得し、ネットワーク可観測性 CLI を使用して、OpenSSL で暗号化された接続から暗号化されていないプレーンテキストコンテンツを表示します。
前提条件
-
OpenShift CLI (
oc) がインストールされている。 -
Network Observability CLI (
oc netobserv)プラグインがインストールされている。 -
cluster-admin特権を持っている。 - OpenSSL を使用するターゲットアプリケーションの Pod IP アドレスとポートを特定している。
プレーンテキストのパケットキャプチャーは、パスワード、API キー、個人データなどの機密情報が含まれる TLS 接続から暗号化されていないコンテンツを公開します。適切なアクセス制御および保持ポリシーが適用されていることを確認します。必要なくなった時点で、キャプチャーファイルを安全に削除します。
手順
OpenSSL プレーンテキストを有効にしてパケットキャプチャーを開始し、ターゲット Pod の IP およびポートでフィルタリングします。
$ oc netobserv packets --peer_ip=<pod_ip> --port=<pod_port> --enable_openssl<
;pod_ip>を Pod IP アドレスに置き換え、<pod_port>をポート番号に置き換えます。例
$ oc netobserv packets --peer_ip=10.131.0.15 --port=8443 --enable_opensslCLI は、OpenSSL で暗号化された接続からのプレーンテキストデータと共にキャプチャーされたパケットのライブテーブルを表示します。
- Ctrl+Space を押してキャプチャーを一時停止します。
パケットキャプチャー出力に移動します。
- 方向キー(propagate propagate)を使用 してパケットを選択します。
- キャプチャーが一時停止されると、選択したパケットのペイロードが詳細パネルに表示されます。
- Tab を押して、フィルターの入力、パケットテーブル、および詳細パネルをフォーカスします。
- Esc を押してキャプチャーを再開します。
- また、マウスを使用してパケットを選択し、パネル間でフォーカスを移動することもできます。
オプション:追加のフィルターを適用してキャプチャースコープを絞り込みます。
$ oc netobserv packets --peer_ip=<pod_ip> --port=<pod_port> --query='SrcK8S_Namespace="<namespace>" or DstK8S_Namespace="<namespace>"' --protocol=TCP --enable_openssl--protocol、--queryなどのフィルター、または特定のトラフィックに焦点を当てる他のオプションを組み合わせることができます。--queryを使用して、CLI コンポーネントがデプロイされる as-namespaceの変更、namespace でフィルターを行います。オプション:後で分析するためにパケットをファイルにキャプチャします。
$ oc netobserv packets --peer_ip=<pod_ip> --port=<pod_port> --enable_openssl --copyCLI はプレーンテキストのコンテンツを含むキャプチャーされたパケットデータを
./output/pcapディレクトリーに書き込みます。パケットキャプチャーを停止します。
Ctrl+C を押してパケットの取得を停止し、シェルプロンプトに戻ります。
検証
パケットをファイルにキャプチャーした場合は、出力を確認します。
$ ls ./output/pcap/ディレクトリーには、タイムスタンプ付きの
.pcapngキャプチャーファイルが含まれています。パケットレベルの分析のために Wireshark を使用してキャプチャーファイルを開きます。キャプチャーされたプレーンテキストを確認します。
$ ls ./output/plaintext/ディレクトリーには、デコードされたプレーンテキストレコードを含むタイムスタンプ付きの
.jsonlファイルが含まれます。プレーンテキストのキャプチャーを調べます。
$ less ./output/plaintext/<timestamp>.jsonl
18.4. Network Observability CLI (oc netobserv) リファレンス リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI (oc netobserv) は、Network Observability Operator と同等の機能およびフィルター機能を提供します。コマンドライン引数を使用して、機能を動的に切り替えたり、特定のクラスターネットワークトラフィックフローを分離したりできます。
18.4.1. Network Observability CLI の使用 リンクのコピーリンクがクリップボードにコピーされました!
Network Observability CLI (oc netobserv) を使用して、コマンドライン引数を渡してさらに分析するためのフローデータ、パケットデータ、メトリクスをキャプチャーしたり、Network Observability Operator がサポートする機能を有効にしたりできます。
18.4.1.1. 構文 リンクのコピーリンクがクリップボードにコピーされました!
oc netobserv コマンドの基本構文:
oc netobserv の構文
$ oc netobserv [<command>] [<feature_option>] [<command_options>]
機能オプションは、oc netobserv flows コマンドでのみ使用できます。oc netobserv packets コマンドでは使用できません。
18.4.1.2. 基本コマンド リンクのコピーリンクがクリップボードにコピーされました!
| コマンド | 説明 |
|---|---|
| flows | フロー情報をキャプチャーします。サブコマンドは、「フローキャプチャーのオプション」表を参照してください。 |
| packets | パケットデータをキャプチャーします。サブコマンドは、「パケットキャプチャーのオプション」表を参照してください。 |
| metrics | メトリクスデータをキャプチャーします。サブコマンドは、「メトリクスキャプチャーのオプション」の表を参照してください。 |
| follow | バックグラウンドで実行しているときはコレクターログに従います。 |
| stop | エージェントデーモンセットを削除して収集を停止します。 |
| copy | コレクターが生成したファイルをローカルにコピーします。 |
| cleanup | Network Observability CLI コンポーネントを削除します。 |
| version | ソフトウェアのバージョンを出力します。 |
| help | ヘルプを表示します。 |
18.4.1.3. フローキャプチャーのオプション リンクのコピーリンクがクリップボードにコピーされました!
フローキャプチャーには、必須コマンドのほか、パケットドロップ、DNS 遅延、ラウンドトリップタイム、フィルタリングに関する追加機能の有効化などの追加オプションがあります。
oc netobserv flows の構文
$ oc netobserv flows [<feature_option>] [<command_options>]
| オプション | 説明 | デフォルト |
|---|---|---|
| --enable_all | すべての eBPF 機能の有効化 | false |
| --enable_dns | DNS トラッキングの有効化 | false |
| --enable_ipsec | IPsec トラッキングの有効化 | false |
| --enable_network_events | ネットワークイベントモニタリングの有効化 | false |
| --enable_pkt_translation | パケット変換の有効化 | false |
| --enable_pkt_drop | パケットドロップの有効化 | false |
| --enable_rtt | RTT トラッキングの有効化 | false |
| --enable_udn_mapping | ユーザー定義ネットワークマッピングの有効化 | false |
| --get-subnets | サブネット情報の取得 | false |
| --privileged | eBPF エージェント特権モードの強制 | auto |
| --sampling | パケットサンプリング間隔 | 1 |
| --background | バックグラウンドでの実行 | false |
| --copy | 出力ファイルをローカルにコピー | prompt |
| --log-level | コンポーネントログ | info |
| --max-time | 最大キャプチャー時間 | 5m |
| --max-bytes | 最大キャプチャーバイト数 | 50000000 = 50 MB |
| --action | アクションのフィルタリング | Accept |
| --cidr | CIDR のフィルタリング | 0.0.0.0/0 |
| --direction | 方向のフィルタリング | - |
| --dport | 送信先ポートのフィルタリング | - |
| --dport_range | 送信先ポート範囲のフィルタリング | - |
| --dports | 2 つの送信先ポートのどちらかでフィルタリング | - |
| --drops | ドロップされたパケットのみでフローをフィルタリング | false |
| --icmp_code | ICMP コードのフィルタリング | - |
| --icmp_type | ICMP タイプのフィルタリング | - |
| --node-selector | 特定のノードでのキャプチャー | - |
| --peer_ip | ピア IP のフィルタリング | - |
| --peer_cidr | ピア CIDR のフィルタリング | - |
| --port_range | ポート範囲のフィルタリング | - |
| --port | ポートのフィルタリング | - |
| --ports | 2 つのポートのどちらかでフィルタリング | - |
| --protocol | プロトコルのフィルタリング | - |
| --query | カスタムクエリーを使用したフローのフィルタリング | - |
| --sport_range | 送信元ポート範囲のフィルタリング | - |
| --sport | 送信元ポートのフィルタリング | - |
| --sports | 2 つの送信元ポートのどちらかでフィルタリング | - |
| --tcp_flags | TCP フラグのフィルタリング | - |
| --interfaces | 監視するインターフェイスのリスト (コンマ区切り) | - |
| --exclude_interfaces | 除外するインターフェイスのリスト (コンマ区切り) | lo |
PacketDrop および RTT 機能を有効にして TCP プロトコルとポート 49051 でフローキャプチャーを実行する例:
$ oc netobserv flows --enable_pkt_drop --enable_rtt --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051
18.4.1.4. パケットキャプチャーのオプション リンクのコピーリンクがクリップボードにコピーされました!
フィルターを使用すると、フローのキャプチャーと同じようにパケットのキャプチャーデータをフィルタリングできます。パケットドロップ、DNS、RTT、ネットワークイベントなどの特定の機能は、フローおよびメトリクスのキャプチャーでのみ使用できます。動的にリンクする OpenSSL アプリケーションからプレーンテキストをキャプチャーするには、ピアまたはポートフィルターで- enable_openssl を使用します。このオプションには、特権エージェントが必要であり、プレーンテキストのレコードをパケットキャプチャー出力に追加します。
oc netobserv packets の構文
$ oc netobserv packets [<option>]
| オプション | 説明 | デフォルト |
|---|---|---|
| --background | バックグラウンドでの実行 | false |
| --copy | 出力ファイルをローカルにコピー | prompt |
| --log-level | コンポーネントログ | info |
| --max-time | 最大キャプチャー時間 | 5m |
| --max-bytes | 最大キャプチャーバイト数 | 50000000 = 50 MB |
| --enable_openssl | OpenSSL uprobe で TLS プレーンテキストをキャプチャーします。 | false; 特権エージェント。推奨:--peer_ip --port |
| --tls_process_allowlist | TLS uprobes をコンマ区切りのプロセス名に制限する | インフラ以外(例:nginx、envoy) |
| --tls_plaintext_min_bytes | TLS プレーンテキストイベントを N バイトより短くドロップする | 0; エージェント env TLS_PLAINTEXT_MIN_BYTES |
| --tls_plaintext_preview_bytes | PlaintextPreview の長さ。ゼロは完全なペイロードを意味します | 256 |
| --tls-keylog | pcapng 復号化用の SSLKEYLOGFILE へのパス | コレクター設定 |
| --action | アクションのフィルタリング | Accept |
| --cidr | CIDR のフィルタリング | 0.0.0.0/0 |
| --direction | 方向のフィルタリング | - |
| --dport | 送信先ポートのフィルタリング | - |
| --dport_range | 送信先ポート範囲のフィルタリング | - |
| --dports | 2 つの送信先ポートのどちらかでフィルタリング | - |
| --drops | ドロップされたパケットのみでフローをフィルタリング | false |
| --icmp_code | ICMP コードのフィルタリング | - |
| --icmp_type | ICMP タイプのフィルタリング | - |
| --node-selector | 特定のノードでのキャプチャー | - |
| --peer_ip | ピア IP のフィルタリング | - |
| --peer_cidr | ピア CIDR のフィルタリング | - |
| --port_range | ポート範囲のフィルタリング | - |
| --port | ポートのフィルタリング | - |
| --ports | 2 つのポートのどちらかでフィルタリング | - |
| --protocol | プロトコルのフィルタリング | - |
| --query | カスタムクエリーを使用したフローのフィルタリング | - |
| --sport_range | 送信元ポート範囲のフィルタリング | - |
| --sport | 送信元ポートのフィルタリング | - |
| --sports | 2 つの送信元ポートのどちらかでフィルタリング | - |
| --tcp_flags | TCP フラグのフィルタリング | - |
TCP プロトコルとポート 49051 でパケットキャプチャーを実行する例:
$ oc netobserv packets --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051
18.4.1.5. メトリクスキャプチャーのオプション リンクのコピーリンクがクリップボードにコピーされました!
フローキャプチャーと同じように、メトリクスキャプチャーでも機能を有効にしてフィルターを使用できます。生成されたグラフはダッシュボードに適宜表示されます。
oc netobserv metrics 構文
$ oc netobserv metrics [<option>]
| オプション | 説明 | デフォルト |
|---|---|---|
| --enable_all | すべての eBPF 機能の有効化 | false |
| --enable_dns | DNS トラッキングの有効化 | false |
| --enable_ipsec | IPsec トラッキングの有効化 | false |
| --enable_network_events | ネットワークイベントモニタリングの有効化 | false |
| --enable_pkt_translation | パケット変換の有効化 | false |
| --enable_pkt_drop | パケットドロップの有効化 | false |
| --enable_rtt | RTT トラッキングの有効化 | false |
| --enable_udn_mapping | ユーザー定義ネットワークマッピングの有効化 | false |
| --get-subnets | サブネット情報の取得 | false |
| --privileged | eBPF エージェント特権モードの強制 | auto |
| --sampling | パケットサンプリング間隔 | 1 |
| --background | バックグラウンドでの実行 | false |
| --log-level | コンポーネントログ | info |
| --max-time | 最大キャプチャー時間 | 1h |
| --action | アクションのフィルタリング | Accept |
| --cidr | CIDR のフィルタリング | 0.0.0.0/0 |
| --direction | 方向のフィルタリング | - |
| --dport | 送信先ポートのフィルタリング | - |
| --dport_range | 送信先ポート範囲のフィルタリング | - |
| --dports | 2 つの送信先ポートのどちらかでフィルタリング | - |
| --drops | ドロップされたパケットのみでフローをフィルタリング | false |
| --icmp_code | ICMP コードのフィルタリング | - |
| --icmp_type | ICMP タイプのフィルタリング | - |
| --node-selector | 特定のノードでのキャプチャー | - |
| --peer_ip | ピア IP のフィルタリング | - |
| --peer_cidr | ピア CIDR のフィルタリング | - |
| --port_range | ポート範囲のフィルタリング | - |
| --port | ポートのフィルタリング | - |
| --ports | 2 つのポートのどちらかでフィルタリング | - |
| --protocol | プロトコルのフィルタリング | - |
| --query | カスタムクエリーを使用したフローのフィルタリング | - |
| --sport_range | 送信元ポート範囲のフィルタリング | - |
| --sport | 送信元ポートのフィルタリング | - |
| --sports | 2 つの送信元ポートのどちらかでフィルタリング | - |
| --tcp_flags | TCP フラグのフィルタリング | - |
| --include_list | 生成するメトリクス名のリスト (コンマ区切り) | namespace_flows_total,node_ingress_bytes_total,node_egress_bytes_total,workload_ingress_bytes_total |
| --interfaces | 監視するインターフェイスのリスト (コンマ区切り) | - |
| --exclude_interfaces | 除外するインターフェイスのリスト (コンマ区切り) | lo |
TCP ドロップのメトリクスキャプチャーの実行例
$ oc netobserv metrics --enable_pkt_drop --protocol=TCP