rrdlist - Man Page

List directories and rrd databases.


rrdtool list [--daemon|-d address] path


The list function connects to rrdcached, the RRD caching daemon, and issues a “list” command for the given path. This provides an 'ls-like' interface for traversing and listing the rrd database tree.


The path (starting with '/') with '/' being the rrdcached base_dir.

--daemon|-d address

Address of the rrdcached daemon. If not specified, the RRDCACHED_ADDRESS environment variable must be set (see below).  For a list of accepted formats, see the -l option in the rrdcached manual.

 rrdtool list --daemon /cluster/nodes/node1

Environment Variables

The following environment variables may be used to change the behavior of rrdtool list:


If this environment variable is set it will have the same effect as specifying the --daemon option on the command line. If both are present, the command line argument takes precedence.


Sebastien Dugue <sebastien.dugue@atos.net>


2019-02-04 1.7.1 rrdtool