Nginx integration metrics

The official Datadog integration for monitoring Nginx. It collects 245 metrics.

Definitions as of 2026-08-07

Official summary

Monitor connection and request metrics. Get more metrics with NGINX Plus.

Metric types

gauge (value at a point in time): 132
count (occurrences in the interval): 108
rate (per second): 5

Metrics

Descriptions are the official definitions, unedited.

Metric	Type	Unit
`nginx.cache.bypass.bytes`The total number of bytes read from the proxied server	gauge	byte
`nginx.cache.bypass.bytes_count`The total number of bytes read from the proxied server (shown as count)	count	byte
`nginx.cache.bypass.bytes_written`The total number of bytes written to the cache	gauge	byte
`nginx.cache.bypass.bytes_written_count`The total number of bytes written to the cache (shown as count)	count	byte
`nginx.cache.bypass.responses`The total number of responses not taken from the cache	gauge	response
`nginx.cache.bypass.responses_count`The total number of responses not taken from the cache (shown as count)	count	response
`nginx.cache.bypass.responses_written`The total number of responses written to the cache	gauge	response
`nginx.cache.bypass.responses_written_count`The total number of responses written to the cache (shown as count)	count	response
`nginx.cache.cold`A boolean value indicating whether the cache loader process is still loading data from disk into the cache	gauge	response
`nginx.cache.expired.bytes`The total number of bytes read from the proxied server	gauge	byte
`nginx.cache.expired.bytes_count`The total number of bytes read from the proxied server (shown as count)	count	byte
`nginx.cache.expired.bytes_written`The total number of bytes written to the cache	gauge	byte
`nginx.cache.expired.bytes_written_count`The total number of bytes written to the cache (shown as count)	count	byte
`nginx.cache.expired.responses`The total number of responses not taken from the cache	gauge	response
`nginx.cache.expired.responses_count`The total number of responses not taken from the cache (shown as count)	count	response
`nginx.cache.expired.responses_written`The total number of responses written to the cache	gauge	response
`nginx.cache.expired.responses_written_count`The total number of responses written to the cache (shown as count)	count	response
`nginx.cache.hit.bytes`The total number of bytes read from the cache	gauge	byte
`nginx.cache.hit.bytes_count`The total number of bytes read from the cache (shown as count)	count	byte
`nginx.cache.hit.responses`The total number of responses read from the cache	gauge	response
`nginx.cache.hit.responses_count`The total number of responses read from the cache (shown as count)	count	response
`nginx.cache.max_size`The limit on the maximum size of the cache specified in the configuration	gauge	byte
`nginx.cache.miss.bytes`The total number of bytes read from the proxied server	gauge	byte
`nginx.cache.miss.bytes_count`The total number of bytes read from the proxied server (shown as count)	count	byte
`nginx.cache.miss.bytes_written`The total number of bytes written to the cache	gauge	byte
`nginx.cache.miss.bytes_written_count`The total number of bytes written to the cache (shown as count)	count	byte
`nginx.cache.miss.responses`The total number of responses not taken from the cache	gauge	response
`nginx.cache.miss.responses_count`The total number of responses not taken from the cache (shown as count)	count	response
`nginx.cache.miss.responses_written`The total number of responses written to the cache	gauge	response
`nginx.cache.miss.responses_written_count`The total number of responses written to the cache	count	response
`nginx.cache.revalidated.bytes`The total number of bytes read from the cache	gauge	byte
`nginx.cache.revalidated.bytes_count`The total number of bytes read from the cache (shown as count)	count	byte
`nginx.cache.revalidated.responses`The total number of responses read from the cache	gauge	response
`nginx.cache.revalidated.responses_count`The total number of responses read from the cache (shown as count)	count	response
`nginx.cache.size`The current size of the cache	gauge	response
`nginx.cache.stale.bytes`The total number of bytes read from the cache	gauge	byte
`nginx.cache.stale.bytes_count`The total number of bytes read from the cache (shown as count)	count	byte
`nginx.cache.stale.responses`The total number of responses read from the cache	gauge	response
`nginx.cache.stale.responses_count`The total number of responses read from the cache (shown as count)	count	response
`nginx.cache.updating.bytes`The total number of bytes read from the cache	gauge	byte
`nginx.cache.updating.bytes_count`The total number of bytes read from the cache (shown as count)	count	byte
`nginx.cache.updating.responses`The total number of responses read from the cache	gauge	response
`nginx.cache.updating.responses_count`The total number of responses read from the cache (shown as count)	count	response
`nginx.connections.accepted`The total number of accepted client connections.	gauge	connection
`nginx.connections.accepted_count`The total number of accepted client connections (shown as count).	count	connection
`nginx.connections.active`The current number of active client connections.	gauge	connection
`nginx.connections.dropped`The total number of dropped client connections.	gauge	connection
`nginx.connections.dropped_count`The total number of dropped client connections (shown as count).	count	connection
`nginx.connections.idle`The current number of idle client connections.	gauge	connection
`nginx.generation`The total number of configuration reloads	gauge	refresh
`nginx.generation_count`The total number of configuration reloads (shown as count)	count	refresh
`nginx.limit_conn.passed`The total number of connections that were neither limited nor accounted as limited.	count	connection
`nginx.limit_conn.rejected`The total number of connections that were rejected.	count	connection
`nginx.limit_conn.rejected_dry_run`The total number of connections accounted as rejected in the dry run mode.	count	connection
`nginx.limit_req.delayed`The total number of requests that were delayed.	count	request
`nginx.limit_req.delayed_dry_run`The total number of requests accounted as delayed in the dry run mode.	count	request
`nginx.limit_req.passed`The total number of requests that were neither limited nor accounted as limited.	count	request
`nginx.limit_req.rejected`The total number of requests that were rejected.	count	request
`nginx.limit_req.rejected_dry_run`The total number of requests accounted as rejected in the dry run mode.	count	request
`nginx.load_timestamp`Time of the last reload of configuration (time since Epoch).	gauge	millisecond
`nginx.location_zone.discarded`The total number of requests completed without sending a response.	count	request
`nginx.location_zone.received`The total number of bytes received from clients.	count	byte
`nginx.location_zone.requests`The total number of client requests received from clients.	count	request
`nginx.location_zone.responses.1xx`The total number of responses with 1xx status codes.	count	response
`nginx.location_zone.responses.2xx`The total number of responses with 2xx status codes.	count	response
`nginx.location_zone.responses.3xx`The total number of responses with 3xx status codes.	count	response
`nginx.location_zone.responses.4xx`The total number of responses with 4xx status codes.	count	response
`nginx.location_zone.responses.5xx`The total number of responses with 5xx status codes.	count	response
`nginx.location_zone.responses.code`The total number of responses per each status code.	count	response
`nginx.location_zone.responses.total`The total number of responses sent to clients.	count	response
`nginx.location_zone.sent`The total number of bytes sent to clients.	count	byte
`nginx.net.conn_dropped_per_s`Rate of connections dropped (Included with open source NGINX).	rate	connection/second
`nginx.net.conn_opened_per_s`Rate of connections opened (Included with open source NGINX).	rate	connection/second
`nginx.net.connections`The total number of active connections (Included with open source NGINX).	gauge	connection
`nginx.net.reading`The number of connections reading client requests (Included with open source NGINX).	gauge	connection
`nginx.net.request_per_s`Rate of requests processed. Measures both successful and failed requests (Included with open source NGINX).	rate	request/second
`nginx.net.waiting`The number of keep-alive connections waiting for work (Included with open source NGINX).	gauge	connection
`nginx.net.writing`The number of connections waiting on upstream responses and/or writing responses back to the client (Included with open source NGINX).	gauge	connection
`nginx.pid`The ID of the worker process that handled status request.	gauge	-
`nginx.ppid`The ID of the master process that started the worker process	gauge	-
`nginx.processes.respawned`The total number of abnormally terminated and respawned child processes.	gauge	process
`nginx.processes.respawned_count`The total number of abnormally terminated and respawned child processes (shown as count).	count	process
`nginx.requests.current`The current number of client requests.	gauge	request
`nginx.requests.total`The total number of client requests.	gauge	request
`nginx.requests.total_count`The total number of client requests (shown as count).	count	request
`nginx.resolver.requests.addr`The total number of requests to resolve addresses to names.	count	request
`nginx.resolver.requests.name`The total number of requests to resolve names to addresses.	count	request
`nginx.resolver.requests.srv`The total number of requests to resolve SRV records.	count	request
`nginx.resolver.responses.formerr`The total number of FORMERR (Format error) responses.	count	response
`nginx.resolver.responses.noerror`The total number of successful responses.	count	response
`nginx.resolver.responses.notimp`The total number of NOTIMP (Unimplemented) responses.	count	response
`nginx.resolver.responses.nxdomain`The total number of NXDOMAIN (Host not found) responses.	count	response
`nginx.resolver.responses.refused`The total number of REFUSED (Operation refused) responses.	count	response
`nginx.resolver.responses.servfail`The total number of SERVFAIL (Server failure) responses.	count	response
`nginx.resolver.responses.timedout`The total number of timed out requests.	count	request
`nginx.resolver.responses.unknown`The total number of requests completed with an unknown error.	count	request
`nginx.server_zone.discarded`The total number of requests completed without sending a response.	gauge	request
`nginx.server_zone.discarded_count`The total number of requests completed without sending a response (shown as count).	count	request
`nginx.server_zone.processing`The number of client requests that are currently being processed.	gauge	request
`nginx.server_zone.received`The total amount of data received from clients.	gauge	byte
`nginx.server_zone.received_count`The total amount of data received from clients (shown as count).	count	byte
`nginx.server_zone.requests`The total number of client requests received from clients.	gauge	request
`nginx.server_zone.requests_count`The total number of client requests received from clients (shown as count).	count	request
`nginx.server_zone.responses.1xx`The number of responses with 1xx status code.	gauge	response
`nginx.server_zone.responses.1xx_count`The number of responses with 1xx status code (shown as count).	count	response
`nginx.server_zone.responses.2xx`The number of responses with 2xx status code.	gauge	response
`nginx.server_zone.responses.2xx_count`The number of responses with 2xx status code (shown as count).	count	response
`nginx.server_zone.responses.3xx`The number of responses with 3xx status code.	gauge	response
`nginx.server_zone.responses.3xx_count`The number of responses with 3xx status code (shown as count).	count	response
`nginx.server_zone.responses.4xx`The number of responses with 4xx status code.	gauge	response
`nginx.server_zone.responses.4xx_count`The number of responses with 4xx status code (shown as count).	count	response
`nginx.server_zone.responses.5xx`The number of responses with 5xx status code.	gauge	response
`nginx.server_zone.responses.5xx_count`The number of responses with 5xx status code (shown as count).	count	response
`nginx.server_zone.responses.code`The total number of responses per each status code, tagged with status code number.	count	response
`nginx.server_zone.responses.total`The total number of responses sent to clients.	gauge	response
`nginx.server_zone.responses.total_count`The total number of responses sent to clients (shown as count).	count	response
`nginx.server_zone.sent`The total amount of data sent to clients.	gauge	byte
`nginx.server_zone.sent_count`The total amount of data sent to clients (shown as count).	count	byte
`nginx.slab.pages.free`The current number of free memory pages	gauge	page
`nginx.slab.pages.used`The current number of used memory pages	gauge	page
`nginx.slab.slot.fails`The number of unsuccessful attempts to allocate memory of specified size	gauge	request
`nginx.slab.slot.fails_count`The number of unsuccessful attempts to allocate memory of specified size (shown as count)	count	request
`nginx.slab.slot.free`The current number of free memory slots	gauge	-
`nginx.slab.slot.reqs`The total number of attempts to allocate memory of specified size	gauge	request
`nginx.slab.slot.reqs_count`The total number of attempts to allocate memory of specified size (shown as count)	count	request
`nginx.slab.slot.used`The current number of used memory slots	gauge	-
`nginx.ssl.handshakes`The total number of successful SSL handshakes.	gauge	-
`nginx.ssl.handshakes_count`The total number of successful SSL handshakes (shown as count).	count	-
`nginx.ssl.handshakes_failed`The total number of failed SSL handshakes.	gauge	-
`nginx.ssl.handshakes_failed_count`The total number of failed SSL handshakes (shown as count).	count	-
`nginx.ssl.session_reuses`The total number of session reuses during SSL handshake.	gauge	-
`nginx.ssl.session_reuses_count`The total number of session reuses during SSL handshake (shown as count).	count	-
`nginx.stream.limit_conn.passed`The total number of connections that were neither limited nor accounted as limited.	count	connection
`nginx.stream.limit_conn.rejected`The total number of connections that were rejected.	count	connection
`nginx.stream.limit_conn.rejected_dry_run`The total number of connections accounted as rejected in the dry run mode.	count	connection
`nginx.stream.server_zone.connections`The total number of connections accepted from clients	gauge	connection
`nginx.stream.server_zone.connections_count`The total number of connections accepted from clients (shown as count)	count	connection
`nginx.stream.server_zone.discarded`The total number of requests completed without sending a response.	gauge	request
`nginx.stream.server_zone.discarded_count`The total number of requests completed without sending a response (shown as count).	count	request
`nginx.stream.server_zone.processing`The number of client requests that are currently being processed.	gauge	request
`nginx.stream.server_zone.received`The total amount of data received from clients.	gauge	byte
`nginx.stream.server_zone.received_count`The total amount of data received from clients (shown as count).	count	byte
`nginx.stream.server_zone.sent`The total amount of data sent to clients.	gauge	byte
`nginx.stream.server_zone.sent_count`The total amount of data sent to clients (shown as count).	count	byte
`nginx.stream.server_zone.sessions.2xx`The number of responses with 2xx status code.	gauge	session
`nginx.stream.server_zone.sessions.2xx_count`The number of responses with 2xx status code (shown as count).	count	session
`nginx.stream.server_zone.sessions.4xx`The number of responses with 4xx status code.	gauge	session
`nginx.stream.server_zone.sessions.4xx_count`The number of responses with 4xx status code (shown as count).	count	session
`nginx.stream.server_zone.sessions.5xx`The number of responses with 5xx status code.	gauge	session
`nginx.stream.server_zone.sessions.5xx_count`The number of responses with 5xx status code (shown as count).	count	session
`nginx.stream.server_zone.sessions.total`The total number of responses sent to clients.	gauge	session
`nginx.stream.server_zone.sessions.total_count`The total number of responses sent to clients (shown as count).	count	session
`nginx.stream.upstream.peers.active`The current number of connections	gauge	connection
`nginx.stream.upstream.peers.backup`A boolean value indicating whether the server is a backup server.	gauge	-
`nginx.stream.upstream.peers.connect_time`The average time to connect to this server.	gauge	millisecond
`nginx.stream.upstream.peers.connections`The total number of client connections forwarded to this server.	gauge	connection
`nginx.stream.upstream.peers.connections_count`The total number of client connections forwarded to this server (shown as count).	count	connection
`nginx.stream.upstream.peers.downstart`The time (time since Epoch) when the server became "unavail" or "checking" or "unhealthy"	gauge	millisecond
`nginx.stream.upstream.peers.downtime`Total time the server was in the "unavail" or "checking" or "unhealthy" states.	gauge	millisecond
`nginx.stream.upstream.peers.downtime_count`Total time the server was in the "unavail" or "checking" or "unhealthy" states.	count	millisecond
`nginx.stream.upstream.peers.fails`The total number of unsuccessful attempts to communicate with the server.	gauge	error
`nginx.stream.upstream.peers.fails_count`The total number of unsuccessful attempts to communicate with the server (shown as count).	count	error
`nginx.stream.upstream.peers.first_byte_time`The average time to receive the first byte of data from this server.	gauge	millisecond
`nginx.stream.upstream.peers.health_checks.checks`The total number of health check requests made.	gauge	request
`nginx.stream.upstream.peers.health_checks.checks_count`The total number of health check requests made (shown as count).	count	request
`nginx.stream.upstream.peers.health_checks.fails`The number of failed health checks.	gauge	error
`nginx.stream.upstream.peers.health_checks.fails_count`The number of failed health checks (shown as count).	count	error
`nginx.stream.upstream.peers.health_checks.last_passed`Boolean indicating if the last health check request was successful and passed tests.	gauge	-
`nginx.stream.upstream.peers.health_checks.unhealthy`How many times the server became unhealthy (state "unhealthy").	gauge	-
`nginx.stream.upstream.peers.health_checks.unhealthy_count`How many times the server became unhealthy (state "unhealthy") (shown as count).	count	-
`nginx.stream.upstream.peers.id`The ID of the server.	gauge	-
`nginx.stream.upstream.peers.max_conns`The max_conns limit for the server.	gauge	connection
`nginx.stream.upstream.peers.received`The total number of bytes received from this server.	gauge	byte
`nginx.stream.upstream.peers.received_count`The total number of bytes received from this server (shown as count).	count	byte
`nginx.stream.upstream.peers.response_time`The average time to receive the last byte of data from this server.	gauge	millisecond
`nginx.stream.upstream.peers.response_time_histogram`The average time to receive the last byte of data from this server as a histogram.	gauge	millisecond
`nginx.stream.upstream.peers.response_time_histogram.avg`	gauge	millisecond
`nginx.stream.upstream.peers.response_time_histogram.count`	rate	millisecond
`nginx.stream.upstream.peers.response_time_histogram.max`	gauge	millisecond
`nginx.stream.upstream.peers.response_time_histogram.median`	gauge	millisecond
`nginx.stream.upstream.peers.selected`The time (time since Epoch) when the server was last selected to process a connection.	gauge	millisecond
`nginx.stream.upstream.peers.sent`The total number of bytes sent to this server.	gauge	byte
`nginx.stream.upstream.peers.sent_count`The total number of bytes sent to this server (shown as count).	count	byte
`nginx.stream.upstream.peers.unavail`How many times the server became unavailable for client connections (state "unavail").	gauge	-
`nginx.stream.upstream.peers.unavail_count`How many times the server became unavailable for client connections (state "unavail") (shown as count).	count	-
`nginx.stream.upstream.peers.weight`Weight of the server.	gauge	-
`nginx.stream.upstream.zombies`The current number of servers removed from the group but still processing active client connections.	gauge	host
`nginx.stream.zone_sync.status.bytes_in`The number of bytes received by this node.	gauge	byte
`nginx.stream.zone_sync.status.bytes_out`The number of bytes sent by this node.	gauge	byte
`nginx.stream.zone_sync.status.msgs_in`The number of messages received by this node.	gauge	message
`nginx.stream.zone_sync.status.msgs_out`The number of messages sent by this node.	gauge	message
`nginx.stream.zone_sync.status.nodes_online`The number of peers this node is connected to.	gauge	-
`nginx.stream.zone_sync.zone.records_pending`The number of records that need to be sent to the cluster.	gauge	record
`nginx.stream.zone_sync.zone.records_total`The number of records stored in the shared memory zone.	gauge	record
`nginx.stream.zone_sync.zone.records_total_count`The total number of records stored in the shared memory zone.	count	record
`nginx.timestamp`Current time since Epoch.	gauge	millisecond
`nginx.upstream.keepalive`The current number of idle keepalive connections.	gauge	connection
`nginx.upstream.peers.active`The current number of active connections.	gauge	connection
`nginx.upstream.peers.backup`A boolean value indicating whether the server is a backup server.	gauge	-
`nginx.upstream.peers.downstart`The time (since Epoch) when the server became "unavail" or "unhealthy".	gauge	millisecond
`nginx.upstream.peers.downtime`Total time the server was in the "unavail" and "unhealthy" states.	gauge	millisecond
`nginx.upstream.peers.downtime_count`Total time the server was in the "unavail" and "unhealthy" states.	count	millisecond
`nginx.upstream.peers.fails`The total number of unsuccessful attempts to communicate with the server.	gauge	-
`nginx.upstream.peers.fails_count`The total number of unsuccessful attempts to communicate with the server (shown as count).	count	-
`nginx.upstream.peers.header_time`The total amount of time spent on receiving the response header from the upstream server.	gauge	millisecond
`nginx.upstream.peers.health_checks.checks`The total number of health check requests made.	gauge	-
`nginx.upstream.peers.health_checks.checks_count`The total number of health check requests made (shown as count).	count	-
`nginx.upstream.peers.health_checks.fails`The number of failed health checks.	gauge	-
`nginx.upstream.peers.health_checks.fails_count`The number of failed health checks (shown as count).	count	-
`nginx.upstream.peers.health_checks.last_passed`Boolean indicating if the last health check request was successful and passed tests.	gauge	-
`nginx.upstream.peers.health_checks.unhealthy`How many times the server became unhealthy (state "unhealthy").	gauge	-
`nginx.upstream.peers.health_checks.unhealthy_count`How many times the server became unhealthy (state "unhealthy") (shown as count).	count	-
`nginx.upstream.peers.id`The ID of the server.	gauge	-
`nginx.upstream.peers.max_conns`The max_conns limit for this server.	gauge	connection
`nginx.upstream.peers.received`The total amount of data received from this server.	gauge	byte
`nginx.upstream.peers.received_count`The total amount of data received from this server (shown as count).	count	byte
`nginx.upstream.peers.requests`The total number of client requests forwarded to this server.	gauge	request
`nginx.upstream.peers.requests_count`The total number of client requests forwarded to this server (shown as count).	count	request
`nginx.upstream.peers.response_time`The average time to receive the last byte of data from this server.	gauge	millisecond
`nginx.upstream.peers.response_time_histogram`The average time to receive the last byte of data from this server as a histogram.	gauge	millisecond
`nginx.upstream.peers.response_time_histogram.avg`	gauge	millisecond
`nginx.upstream.peers.response_time_histogram.count`	rate	millisecond
`nginx.upstream.peers.response_time_histogram.max`	gauge	millisecond
`nginx.upstream.peers.response_time_histogram.median`	gauge	millisecond
`nginx.upstream.peers.responses.1xx`The number of responses with 1xx status code from this server.	gauge	response
`nginx.upstream.peers.responses.1xx_count`The number of responses with 1xx status code (shown as count) from this server.	count	response
`nginx.upstream.peers.responses.2xx`The number of responses with 2xx status code from this server.	gauge	response
`nginx.upstream.peers.responses.2xx_count`The number of responses with 2xx status code (shown as count) from this server.	count	response
`nginx.upstream.peers.responses.3xx`The number of responses with 3xx status code from this server.	gauge	response
`nginx.upstream.peers.responses.3xx_count`The number of responses with 3xx status code (shown as count) from this server.	count	response
`nginx.upstream.peers.responses.4xx`The number of responses with 4xx status code from this server.	gauge	response
`nginx.upstream.peers.responses.4xx_count`The number of responses with 4xx status code (shown as count) from this server.	count	response
`nginx.upstream.peers.responses.5xx`The number of responses with 5xx status code from this server.	gauge	response
`nginx.upstream.peers.responses.5xx_count`The number of responses with 5xx status code (shown as count).	count	response
`nginx.upstream.peers.responses.code`The total number of responses from this server per each status code.	count	response
`nginx.upstream.peers.responses.total`The total number of responses obtained from this server.	gauge	response
`nginx.upstream.peers.responses.total_count`The total number of responses obtained from this server (shown as count).	count	response
`nginx.upstream.peers.selected`The time (since Epoch) when the server was last selected to process a request (1.7.5).	gauge	millisecond
`nginx.upstream.peers.sent`The total amount of data sent to this server.	gauge	byte
`nginx.upstream.peers.sent_count`The total amount of data sent to this server (shown as count).	count	byte
`nginx.upstream.peers.unavail`How many times the server became unavailable for client requests (state "unavail") due to the number of unsuccessful attempts reaching the max_fails threshold.	gauge	-
`nginx.upstream.peers.unavail_count`How many times the server became unavailable for client requests (state "unavail") due to the number of unsuccessful attempts reaching the max_fails threshold (shown as count).	count	-
`nginx.upstream.peers.weight`Weight of the server.	gauge	-
`nginx.upstream.zombies`The current number of servers removed from the group but still processing active client connections.	gauge	host
`nginx.version`Version of nginx.	gauge	-

Official documentation

Official documentation for the Nginx integration

Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.

Official summary

Metric types

Metrics

Official documentation

Related products

Other SIEM integrations