Skip to main content

Advanced Metrics

There are two Advanced modes (see Metric Modes) which include all Basic Metrics plus extra metrics providing Pod-Level context.

The two Advanced modes are remote context and local context. The difference lies in the Context Labels. Additionally, local context supports Annotations.

Prefix

All metrics have the prefix networkobservability_.

Universal Labels

Node and Cluster metadata are included with the labels:

  • cluster
  • instance (Node name)

Context Labels

There are Pod-Level context labels for metrics prepended with adv_.

To customize context labels, see MetricsConfiguration CRD.

Remote Context

For Advanced mode with remote context, default context labels are the following:

  • source_ip
  • source_namespace
  • source_pod
  • source_workload
  • destination_ip
  • destination_namespace
  • destination_pod
  • destination_workload

Local Context

For Advanced mode with local context, default context labels are the following for outgoing traffic:

  • source_ip
  • source_namespace
  • source_pod
  • source_workload

For incoming traffic:

  • destination_ip
  • destination_namespace
  • destination_pod
  • destination_workload

List of Metrics

Plugin: packetforward (Linux)

Same metrics as Basic mode.

Plugin: dropreason (Linux)

Metrics enabled when dropreason plugin is enabled (see Metrics Configuration).

Metric NameDescriptionExtra Labels
drop_countBasic: dropped packet countdirection, reason
drop_bytesBasic: dropped byte countdirection, reason
adv_drop_countAdvanced/Pod-Level: dropped packet countdirection, reason, context labels
adv_drop_bytesAdvanced/Pod-Level: dropped byte countdirection, reason, context labels

Label Values

See Context Labels.

Possible values for direction:

  • ingress (incoming traffic)
  • egress (outgoing traffic)

Possible values for reason:

  • IPTABLE_RULE_DROP
  • IPTABLE_NAT_DROP
  • TCP_CONNECT_BASIC
  • TCP_ACCEPT_BASIC
  • TCP_CLOSE_BASIC
  • CONNTRACK_ADD_DROP
  • UNKNOWN_DROP

Plugin: linuxutil (Linux)

Same metrics as Basic mode.

Plugin: dns (Linux)

Metrics enabled when dns plugin is enabled (see Metrics Configuration).

Metric NameDescriptionExtra Labels
dns_request_countBasic: number of DNS requests by queryquery_type, query
dns_response_countBasic: number of DNS responses by query, error code, and response valuequery_type, query, return_code, response, num_response
adv_dns_request_countAdvanced/Pod-Level: number of DNS requests by queryquery_type, query, context labels
adv_dns_response_countAdvanced/Pod-Level: number of DNS responses by query, error code, and response valuequery_type, query, return_code, response, num_response, context labels

Plugin: hnsstats (Windows)

Same metrics as Basic mode.

Plugin: packetparser (Linux)

Metrics enabled when packetparser plugin is enabled (see Metrics Configuration).

Metric NameDescriptionExtra Labels
adv_forward_countAdvanced/Pod-Level: forwarded packet countdirection, context labels
adv_forward_bytesAdvanced/Pod-Level: forwarded byte countdirection, context labels
adv_tcpflags_countAdvanced/Pod-Level: TCP packet count by flagflag, context labels
adv_node_apiserver_latencyAdvanced: API Server round trip time for SYN-ACK (histogram)le (histogram bucket)
adv_node_apiserver_no_responseAdvanced: number of packets that did not get a response from API server
adv_node_apiserver_tcp_handshake_latencyAdvanced: API Server latency in establishing connection (histogram)le (histogram bucket)

Note: API Server metrics help identify degradation of Node-to-API-server connection. The metrics were born out of a real-life incident, where Node-to-API-server latency was the root cause.

Label Values

See Context Labels.

Possible values for direction:

  • ingress (incoming traffic)
  • egress (outgoing traffic)

Possible values for flag:

  • FIN
  • SYN
  • RST
  • PSH
  • ACK
  • URG
  • ECE
  • CWR
  • NS

Possible values for le (for API server metrics). Units are in milliseconds. le stands for "less than or equal". See Prometheus histogram documentation for more info.

  • 0
  • 0.5
  • 1 through 4.5 in increments of 0.5
  • inf

Plugin: tcpretrans (Linux)

Metrics enabled when tcpretrans plugin is enabled (see Metrics Configuration).

Metric NameDescriptionExtra Labels
adv_tcpretrans_countAdvanced/Pod-Level: TCP retransmitted packet countcontext labels

Label Values

See Context Labels.