index dc329ecaf85c7e6562a48e9ba55b4237a20cf4ed..ba21f1608ddf0ee3c112aed211b87b4a85da6203 100644 (file)
=head1 SYNOPSIS
import rrdtool
- rrdtool.create('/tmp/test.rrd', 'DS:foo:GUAGE:20:0:U')
+ rrdtool.create('/tmp/test.rrd', 'DS:foo:GAUGE:20:0:U')
=head1 DESCRIPTION
language. This wrapper implementation has been written from the scratch
(without SWIG)
-The API's simply expects string parameters to the functions. Please refer
-to the other B<rrdtool> documentation for functions and valid arguments.
+The API's expects strings and/or list of strings as parameters to the functions.
+Please refer to the other B<rrdtool> documentation for functions and valid arguments.
-=head1 EXAMPLE
+=head1 EXAMPLES
- sys.path.append('/path/to/rrdtool/lib/python2.3/site-packages/')
+=head2 Example 1
+
+ import sys
+ sys.path.append('/path/to/rrdtool/lib/python2.6/site-packages/')
import rrdtool, tempfile
DAY = 86400
info = rrdtool.info('downloads.rrd')
print info['last_update']
- print info['ds']['downloads']['minimal_heartbeat']
+ print info['ds[downloads].minimal_heartbeat']
+
+=head2 Example 2
+
+ import sys
+ sys.path.append('/path/to/rrdtool/lib/python2.6/site-packages/')
+ import rrdtool
+
+ # in real life data_sources would be populated in loop or something similar
+ data_sources=[ 'DS:speed1:COUNTER:600:U:U',
+ 'DS:speed2:COUNTER:600:U:U',
+ 'DS:speed3:COUNTER:600:U:U' ]
+
+ rrdtool.create( 'speed.rrd',
+ '--start', '920804400',
+ data_sources,
+ 'RRA:AVERAGE:0.5:1:24',
+ 'RRA:AVERAGE:0.5:6:10' )
If you use the B<site-python-install> make target you can drop to first sys.path.append
-line since the rrdtool module will be available everywhere.
+line since the RRDtool module will be available everywhere.
-If rrdtool runs into trouble, it will throw an exception which you might want to catch.
+If RRDtool runs into trouble, it will throw an exception which you might want to catch.
=head1 SEE ALSO
Hye-Shik Chang E<lt>perky@i18n.orgE<gt>
Alan Milligan E<lt>alan.milligan@last-bastion.netE<gt>
-