NAME rrdxport – Export data in XML format based on data from one or several RRD SYNOPSIS rrdtool xport [-s|–start seconds] [-e|–end seconds] [-m|–maxrows rows] [–step value] [–json] [–daemon address] [DEF:vname=rrd:ds-name:CF] [CDEF:vname=rpn-expression] [XPORT:vname[:legend]] DESCRIPTION The xport function’s main purpose is to write an XML formatted representation of the data stored in one or several RRDs. It can also extract numerical…
NAME rrdupdate – Store a new set of values into the RRD SYNOPSIS rrdtool {update | updatev} filename [–template|-t ds-name[:ds-name]…] [–daemon|-d address] [—] N|timestamp:value[:value…] at-timestamp@value[:value…] [timestamp:value[:value…] …] DESCRIPTION The update function feeds new data values into an RRD. The data is time aligned (interpolated) according to the properties of the RRD to which the data is written. updatev…
NAME rrdtutorial – Alex van den Bogaerdt’s RRDtool tutorial DESCRIPTION RRDtool is written by Tobias Oetiker <tobi [at] oetiker.ch> with contributions from many people all around the world. This document is written by Alex van den Bogaerdt <alex [at] vandenbogaerdt.nl> to help you understand what RRDtool is and what it can do for you. The…
NAME rrdtune – Modify some basic properties of a Round Robin Database SYNOPSIS rrdtool tune filename [–heartbeat|-h ds-name:heartbeat] [–minimum|-i ds-name:min] [–maximum|-a ds-name:max] [–data-source-type|-d ds-name:DST] [–data-source-rename|-r old-name:new-name] [–deltapos scale-value] [–deltaneg scale-value] [–failure-threshold failure-threshold] [–window-length window-length] [–alpha adaption-parameter] [–beta adaption-parameter] [–gamma adaption-parameter] [–gamma-deviation adaption-parameter] [–smoothing-window fraction-of-season] [–smoothing-window-deviation fraction-of-season] [–aberrant-reset ds-name] DESCRIPTION The tune option allows you to alter some of the basic configuration values stored in the header area of a Round Robin…
NAME rrdtool – Round Robin Database Tool SYNOPSIS rrdtool – [workdir]| function DESCRIPTION OVERVIEW It is pretty easy to gather status information from all sorts of things, ranging from the temperature in your office to the number of octets which have passed through the FDDI interface of your router. But it is not so trivial…
NAME rrdthreads – Provisions for linking the RRD library to use in multi-threaded programs SYNOPSIS Using librrd in multi-threaded programs requires some extra precautions, as the RRD library in its original form was not thread-safe at all. This document describes requirements and pitfalls on the way to use the multi-threaded version of librrd in your…
NAME rrdrestore – Restore the contents of an RRD from its XML dump format SYNOPSIS rrdtool restore filename.xml filename.rrd [–range-check|-r] DESCRIPTION The restore function reads the XML representation of an RRD and converts it to the native RRD format. filename.xml The name of the XML file you want to restore. filename.rrd The name of the…
NAME rrdresize – alters the size of an RRA and creates a new .rrd file SYNOPSIS rrdtool resize filename rra-num GROW|SHRINK rows DESCRIPTION The resize function is used to modify the number of rows in an RRA. filename the name of the RRD you want to alter. rra-num the RRA you want to alter. You…
NAME RRDLua – Lua binding for RRDTool SYNOPSIS require ‘rrd’ rrd.create(…) rrd.dump(…) rrd.fetch(…) rrd.first(…) rrd.graph(…) rrd.graphv(…) rrd.info(…) rrd.last(…) rrd.resize(…) rrd.restore(…) rrd.tune(…) rrd.update(…) rrd.updatev(…) DESCRIPTION Calling Sequence This module accesses RRDtool functionality directly from within Lua. The arguments to the functions listed in the SYNOPSIS are explained in the regular RRDtool documentation. The command-line call rrdtool…
NAME rrdlastupdate – Return the most recent update to an RRD SYNOPSIS rrdtool lastupdate filename [–daemon address] DESCRIPTION The lastupdate function returns the UNIX timestamp and the value stored for each datum in the most recent update of an RRD. filename The name of the RRD that contains the data. –daemon address Address of the rrdcached…
NAME rrdlast – Return the date of the last data sample in an RRD SYNOPSIS rrdtool last filename [–daemon address] DESCRIPTION The last function returns the UNIX timestamp of the most recent update of the RRD. filename The name of the RRD that contains the data. –daemon address Address of the rrdcached daemon. If specified, a…
NAME rrdinfo – extract header information from an RRD SYNOPSIS rrdtool info filename [–daemon address] DESCRIPTION The info function prints the header information from an RRD in a parsing friendly format. Check rrdcreate if you are uncertain about the meaning of the individual keys. filename The name of the RRD you want to examine. –daemon address…
NAME rrdgraph_rpn – About RPN Math in rrdtool graph SYNOPSIS RPN expression:=vname|operator|value[,RPN expression] DESCRIPTION If you have ever used a traditional HP calculator you already know RPN (Reverse Polish Notation). The idea behind RPN is that you have a stack and push your data onto this stack. Whenever you execute an operation, it takes as…
NAME rrdgraph_libdbi – fetching data for graphing in rrdtool graph via libdbi SYNOPSIS <rrdfile> = sql//<libdbi driver>/<driver-option-name>=<driver-option-value>/…[/rrdminstepsize=<stepsize>][/rrdfillmissing=<fill missing n seconds>]//<table>/<unixtimestamp column>/<data value column>[/derive]/<where clause 1>/…/<where clause n> DESCRIPTION This pseudo-rrd-filename defines a sql datasource: sql// magic cookie-prefix for a libdbi type datasource <libdbi driver> which libdbi driver to use (e.g: mysql) <driver-option-name>=<driver-option-value> defines the parameters…
NAME rrdgraph_graph – rrdtool graph command reference SYNOPSIS PRINT:vname:format GPRINT:vname:format COMMENT:text VRULE:time#color[:legend][:dashes[=on_s[,off_s[,on_s,off_s]…]][:dash-offset=offset]] HRULE:value#color[:legend][:dashes[=on_s[,off_s[,on_s,off_s]…]][:dash-offset=offset]] LINE[width]:value[#color][:[legend][:STACK][:skipscale][:dashes[=on_s[,off_s[,on_s,off_s]…]][:dash-offset=offset]] AREA:value[#color][:[legend][:STACK][:skipscale]] TICK:vname#rrggbb[aa][:fraction[:legend]] SHIFT:vname:offset TEXTALIGN:{left|right|justified|center} PRINT:vname:CF:format (deprecated) GPRINT:vname:CF:format (deprecated) STACK:vname#color[:legend] (deprecated) DESCRIPTION These instructions allow you to generate your image or report. If you don’t use any graph elements, no graph is generated. Similarly, no report is generated if you don’t use…
NAME rrdgraph_examples – Examples for rrdtool graph SYNOPSIS rrdtool graph /home/httpd/html/test.png –img-format PNG followed by any of the examples below DESCRIPTION For your convenience some of the commands are explained here by using detailed examples. They are not always cut-and-paste ready because comments are intermixed with the examples. EXAMPLES Data with multiple resolutions –end now…
NAME rrdgraph_data – preparing data for graphing in rrdtool graph SYNOPSIS DEF:<vname>=<rrdfile>:<ds-name>:<CF>[:step=<step>][:start=<time>][:end=<time>][:reduce=<CF>] VDEF:vname=RPN expression CDEF:vname=RPN expression DESCRIPTION These three instructions extract data values out of the RRD files, optionally altering them (think, for example, of a bytes to bits conversion). If so desired, you can also define variables containing useful information such as maximum, minimum…
NAME rrdgraph – Round Robin Database tool graphing functions SYNOPSIS rrdtool graph|graphv filename [option …] [data definition …] [data calculation …] [variable definition …] [graph element …] [print element …] DESCRIPTION The graph function of RRDtool is used to present the data from an RRD to a human viewer. Its main purpose is to create…
NAME rrdflushcached – Flush the values for a spcific RRD file from memory. SYNOPSIS rrdtool flushcached [–daemon address] filename [filename …] DESCRIPTION The flushcached function connects to rrdcached, the RRD caching daemon, and issues a “flush” command for the given files. The daemon will put the files to the head of the update queue so they…
NAME rrdfirst – Return the date of the first data sample in an RRA within an RRD SYNOPSIS rrdtool first filename [–rraindex number] DESCRIPTION The first function returns the UNIX timestamp of the first data sample entered into the specified RRA of the RRD file. filename The name of the RRD that contains the data….