Accept cookies for analytics, social media, and advertising, or learn more and adjust your preferences. These cookies are on by default for visitors outside the UK and EEA. Privacy Notice.
RRDtool stores and graphs time-series data.
mod_rrd_graph - is an NGINX module that provides an HTTP interface to RRDtool’s graphing facilities. By linking RRDtool directly into NGINX, ngx_rrd_graph is faster than scripts and CGIs with similar purposes.
Note
This module is not distributed with the NGINX source. See the installation instructions.
Syntax: | rrd_graph |
---|---|
Default: | none |
Context: | location |
ngx_rrd_graph can be enabled at a particular location with the rrd_graph directive, like so:
location /rrdtool {
rrd_graph;
}
RRDtool graphing commands can then be appended to that location in request URLs. The syntax is just the same as the arguments to the rrdtool graph
command, omitting the filename (refer to rrdgraph(1)). These commands should be URL-encoded, so that this command-line invocation:
rrdtool graph --start now-300s \
--end now \
DEF:ds0=test.rrd:reading:AVERAGE \
LINE1:ds0#00FF00
becomes:
http://mysite.com/rrdtool--start%20now-300s%20--end%20now%20DEF%3Ads0%3Dtest.rrd%3Areading%3AAVERAGE%20LINE1%3Ads0%2300FF00
The module supports all the features of your copy of RRDtool. It can output PNG, PDF, SVG, and EPS graphics (see the --imgformat
option of rrdgraph(1)).
Syntax: | rrd_graph_root /path/to/rrds |
---|---|
Default: | none |
Context: | location |
If you’d prefer not to provide absolute paths to files referenced in DEF commands, you may supply a root directory with the rrd_graph_root directive. Files mentioned in DEF commands will be automatically prefixed with the value of rrd_graph_root.
ngx_rrd_graph requires RRDtool 1.3 or later.
After installing RRDtool, get the mod_rrd_graph source code from Github
Extract the archive and add the following option to your NGINX ./configure
command:
--add-module=/path/to/mod_rrd_graph
Then make
and make install
as usual.
Please report bugs to Evan Miller.