X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrdgraph_data.html;h=e0353b069d6c2cf8dbc68e58f569bb609dfdd8b4;hb=HEAD;hp=8551d434034c34b1544456c3571e8c8c64936673;hpb=333ab21495916a8d1c4a2861ef3fe86763fde684;p=pkg-rrdtool.git diff --git a/doc/rrdgraph_data.html b/doc/rrdgraph_data.html index 8551d43..e0353b0 100644 --- a/doc/rrdgraph_data.html +++ b/doc/rrdgraph_data.html @@ -9,8 +9,10 @@ -

+ +
+

+ + +

@@ -52,7 +64,7 @@ own manual page.

A-Z, a-z, 0-9, -,_ and a maximum length of 255 characters.

When picking variable names, make sure you do not choose a name that is already taken by an RPN operator. A safe bet it to use lowercase or -mixedcase names for variables since operators will always be in uppercase.

+mixed case names for variables since operators will always be in uppercase.


@@ -76,7 +88,7 @@ a resolution of 1800 seconds per CDP, you should create an image with width 400 and time span 400*1800 seconds (use appropriate start and end times, such as --start end-8days8hours).

If consolidation needs to be done, the CF of the RRA specified in the -DEF itself will be used to reduce the data density. This behaviour can +DEF itself will be used to reduce the data density. This behavior can be changed using :reduce=<CF>. This optional parameter specifies the CF to use during the data reduction phase.

Example:

@@ -114,6 +126,31 @@ the script, just as if it were generated by a DEF instruction.<


+

About CDEF versus VDEF

+

At some point in processing, RRDtool has gathered an array of rates +ready to display.

+

CDEF works on such an array. For example, CDEF:new=ds0,8,* +would multiply each of the array members by eight (probably +transforming bytes into bits). The result is an array containing the +new values.

+

VDEF also works on such an array but in a different way. For +example, VDEF:max=ds0,MAXIMUM would scan each of the array members +and store the maximum value.

+

+

+

When do you use VDEF versus CDEF?

+

Use CDEF to transform your data prior to graphing. In the above +example, we'd use a CDEF to transform bytes to bits before +graphing the bits.

+

You use a VDEF if you want max(1,5,3,2,4) to return five which +would be displayed in the graph's legend (to answer, what was the +maximum value during the graph period).

+

If you want to apply 'complex' operations to the result of a VDEF you have +to use a CDEF again since VDEFs only look like RPN expressions, they aren't +really.

+

+

+

SEE ALSO

the rrdgraph manpage gives an overview of how rrdtool graph works. the rrdgraph_data manpage describes DEF,CDEF and VDEF in detail.