X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdgraph_data.pod;h=57b9d0a70da66212ae590d37018d40f1241c066d;hb=06d2116bfef88c41e3a64ca596acdba6ff078c23;hp=02f9663ae345df4835199b703fdf518c5c2b66bb;hpb=acbc4860ec6b85e62f0710aab495113151524825;p=rrdtool.git diff --git a/doc/rrdgraph_data.pod b/doc/rrdgraph_data.pod index 02f9663..57b9d0a 100644 --- a/doc/rrdgraph_data.pod +++ b/doc/rrdgraph_data.pod @@ -4,7 +4,7 @@ rrdgraph_data - preparing data for graphing in rrdtool graph =head1 SYNOPSIS -BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>][:reduce=IBE>] +BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>][:reduce=IBE>][:daemon=IaddressE>] B:I=I @@ -24,11 +24,11 @@ C 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. =head1 DEF -BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>][:reduce=IBE>] +BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>][:reduce=IBE>][:daemon=IaddressE>] This command fetches data from an B file. The virtual name I can then be used throughout the rest of the script. By @@ -50,16 +50,24 @@ image with width 400 and time span 400*1800 seconds (use appropriate start and end times, such as C<--start end-8days8hours>). If consolidation needs to be done, the B of the B specified in the -B itself will be used to reduce the data density. This behaviour can +B itself will be used to reduce the data density. This behavior can be changed using C<:reduce=IBE>>. This optional parameter specifies the B to use during the data reduction phase. +It is possible to request single data sources from a specific I, see +L, using the C<:daemon=IaddressE>> parameter. The +value given to this parameter follows the same syntax as other means to specify +the address of the caching daemon. It is described in detail in the +L manual page. Beware, however, that colons (in IPv6 addresses +and as a port separator, for example) need to be escaped using a backslash. + Example: DEF:ds0=router.rrd:ds0:AVERAGE DEF:ds0weekly=router.rrd:ds0:AVERAGE:step=7200 DEF:ds0weekly=router.rrd:ds0:AVERAGE:start=end-1h DEF:ds0weekly=router.rrd:ds0:AVERAGE:start=11\:00:end=start+1h + DEF:ds0weekly=router.rrd:ds0:AVERAGE:daemon=collect1.example.com =head1 VDEF @@ -116,7 +124,7 @@ 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 -realy. +really. =head1 SEE ALSO