Section 1: user commands and tools
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….
NAME rrdfetch – Fetch data from an RRD. SYNOPSIS rrdtool fetch filename CF [–resolution|-r resolution] [–start|-s start] [–end|-e end] [–daemon address] DESCRIPTION The fetch function is normally used internally by the graph function to get data from RRDs. fetch will analyze the RRD and try to retrieve the data in the resolution requested. The data fetched is printed to…
NAME rrddump – dump the contents of an RRD to XML format SYNOPSIS rrdtool dump filename.rrd [filename.xml] [–header|-h {none,xsd,dtd}] [–no-header] [–daemon address] > filename.xml DESCRIPTION The dump function writes the contents of an RRD in human readable (?) XML format to a file or to stdout. This format can be read by rrdrestore. Together they allow you to…
NAME rrdcreate – Set up a new Round Robin Database SYNOPSIS rrdtool create filename [–start|-b start time] [–step|-s step] [–no-overwrite] [DS:ds-name:DST:dst arguments] [RRA:CF:cf arguments] DESCRIPTION The create function of RRDtool lets you set up new Round Robin Database (RRD) files. The file is created at its final, full size and filled with *UNKNOWN* data. filename The name…
NAME rrdcgi – Create web pages containing RRD graphs based on templates SYNOPSIS "#!/path/to/"rrdcgi [–filter] DESCRIPTION rrdcgi is a sort of very limited script interpreter. Its purpose is to run as a cgi-program and parse a web page template containing special <RRD:: tags. rrdcgi will interpret and act according to these tags. In the end…
NAME rrdcached – Data caching daemon for rrdtool SYNOPSIS rrdcached [-P permissions] [-l address] [-s group] [-w timeout] [-z delay] [-f timeout] [-p pid_file] [-t write_threads] [-j journal_dir] [-F] [-g] [-b base_dir [-B]] DESCRIPTION rrdcached is a daemon that receives updates to existing RRD files, accumulates them and, if enough have been received or a defined time has passed, writes the updates to the RRD file….
NAME rrdbuild – Instructions for building RRDtool OVERVIEW If you downloaded the source of RRDtool you have to compile it. This document will give some information on how this is done. RRDtool relies on services of third part libraries. Some of these libraries may already be installed on your system. You have to compile copies…
NAME rrd2whisper – convert an RRD database to a whisper database SYNOPSYS wrrd2whisper rrd_path DESCRIPTION This command converts an RRD database to a whisper fixed-size database. The options are described below. OPTIONS –xFilesFactor The fraction of data points in a propagation interval that must have known values for a propagation to occur. -h, –help Show…
NAME rrd-beginners – RRDtool Beginners’ Guide SYNOPSIS Helping new RRDtool users to understand the basics of RRDtool DESCRIPTION This manual is an attempt to assist beginners in understanding the concepts of RRDtool. It sheds a light on differences between RRDtool and other databases. With help of an example, it explains the structure of RRDtool database….
NAME rancid – Cisco configuration filter SYNOPSIS rancid [-dlCV] [-t device_type] (-f filename | hostname) rancid [-dhlCV] -t device_type (-f filename | hostname) DESCRIPTION rancid is a collection of perl(1) scripts which uses the login scripts (see clogin(1)) to login to a device, execute commands to display the configuration, etc, then filters the output for…
NAME rpntutorial – Reading RRDtool RPN Expressions by Steve Rader DESCRIPTION This tutorial should help you get to grips with RRDtool RPN expressions as seen in CDEF arguments of RRDtool graph. Reading Comparison Operators The LT, LE, GT, GE and EQ RPN logic operators are not as tricky as they appear. These operators act on…