Chapter 16. RRDTool Specific Features

16.1. GPRINT Presets

A GPRINT is a graph item type that enables you to print the values of data sources on a graph. They are typically used

to represent legend values on the graph. The output format of these numbers are controlled by a printf like format

string. Cacti enables you to keep a global list of these strings that can be applied to any graph item throughout Cacti.

16.1.1. Creating a GPRINT Preset

To create a new GPRINT preset, select the Graph Management menu item under the Management heading, and select

GPRINT Presets. Click Add to the right and you will be presented with an edit page containing two fields. Enter a name

for your GPRINT preset, and the actual printf like string in the GPRINT Text field. When you are finished, click the

Create button to create your new GPRINT preset.

16.2. CDEFs

CDEFs allow you to apply mathematical functions to graph data to alter output. The concept of a CDEF comes straight

from

RRDTool

, and are written in reverse polish notation (RPN). For more information regarding the syntax of CDEFs,

check out the CDEF tutorial

1

.

16.2.1. Creating a CDEF

To create a new CDEF in Cacti, select the Graph Management option under the Management heading, and select CDEFs.

Once at this screen, click Add to the right. You will be prompted for a CDEF name, for which you can type anything

used to describe your CDEF. Click the Create button so you are redirected back to the edit page, now with an empty

CDEF Items box. Construct your CDEF by adding an item for each element in the CDEF string, common types such as

operators and functions are enumerated for your convenience. Below is a basic description of each CDEF item type.

Table 16 1. CDEF Item Types

Type

Description

Function

You can choose a CDEF function to use as the item. The RRDTool graph manual

2

describes the purpose of each CDEF function.

Operator

Just your standard math operators, including modulo (%).

Special Data Source

A special data source is basically a flag to tell Cacti to do some special processing when

it encounters this CDEF item. The "Current Graph Item Data Source" type basically

inserts the name of the data source that is referenced by the graph item that references

to this CDEF. Both of the "All Data Sources" types insert a summation of all data

sources used on a graph.

Another CDEF

You can recursively use another CDEF within this CDEF.

Custom String

Sometimes it's just easier to type out the literal CDEF string manually. When

referencing to data sources on the graph, remember that Cacti names them 'a', 'b', 'c',

'...', starting with the first data source on the graph.

Notes

1. http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/tutorial/cdeftutorial.html

40