X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdgraph_data.src;h=1f8fcb7c6114d5664a96a1b480b764b590010ff8;hb=6ec26a38a0bf2df5c216017eddc3eba997d7fbf1;hp=47a7bea29b7926685073986bca4a43210c2b6a45;hpb=e7de71c824fd824d345c8e7a99a815fe1525eeef;p=rrdtool.git diff --git a/doc/rrdgraph_data.src b/doc/rrdgraph_data.src index 47a7bea..1f8fcb7 100644 --- a/doc/rrdgraph_data.src +++ b/doc/rrdgraph_data.src @@ -1,8 +1,8 @@ =include name -=head1 SYNOPSYS +=head1 SYNOPSIS -BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>] +BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>][:reduce=IBE>] B:I=I @@ -13,19 +13,19 @@ B:I=I These three instructions collect the data out of the B files, optionally altering it (think of a bytes to bits conversion) and if desired you can define variables containing useful information -such as maximum, mininimum etcetera. Two of the instructions use +such as maximum, minimum etcetera. Two of the instructions use a language called B which is described in its own manual page. =head1 DEF -BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>] +BIvnameE>=IrrdfileE>:Ids-nameE>:ICFE>[:step=IstepE>][:start=ItimeE>][:end=ItimeE>][:reduce=IBE>] This command fetches data from an B file. The virtual name I can then be used throughout the rest of the script. By default, an B which contains the correct consolidated data at an appropriate resolution will be chosen. The resolution can -be overriden with the L<--step|rrdgraph/item_Time> option. -The resolution can again be overriden by specifying the B. +be overridden with the L<--step|rrdgraph/item_Time> option. +The resolution can again be overridden by specifying the B. The time span of this data is the same as for the graph by default, you can override this by specifying B. Remember to escape colons in the time specification! @@ -39,6 +39,11 @@ a resolution of 1800 seconds per B, you should create an 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 +be changed using C<:reduce=IBE>>. This optional parameter +specifies the B to use during the data reduction phase. + Example: DEF:ds0=router.rrd:ds0:AVERAGE