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:
clusterinstance(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_ipsource_namespacesource_podsource_workloaddestination_ipdestination_namespacedestination_poddestination_workload
Local Context
For Advanced mode with local context, default context labels are the following for outgoing traffic:
source_ipsource_namespacesource_podsource_workload
For incoming traffic:
destination_ipdestination_namespacedestination_poddestination_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 Name | Description | Extra Labels |
|---|---|---|
drop_count | Basic: dropped packet count | direction, reason |
drop_bytes | Basic: dropped byte count | direction, reason |
adv_drop_count | Advanced/Pod-Level: dropped packet count | direction, reason, context labels |
adv_drop_bytes | Advanced/Pod-Level: dropped byte count | direction, reason, context labels |
Label Values
See Context Labels.
Possible values for direction:
ingress(incoming traffic)egress(outgoing traffic)
Possible values for reason:
IPTABLE_RULE_DROPIPTABLE_NAT_DROPTCP_CONNECT_BASICTCP_ACCEPT_BASICTCP_CLOSE_BASICCONNTRACK_ADD_DROPUNKNOWN_DROP
Plugin: linuxutil (Linux)
Same metrics as Basic mode.
Plugin: dns (Linux)
Metrics enabled when dns plugin is enabled (see Metrics Configuration).
| Metric Name | Description | Extra Labels |
|---|---|---|
dns_request_count | Basic: number of DNS requests by query | query_type, query |
dns_response_count | Basic: number of DNS responses by query, error code, and response value | query_type, query, return_code, response, num_response |
adv_dns_request_count | Advanced/Pod-Level: number of DNS requests by query | query_type, query, context labels |
adv_dns_response_count | Advanced/Pod-Level: number of DNS responses by query, error code, and response value | query_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 Name | Description | Extra Labels |
|---|---|---|
adv_forward_count | Advanced/Pod-Level: forwarded packet count | direction, context labels |
adv_forward_bytes | Advanced/Pod-Level: forwarded byte count | direction, context labels |
adv_tcpflags_count | Advanced/Pod-Level: TCP packet count by flag | flag, context labels |
adv_node_apiserver_latency | Advanced: API Server round trip time for SYN-ACK (histogram) | le (histogram bucket) |
adv_node_apiserver_no_response | Advanced: number of packets that did not get a response from API server | |
adv_node_apiserver_tcp_handshake_latency | Advanced: 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:
FINSYNRSTPSHACKURGECECWRNS
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.
00.51through4.5in increments of 0.5inf
Plugin: tcpretrans (Linux)
Metrics enabled when tcpretrans plugin is enabled (see Metrics Configuration).
| Metric Name | Description | Extra Labels |
|---|---|---|
adv_tcpretrans_count | Advanced/Pod-Level: TCP retransmitted packet count | context labels |
Label Values
See Context Labels.