Use the NGINX plugin for collectd to monitor NGINX webserver performance.
NGINX Servers: Overview of data from all NGINX servers.
NGINX Server: Focus on a single NGINX server.
REQUIREMENTS AND DEPENDENCIES
This plugin requires:
If you are using the new Smart Agent, see the docs for the collectd/nginx monitor for more information. The configuration documentation below may be helpful as well, but consult the Smart Agent repo's docs for the exact schema.
Installing the plugin:
On RHEL/CentOS and Amazon Linux systems, run the following command to install this plugin:
yum install collectd-nginx
On Ubuntu and Debian systems, this plugin is included by default with the SignalFx collectd agent.
stub_statusmodule in your NGINX server as described below.
Download SignalFx’s sample configuration file to
Modify the sample configuration file to provide values that make sense for your environment, as described in Configuration, below.
Using the example configuration file 10-nginx.conf as a guide, provide values for the configuration options listed below that make sense for your environment and allow you to connect to the NGINX instance to be monitored.
|configuration option||definition||default value|
|URL||URL at which collectd can access the output of the NGINX status module.||"http://localhost:80/nginx_status"|
NGINX service configuration
Please see nginx docs for a guide to configuring the NGINX stats module
Sample of built-in dashboard in SignalFx:
The following status information is provided:
|Active connections||The current number of active client connections including Waiting connections.|
|accepts||The total number of accepted client connections.|
|handled||The total number of handled connections. Generally, the parameter value is the same as accepts unless some resource limits have been reached (for example, the worker_connections limit).|
|requests||The total number of client requests.|
|Reading||The current number of connections where nginx is reading the request header.|
|Writing||The current number of connections where nginx is writing the response back to the client.|
|Waiting||The current number of idle client connections waiting for a request.|
For documentation of the metrics and dimensions emitted by this plugin, click here.
This integration is released under the Apache 2.0 license. See LICENSE for more details.