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.