RRDPYTHON(1)                        rrdtool                       RRDPYTHON(1)


<?><?><?> (NAME)
       rrdpython - <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> RRD

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
        import rrdtool
        rrdtool.create('/tmp/test.rrd', 'DS:foo:GAUGE:20:0:U')

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> rrdtool <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       (Python) <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (wrapper) <?><?>
       <?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?><?><?> <?><?> SWIG)
       <?><?><?><?><?> <?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> (API)
       <?><?><?><?><?><?><?> <?>/<?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> rrdtool <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?> (Example 1)
        import sys
        sys.path.append('/path/to/rrdtool/lib/python2.6/site-packages/')
        import rrdtool, tempfile

        DAY = 86400
        YEAR = 365 * DAY
        fd,path = tempfile.mkstemp('.png')

        rrdtool.graph(path,
                     '--imgformat', 'PNG',
                     '--width', '540',
                     '--height', '100',
                     '--start', "-%i" % YEAR,
                     '--end', "-1",
                     '--vertical-label', 'Downloads/Day',
                     '--title', 'Annual downloads',
                     '--lower-limit', '0',
                     'DEF:downloads=downloads.rrd:downloads:AVERAGE',
                     'AREA:downloads#990033:Downloads')

        info = rrdtool.info('downloads.rrd')
        print info['last_update']
        print info['ds[downloads].minimal_heartbeat']

   <?><?><?><?> <?> (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' )

       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> site-python-install
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?> sys.path.append <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> RRDtool <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?> RRDtool <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> (exception) <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> (catch) <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       rrdcreate, rrdupdate, rrdgraph, rrddump, rrdfetch, rrdtune, rrdlast,
       rrdxport, rrdinfo

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Hye-Shik Chang <perky@i18n.org>

       Alan Milligan <alan.milligan@last-bastion.net>

1.11.0                            2026-08-08                      RRDPYTHON(1)