Nginx Receiver

Available in: contrib Maintainers: @colelaven, @ishleenk17 Source: opentelemetry-collector-contrib

Supported Telemetry

Overview

Configuration

NGINX Module

You must configure NGINX to expose status information by editing the NGINX configuration. Please see ngx_http_stub_status_module for a guide to configuring the NGINX stats module ngx_http_stub_status_module.

Receiver Config

The following settings are required:

endpoint (default: http://localhost:80/status): The URL of the NGINX status endpoint

The following settings are optional:

collection_interval (default = 10s): This receiver collects metrics on an interval. This value must be a string readable by Golang’s time.ParseDuration. Valid time units are ns, us (or µs), ms, s, m, h.
initial_delay (default = 1s): defines how long this receiver waits before starting.

Example:

receivers:
  nginx:
    endpoint: "http://localhost:80/status"
    collection_interval: 10s

The full list of settings exposed for this receiver are documented in config.go with detailed sample configurations in testdata/config.yaml.

Metrics

Metric Name	Description	Unit	Type	Attributes
✅ `nginx.connections_accepted`	The total number of accepted client connections	{connections}	Counter
✅ `nginx.connections_current`	The current number of nginx connections by state	{connections}	UpDownCounter	state
✅ `nginx.connections_handled`	The total number of handled connections. Generally, the parameter value is the same as nginx.connections_accepted unless some resource limits have been reached (for example, the worker_connections limit).	{connections}	Counter
✅ `nginx.requests`	Total number of requests made to the server since it started	{requests}	Counter

Attributes

Attribute Name	Description	Type	Values
`state`	The state of a connection	string	`active`, `reading`, `writing`, `waiting`

Configuration

Example Configuration

nginx:
  endpoint: "http://localhost:80/status"
  collection_interval: 10s

Last generated: 2026-08-24

​Nginx Receiver

​Supported Telemetry

​Overview

​Configuration

​NGINX Module

​Receiver Config

​Metrics

​Attributes

​Configuration

​Example Configuration

Nginx Receiver

Supported Telemetry

Overview

Configuration

NGINX Module

Receiver Config

Metrics

Attributes

Configuration

Example Configuration