NGINX Plus¶

inbound_nginx_plus

NGINX Plus is the commercial version of the popular NGINX webserver. It offers enterprise-ready features, including a comprehensive series of over 80 unique metrics. Our custom plugin for the Librato Agent gathers all of these metrics, helping you monitor the health and performance of your NGINX Plus servers.

Note: This plugin only supports the gathering of metrics from the commercial NGINX Plus web server. Our standard NGINX Integration offers support for the the open source NGINX web server.

Installation¶

The NGINX Plus integration depends on the Librato Agent. If you haven’t already, you will first need to install the Librato Agent. Once this is complete, select the NGINX Plus icon in the integrations catalogue.

inbound_nginx_plus_integration

Toggle the Enabled switch to activate the NGINX Plus integration on your Librato account and create the preconfigured NGINX Plus Spaces.

inbound_nginx_plus_config

At this point your integration is complete and any NGINX Plus metrics associated with this integration will be allowed through your Librato Agent service-side filters.

Plugin Configuration¶

Your NGINX Plus server will need a location defined with the status module activated. Here is a sample definition that allows connections from the local agent and works with our default plugin configuration.

server {
    listen 127.0.0.1;
    location /status {
        status;
    }
}

Alternatively, you can adjust the URL setting in the /opt/collectd/etc/collectd.conf.d/nginx_plus.conf configuration file to match your particular setup.

LoadPlugin python
<Plugin python>
  ModulePath "/opt/collectd/share/collectd"
  Import "collectd-nginx_plus"
  LogTraces true
  <Module "collectd-nginx_plus">
    **URL "http://127.0.0.1/status"**
    Verbose false
  </Module>
</Plugin>

Note: You must restart the collectd service after any changes to your Librato Agent configuration files.

$ sudo service collectd restart

At this point you should begin seeing librato.nginx_plus.* metrics in your Librato account.

NGINX Plus Workspaces¶

Visit your preconfigured Spaces to observe your new metrics as they stream in. We’ve designed five different purpose-driven dashboards to help you monitor the different modes that NGINX Plus supports: Caches, Server Zones, Streams, and Upstreams. There is also an Overview dashboard for tracking administrative statistics for your NGINX Plus servers.

inbound_nginx_plus_spaces

Inside each space you can use our dynamic source field at the top to filter your view to a subset of metric sources. For example, you may want to isolate the view to a specific tier of web servers or even to an individual machine that is behaving badly.

inbound_nginx_plus_space

FAQ¶

For specific answers to Librato Agent questions check out our Librato Agent FAQ

Let us know what you think when you take this for a spin. We would love to incorporate your feedback and any new dashboards you design into the ongoing development of this key server monitoring technology.