nginxossreceiver

NGINX Receiver

This receiver can fetch stats from a NGINX instance via two sources:

• The ngx_http_stub_status_module module's status endpoint.
• The NGINX access logs.

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.

You must also configure an access log as well. Please see Setting Up the Access Log for a guide to configuring an access log.

Receiver Config

The following settings are required:

• api_details: Details for the NGINX status endpoint.
  • url: (default: http://localhost:80/status): The URL of the NGINX status endpoint.
  • listen: (default: localhost:80): The listen directive of the NGINX status endpoint.
  • location: (default: /status): The location directive 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.

• access_logs (default = []): defines a list of access logs to scrape.

  • file_path: The file path to the access log.
  • log_format: The format of the access log.

Example:

receivers:
  nginx:
    api_details:
      url: "http://localhost:80/status"
      listen: "localhost:80"
      location: "/status"    
    collection_interval: 10s
    access_logs:
      - log_format: "$remote_addr - $remote_user [$time_local] \"$request\" $status $body_bytes_sent \"$http_referer\" \"$http_user_agent\" \"$http_x_forwarded_for\"\"$upstream_cache_status\""
        file_path: "/var/log/nginx/access-custom.conf"