第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 を使用します。

手順

  1. 次のコマンドを実行して、Red Hat レジストリー にログインします。

    $ podman login registry.redhat.io
  2. 次のコマンドを実行して、イメージから 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
  3. 次のコマンドを実行して、抽出したファイルをシステムの PATH にあるディレクトリー (/usr/local/bin/ など) に移動します。

    $ sudo mv oc-netobserv /usr/local/bin/

検証

  1. 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) プラグインがインストールされている。

手順

  1. 次のコマンドを実行して、フィルターを有効にしてフローをキャプチャーします。

    $ oc netobserv flows --enable_filter=true --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051
  2. ターミナルの live table filter プロンプトでフィルターを追加して、受信するフローをさらに絞り込みます。以下に例を示します。

    live table filter: [SrcK8S_Zone:us-west-1b] press enter to match multiple regular expressions at once
  3. PageUp キーと PageDown キーを使用して、None、Resource、Zone、Host、Owner、および all of the above を切り替えます。
  4. キャプチャーを停止するには、Ctrl+C を押します。キャプチャーされたデータは、CLI のインストールに使用したのと同じパスにある ./output ディレクトリー内の 2 つの異なるファイルに書き込まれます。
  5. キャプチャーされたデータを、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
    }

  6. SQLite を使用して、./output/flow/<capture_date_time>.db データベースファイルを検査できます。以下に例を示します。

    1. 次のコマンドを実行してファイルを開きます。

      $ sqlite3 ./output/flow/<capture_date_time>.db
    2. SQLite 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) プラグインがインストールされている。

手順

  1. フィルターを有効にしてパケットキャプチャーを実行します。

    $ oc netobserv packets --action=Accept --cidr=0.0.0.0/0 --protocol=TCP --port=49051
  2. ターミナルの live table filter プロンプトでフィルターを追加して、受信するパケットを絞り込みます。フィルターの例は次のとおりです。

    live table filter: [SrcK8S_Zone:us-west-1b] press enter to match multiple regular expressions at once
  3. PageUp キーと PageDown キーを使用して、None、Resource、Zone、Host、Owner、および all of the above を切り替えます。
  4. キャプチャーを停止するには、Ctrl+C を押します。
  5. キャプチャーされたデータを確認します。このデータは、CLI のインストールに使用したのと同じパスにある ./output/pcap ディレクトリー内の 1 つのファイルに書き込まれます。

    1. ./output/pcap/<capture_date_time>.pcap ファイルは Wireshark で開くことができます。

18.2.3. メトリクスを取得する

サービスモニターを使用して、Prometheus でオンデマンドネットワークオブザーバビリティーダッシュボードを生成します。これにより、ネットワークメトリクスをすばやく表示および分析できます。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • Network Observability CLI (oc netobserv) プラグインがインストールされている。

手順

  1. 次のコマンドを実行して、フィルターを有効にしてメトリクスをキャプチャーします。

    出力例

    $ oc netobserv metrics --enable_filter=true --cidr=0.0.0.0/0 --protocol=TCP --port=49051

  2. ターミナルで提供されているリンクを開いて 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. プレーンテキストのキャプチャーの仕組み

パケットキャプチャー中にプレーンテキストのキャプチャーを有効にすると、以下のアクションが発生します。

  1. CLI は、eBPF プローブをターゲットプロセスの OpenSSL ライブラリー関数に割り当てます。
  2. プローブは、暗号化前(送信トラフィック用)および復号化(着信トラフィック)後にデータをインターセプトします。
  3. プレーンテキストのコンテンツがキャプチャーされ、標準のパケット情報とともに表示されます。
  4. 特定のトラフィックに集中するために、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 権限または同等のアクセス権がある。

手順

  1. 次のコマンドを実行して、Network Observability CLI プラグインがインストールされていることを確認します。

    $ oc netobserv version

    出力例

    NetObserv CLI version 1.12.0

  2. 次のコマンドを実行して、パケットキャプチャーのターゲットアプリケーションを特定します。

    $ oc get pods -n <namespace>
    • &lt ;namespace&gt; を、Pod がデプロイされている namespace の名前に置き換えます。
    • TLS 暗号化に OpenSSL を使用するアプリケーションの Pod 名と namespace をメモします。
  3. 次のコマンドを実行して、Pod IP アドレスを取得します。

    $ oc get pod <pod_name> -n <namespace> -o jsonpath='{.status.podIP}'
  4. 次のコマンドを実行して、アプリケーションがリッスンするポートを特定します。

    $ oc get pod <pod_name> -n <namespace> -o jsonpath='{.spec.containers[*].ports[*].containerPort}'

