X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdfetch.pod;h=51b5ccd99c8441f8f7f12021836ba22a902ccc56;hb=299d1636596a1911659e0a53bfad5c47e72835e0;hp=a6382b92692ad7c51373b1fc12b58e56903f5434;hpb=26f7c5c1ba83c8ab82cd271b143061f7fb13394c;p=rrdtool.git diff --git a/doc/rrdfetch.pod b/doc/rrdfetch.pod index a6382b9..51b5ccd 100644 --- a/doc/rrdfetch.pod +++ b/doc/rrdfetch.pod @@ -4,10 +4,10 @@ rrdfetch - Fetch data from an RRD. =head1 SYNOPSIS -B B I I -S<[B<--resolution>|B<-r> I]> -S<[B<--start>|B<-s> I]> -S<[B<--end>|B<-e> I]> +B B I I +S<[B<--resolution>|B<-r> I]> +S<[B<--start>|B<-s> I]> +S<[B<--end>|B<-e> I]> =head1 DESCRIPTION @@ -20,11 +20,11 @@ function. =over 8 -=item I +=item I the name of the B you want to fetch the data from. -=item I +=item I the consolidation function that is applied to the data you want to fetch (AVERAGE,MIN,MAX,LAST) @@ -52,8 +52,8 @@ specify the end time. =head2 RESOLUTION INTERVAL -In order to get RRDtool to fetch anything other than the finest resolution RRA -B the start and end time must be specified on boundaries that are +In order to get RRDtool to fetch anything other than the finest resolution RRA +B the start and end time must be specified on boundaries that are multiples of the desired resolution. Consider the following example: rrdtool create subdata.rrd -s 10 DS:ds0:GAUGE:300:0:U \ @@ -92,10 +92,10 @@ both start and end time are within the desired RRA =back -So, if time now is called "t", do +So, if time now is called "t", do end time == int(t/900)*900, - start time == end time - 1hour, + start time == end time - 1hour, resolution == 900. Using the bash shell, this could look be: @@ -103,7 +103,7 @@ Using the bash shell, this could look be: TIME=$(date +%s) RRDRES=900 rrdtool fetch subdata.rrd AVERAGE -r $RRDRES \ - -e $(echo $(($TIME/$RRDRES*$RRDRES))) -s e-1h + -e $(($TIME/$RRDRES*$RRDRES)) -s e-1h Or in Perl: @@ -259,4 +259,4 @@ I<19970703 12:45> -- 12:45 July 3th, 1997 =head1 AUTHOR -Tobias Oetiker +Tobias Oetiker