Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Nginx default checks and policies

Agent Client Collector provides the following policies for Nginx health monitoring. Policies come with the checks specified in the indicated table. Policies and checks are available for both Windows and Linux.

CheckDescriptionUsageCommandOutput
nginx.check-nginx-aliveVerifies whether Nginx server is alive.Note: Use basic authentication for events.

check-nginx-status.rb - -h, --host

Nginx hostname

  • -p, --port

Nginx port

Note: Use basic authentication for events.

``Successful `CheckNginxStatus OK: Nginx is Alive and healthy` Failure `CheckNginxStatus CRITICAL: Nginx is Down`
CheckDescriptionUsageCommandOutput
nginx.metrics-nginx-server

Retrieves the following information:

  • nginx.active_connections

Total number of active connections on server.

  • nginx.accepts

The accepted connections.

  • nginx.handled

Handled connections, which normally equals the number of accepted connections.

  • nginx.requests

Total number of handled requests by the server.

  • nginx.read

Shows whether the server is reading requests.

  • nginx.writing

Shows whether the server is writing responses to the client.

  • nginx.waiting

Idle connections waiting for a request.

Note: Use basic authentication for metrics.

`metrics-nginx.rb` Options: `-u --url` Full URL to the server status page. For example: `https://yoursite.com/nginx_status```
ws19-INC0047517.nginx.active_connections 1 1640135552 
ws19-INC0047517.nginx.accepts 5746 1640135552 
ws19-INC0047517.nginx.handled 5746 1640135552 
ws19-INC0047517.nginx.requests 9603 1640135552 
ws19-INC0047517.nginx.reading 0 1640135552 
ws19-INC0047517.nginx.writing 1 1640135552 
ws19-INC0047517.nginx.waiting 0 1640135552 

Parent Topic:Agent Client Collector Monitoring default checks and policies