rrdtool info - extract header information from an rrd

PDF version.


rrdtool info filename.rrd


The info function prints the header information from an rrd in a parsing friendly format.

Check the rrdcreate manpage if you are uncertain about the meaning of the individual keys.


This is the output generated by running info on a simple rrd which contains two datasources and one rra. Note that the number after the last_update keyword is in seconds since 1970. The string NaN stands for *UNKNOWN* data. In the example it means that this rrd has neither minimum not maximum values defined for either of its datasources.

 filename = "randome.rrd"
 rrd_version = "0001"
 step = 300
 last_update = 955892996
 ds[a].type = "GAUGE"
 ds[a].minimal_heartbeat = 600
 ds[a].min = NaN
 ds[a].max = NaN
 ds[a].last_ds = "UNKN"
 ds[a].value = 2.1824421548e+04
 ds[a].unknown_sec = 0
 ds[b].type = "GAUGE"
 ds[b].minimal_heartbeat = 600
 ds[b].min = NaN
 ds[b].max = NaN
 ds[b].last_ds = "UNKN"
 ds[b].value = 3.9620838224e+03
 ds[b].unknown_sec = 0
 rra[0].cf = "AVERAGE"
 rra[0].pdp_per_row = 1
 rra[0].cdp_prep[0].value = nan
 rra[0].cdp_prep[0].unknown_datapoints = 0
 rra[0].cdp_prep[1].value = nan
 rra[0].cdp_prep[1].unknown_datapoints = 0
The name of the RRD you want to dump.


Tobias Oetiker <>