Metric Families (Pound)

Appendix A Metric Families

This appendix describes metric families returned in the output of openmetrics pound backends (see Metrics).

Metric family: counter pound_uptime ¶: Number of milliseconds elapsed since pound startup.

Metric family: gauge pound_workers ¶

Number of pound workers (see Worker model). Indexed by types:

‘active’: Number of workers currently active.
‘count’: Number of workers running (both idle and active).
‘min’: Minimum number of workers as set by the WorkerMinCount configuration directive (see WorkerMinCount).
‘max’: Maximum number of workers as set by the WorkerMaxCount configuration directive (see WorkerMaxCount).

Example:

pound_workers{type="active"} 2
pound_workers{type="count"} 5
pound_workers{type="max"} 128
pound_workers{type="min"} 5

Metric family: counter pound_queue_len ¶: Number of connections waiting in the input queue.

Metric family: stateset pound_listener_enabled ¶

State of a listener: enabled/disabled. Indexed by the listener ordinal number and, if available, its name.

pound_listener_enabled{listener="0"} 1
pound_listener_enabled{listener="1",listener_name="plain"} 0
pound_listener_enabled{listener="2",listener_name="tls"} 1

Metric family: info pound_listener_info ¶

Description of a listener. Each instance contains the following indices:

‘listener’: Listener ordinal number.
‘listener_name’: Listener name, if set in the ListenHTTP or ListenHTTPS statement (see ListenHTTP).
‘address’: Listener address. For INET family, it is formatted as ‘IP:PORT’, for UNIX sockets, it is the pathname of the socket.
‘protocol’: Either ‘http’ or ‘https’.

The value of this metrics is always ‘1’.

pound_listener_info{listener="0",address="/run/pound.sock",protocol="http"} 1
pound_listener_info{listener="1",listener_name="plain",address="0.0.0.0:80",protocol="http"} 1
pound_listener_info{listener="2",listener_name="tls",address="0.0.0.0:443",protocol="https"} 1

Metric family: stateset pound_service_enabled ¶

State of a particular service.

pound_service_enabled{listener="0",service="0"} 1
pound_service_enabled{listener="1",service="0"} 1
pound_service_enabled{listener="1",listener_name="plain",service="0",service_name="redirect"} 0
pound_service_enabled{listener="2",listener_name="tls",service="0",service_name="metrics"} 1
pound_service_enabled{listener="2",listener_name="tls",service="1",service_name="web"} 1
pound_service_enabled{service="0",service_name="fallback"} 1

Metric family: gauge pound_backends ¶

Number of backends per service: total, alive, enabled, and active (both alive and enabled). Indices:

listener: Listener ordinal number. This index is absent for globally defined services.
listener_name: Name of the listener. Present only if the name is set and not empty.
service: Index of the service in listener (or in global configuration, for globally defined services).
service_name: Name of the service. Present only if the name is set and not empty.
state: Backend state: ‘total’, ‘alive’, ‘enabled’, or ‘active’.
service_name: Name of the service. Present only if the name is set and not empty.

Example:

pound_backends{listener="0",listener_name="plain",service="0",service_name="web",state="total"} 5
pound_backends{listener="0",listener_name="plain",,service="0",service_name="web",state="enabled"} 3
pound_backends{listener="0",listener_name="plain",,service="0",service_name="web",state="alive"} 3
pound_backends{service="0",state="total"} 1
pound_backends{service="0",state="enabled"} 1
pound_backends{service="0",state="alive"} 1

Metric family: stateset pound_backend_state ¶

State of each backend. Indices:

listener: Listener ordinal number. This index is absent for globally defined services.
listener_name: Name of the listener. Present only if the name is set and not empty.
service: Index of the service in listener (or in global configuration, for globally defined services).
service_name: Name of the service. Present only if the name is set and not empty.
backend: Index of the backend in service.
state: ‘enabled’: whether the backend is enabled or not.
‘alive’: whether the backend is alive or not.

Example:

pound_backend_state{listener="0",service="0",backend="0",state="alive"} 1
pound_backend_state{listener="0",service="0",backend="0",state="enabled"} 1
pound_backend_state{listener="0",service="0",backend="1",state="alive"} 1
pound_backend_state{listener="0",service="0",backend="1",state="enabled"} 0

Metric family: gauge pound_backend_requests ¶

Number of requests processed by backend. This metrics is available only if backend statistics is enabled (see BackendStats).

Example:

pound_backend_requests{listener="0",service="0",backend="0"} 40587
pound_backend_requests{listener="1",service="0",backend="0"} 13858

Metric family: gauge pound_backend_request_time_avg_nanoseconds ¶

Average time per request spent in backend (nanoseconds). This metrics is available only if backend statistics is enabled (see BackendStats).

pound_backend_request_time_avg_nanoseconds{listener="0",service="0",backend="0"} 156254
pound_backend_request_time_avg_nanoseconds{listener="1",service="2",backend="0"} 26147

Metric family: gauge pound_backend_request_stddev_nanoseconds ¶

Standard deviation of the average time per request. This metrics is available only if backend statistics is enabled (see BackendStats).

pound_backend_request_stddev_nanoseconds{listener="0",service="0",backend="0"} 0
pound_backend_request_stddev_nanoseconds{listener="1",service="2",backend="0"} 59