検証

  • 以下の例を使用して、パケットキャプチャーに必要な情報があることを確認します。

    • Pod IP アドレス( 10.131.0.15など)
    • ポート番号( 8443など)
    • Pod は TLS 暗号化に OpenSSL を使用します

これで、OpenSSL プレーンテキスト を使用してパケットキャプチャーに進むことができます。

18.3.3. OpenSSL プレーンテキストが含まれるパケットをキャプチャーします。

ネットワークパケットを取得し、ネットワーク可観測性 CLI を使用して、OpenSSL で暗号化された接続から暗号化されていないプレーンテキストコンテンツを表示します。

前提条件

  • OpenShift CLI (oc) がインストールされている。
  • Network Observability CLI (oc netobserv)プラグインがインストールされている。
  • cluster-admin 特権を持っている。
  • OpenSSL を使用するターゲットアプリケーションの Pod IP アドレスとポートを特定している。
警告

プレーンテキストのパケットキャプチャーは、パスワード、API キー、個人データなどの機密情報が含まれる TLS 接続から暗号化されていないコンテンツを公開します。適切なアクセス制御および保持ポリシーが適用されていることを確認します。必要なくなった時点で、キャプチャーファイルを安全に削除します。

手順

  1. OpenSSL プレーンテキストを有効にしてパケットキャプチャーを開始し、ターゲット Pod の IP およびポートでフィルタリングします。

    $ oc netobserv packets --peer_ip=<pod_ip> --port=<pod_port> --enable_openssl

    &lt ;pod_ip> を Pod IP アドレスに置き換え、&lt ;pod_port> をポート番号に置き換えます。

    例

    $ oc netobserv packets --peer_ip=10.131.0.15 --port=8443 --enable_openssl

    CLI は、OpenSSL で暗号化された接続からのプレーンテキストデータと共にキャプチャーされたパケットのライブテーブルを表示します。

  2. Ctrl+Space を押してキャプチャーを一時停止します。
  3. パケットキャプチャー出力に移動します。

    • 方向キー(propagate propagate)を使用 してパケットを選択します。
    • キャプチャーが一時停止されると、選択したパケットのペイロードが詳細パネルに表示されます。
    • Tab を押して、フィルターの入力、パケットテーブル、および詳細パネルをフォーカスします。
    • Esc を押してキャプチャーを再開します。
    • また、マウスを使用してパケットを選択し、パネル間でフォーカスを移動することもできます。
  4. オプション:追加のフィルターを適用してキャプチャースコープを絞り込みます。

    $ 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 でフィルターを行います。

  5. オプション:後で分析するためにパケットをファイルにキャプチャします。

    $ oc netobserv packets --peer_ip=<pod_ip> --port=<pod_port> --enable_openssl --copy

    CLI はプレーンテキストのコンテンツを含むキャプチャーされたパケットデータを ./output/pcap ディレクトリーに書き込みます。

  6. パケットキャプチャーを停止します。

    Ctrl+C を押してパケットの取得を停止し、シェルプロンプトに戻ります。

検証

  1. パケットをファイルにキャプチャーした場合は、出力を確認します。

    $ ls ./output/pcap/

    ディレクトリーには、タイムスタンプ付きの .pcapng キャプチャーファイルが含まれています。パケットレベルの分析のために Wireshark を使用してキャプチャーファイルを開きます。

  2. キャプチャーされたプレーンテキストを確認します。

    $ ls ./output/plaintext/

    ディレクトリーには、デコードされたプレーンテキストレコードを含むタイムスタンプ付きの .jsonl ファイルが含まれます。

  3. プレーンテキストのキャプチャーを調べます。

    $ 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. 基本コマンド

表18.1 基本コマンド
コマンド説明

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

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る