Statistics

Listener

Every listener has a statistics tree rooted at listener.<address>. with the following statistics:

Name

Type

Description

downstream_cx_total

Counter

Total connections

downstream_cx_destroy

Counter

Total destroyed connections

downstream_cx_active

Gauge

Total active connections

downstream_cx_length_ms

Histogram

Connection length milliseconds

downstream_pre_cx_timeout

Counter

Sockets that timed out during listener filter processing

downstream_pre_cx_active

Gauge

Sockets currently undergoing listener filter processing

no_filter_chain_match

Counter

Total connections that didn’t match any filter chain

ssl.connection_error

Counter

Total TLS connection errors not including failed certificate verifications

ssl.handshake

Counter

Total successful TLS connection handshakes

ssl.session_reused

Counter

Total successful TLS session resumptions

ssl.no_certificate

Counter

Total successful TLS connections with no client certificate

ssl.fail_verify_no_cert

Counter

Total TLS connections that failed because of missing client certificate

ssl.fail_verify_error

Counter

Total TLS connections that failed CA verification

ssl.fail_verify_san

Counter

Total TLS connections that failed SAN verification

ssl.fail_verify_cert_hash

Counter

Total TLS connections that failed certificate pinning verification

ssl.ciphers.<cipher>

Counter

Total successful TLS connections that used cipher <cipher>

ssl.curves.<curve>

Counter

Total successful TLS connections that used ECDHE curve <curve>

ssl.sigalgs.<sigalg>

Counter

Total successful TLS connections that used signature algorithm <sigalg>

ssl.versions.<version>

Counter

Total successful TLS connections that used protocol version <version>

Per-handler Listener Stats

Every listener additionally has a statistics tree rooted at listener.<address>.<handler>. which contains per-handler statistics. As described in the threading model documentation, Envoy has a threading model which includes the main thread as well as a number of worker threads which are controlled by the --concurrency option. Along these lines, <handler> is equal to main_thread, worker_0, worker_1, etc. These statistics can be used to look for per-handler/worker imbalance on either accepted or active connections.

Name

Type

Description

downstream_cx_total

Counter

Total connections on this handler.

downstream_cx_active

Gauge

Total active connections on this handler.

Listener manager

The listener manager has a statistics tree rooted at listener_manager. with the following statistics. Any : character in the stats name is replaced with _.

Name

Type

Description

listener_added

Counter

Total listeners added (either via static config or LDS)

listener_modified

Counter

Total listeners modified (via LDS)

listener_removed

Counter

Total listeners removed (via LDS)

listener_stopped

Counter

Total listeners stopped

listener_create_success

Counter

Total listener objects successfully added to workers

listener_create_failure

Counter

Total failed listener object additions to workers

total_listeners_warming

Gauge

Number of currently warming listeners

total_listeners_active

Gauge

Number of currently active listeners

total_listeners_draining

Gauge

Number of currently draining listeners

workers_started

Gauge

A boolean (1 if started and 0 otherwise) that indicates whether listeners have been initialized on workers.