ネットワークメトリクス

OpenTelemetry eBPF 計装は、異なるエンドポイント間のネットワークメトリクスを提供するように設定できます。 たとえば、物理ノード、コンテナ、Kubernetes Pod、サービスなどの間です。

はじめに

OBI ネットワークメトリクスの使用を開始するには、クイックスタートセットアップドキュメントを参照し、高度な設定については、設定ドキュメントを参照してください。

ネットワークメトリクス

OBI はバイトおよびパケットのフローメトリクスと、ゾーン間バイトメトリクスを提供します。

フローメトリクス: アプリケーションの観点から、異なるエンドポイント間で送受信されたバイト数をキャプチャします。

• obi.network.flow.bytes（OpenTelemetry 経由でエクスポートする場合）
• obi_network_flow_bytes_total（Prometheus エンドポイントでエクスポートする場合）
• 有効にするには、OTEL_EBPF_METRICS_FEATURES 設定オプションに network オプションを追加します。

フローパケットメトリクス: エンドポイント間で送受信されたパケット数をカウントします。

• obi.network.flow.packets（OpenTelemetry 経由でエクスポートする場合）
• obi_network_flow_packets_total（Prometheus エンドポイントでエクスポートする場合）
• 有効にするには、OTEL_EBPF_METRICS_FEATURES に network_flow_packets オプションを追加します。

ゾーン間メトリクス: アプリケーションの観点から、異なるアベイラビリティゾーン間で送受信されたバイト数をキャプチャします。

• obi.network.inter.zone.bytes（OpenTelemetry 経由でエクスポートする場合）
• obi_network_inter_zone_bytes_total（Prometheus エンドポイントでエクスポートする場合）
• 有効にするには、OTEL_EBPF_METRICS_FEATURES 設定オプションに network_inter_zone オプションを追加します。

デフォルトでは、ネットワークフローバイトについて以下の属性のみが報告されます。 k8s.src.owner.name、k8s.src.namespace、k8s.dst.owner.name、k8s.dst.namespace、k8s.cluster.name です。

ゾーン間バイトメトリクスのデフォルト属性は、k8s.cluster.name、src.zone、dst.zone です。

メトリクス属性

ネットワークメトリクスには、以下の属性でラベルが付けられます。

メトリクスの削減

高カーディナリティ削減のために、ネットワークメトリクスは、メトリクスバックエンドへ送信されるメトリクス数を減らすようにプロセスレベルで事前集約されます。

デフォルトでは、すべてのメトリクスは以下の属性で集約されます。

• direction
• transport
• src.address
• dst.address
• src.port
• dst.port

OBI の設定で許可する属性を指定することで、その属性によってメトリクスを集約できます。

たとえば、ネットワークメトリクスをデフォルトの個別の Pod 名のかわりに、送信元と宛先の Kubernetes オーナーによって集約するには、以下の設定を使用します。

network:
  allowed_attributes:
    - k8s.src.owner.name
    - k8s.dst.owner.name
    - k8s.src.owner.type
    - k8s.dst.owner.type

次に、同等の Prometheus メトリクスは以下のようになります。

obi_network_flow_bytes:
  k8s_src_owner_name="frontend"
  k8s_src_owner_type="deployment"
  k8s_dst_owner_name="backend"
  k8s_dst_owner_type="deployment"

前述の例では、個別の Pod 名のかわりに、送信元と宛先の Kubernetes オーナー名とタイプによって obi.network.flow.bytes の値を集約します。

CIDR ベースのメトリクス

OBI を設定して、CIDR 範囲によってメトリクスをさらに分類することもできます。 これは、クラウドプロバイダーの IP 範囲や内部/外部トラフィックなど、特定のネットワーク範囲へのトラフィックを追跡するのに役立ちます。

network 内の cidrs YAML サブセクション（または OTEL_EBPF_NETWORK_CIDRS 環境変数）は、CIDR 範囲と対応する名前のリストを受け入れます。 たとえば、次のようになります。

network:
  cidrs:
    - cidr: 10.0.0.0/8
      name: 'cluster-internal'
    - cidr: 192.168.0.0/16
      name: 'private'
    - cidr: 172.16.0.0/12
      name: 'container-internal'

次に、同等の Prometheus メトリクスは以下のようになります。

obi_network_flow_bytes:
  src_cidr="cluster-internal"
  dst_cidr="private"