Skip to main content

Python bindings for rrdtool

Project description

Build Status

python-rrdtool

Python bindings for RRDtool for Python 2 and 3.

The bindings are based on the code of the original Python 2 bindings module for rrdtool by Hye-Shik Chang and are now shipped with the RRDtool distribution. This project is maintained separately to provide a more pythonic way to install those bindings via PyPI.

Features

  • Native extension (written in C) for performance reasons.
  • Uses library functions as exposed by librrd.
  • Works with Python 2.6, 2.7, 3.3 and any later version.

Installation

The most convenient way to install (on POSIX-like systems) is to use pip:

pip install rrdtool

Note: Unless binary versions are available for your target system, the command above requires rrdtool development files (headers, libraries, dependencies) to be installed, otherwise building the module will fail.

In case you'd like to build the module on your own (regardless of whether binary versions are available for your system), you can obtain a copy of the source code and run python setup.py install in its destination folder to build the module.

Usage

import rrdtool

# Create Round Robin Database
rrdtool.create('test.rrd', '--start', 'now', '--step', '300', 'RRA:AVERAGE:0.5:1:1200', 'DS:temp:GAUGE:600:-273:5000')

# Feed updates to the RRD
rrdtool.update('test.rrd', 'N:32')

Documentation

You can find the latest documentation for this project at https://pythonhosted.org/rrdtool.

License

GNU Lesser General Public License version 2.1.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rrdtool, version 0.1.15
Filename, size File type Python version Upload date Hashes
Filename, size rrdtool-0.1.15.tar.gz (21.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page