Skip to main content

InfluxDB client

Project description

InfluxDB-Python is a client for interacting with InfluxDB.

https://travis-ci.org/influxdb/influxdb-python.svg?branch=master Documentation Status Coverage Downloads Latest Version Supported Python versions License

InfluxDB is an open-source distributed time series database, find more about InfluxDB at http://influxdb.com/

InfluxDB v0.8.X users

InfluxDB 0.9 was released and it is the new recommended version. However, InfluxDB 0.8.x users may still use the legacy client by using from influxdb.influxdb08 import InfluxDBClient instead.

Installation

Install, upgrade and uninstall InfluxDB-Python with these commands:

$ pip install influxdb
$ pip install --upgrade influxdb
$ pip uninstall influxdb

On Debian/Ubuntu, you can install it with this command:

$ sudo apt-get install python-influxdb

Dependencies

The InfluxDB-Python distribution is supported and tested on Python 2.7, 3.2, 3.3, 3.4, PyPy and PyPy3.

Main dependency is:

Additional dependencies are:

Documentation

InfluxDB-Python documentation is available at http://influxdb-python.readthedocs.org

You will need Sphinx installed to generate the documentation.

The documentation can be generated by running:

$ tox -e docs

Generated documentation can be found in the docs/build/html/ directory.

Examples

Here’s a basic example (for more see the examples directory):

$ python

>>> from influxdb import InfluxDBClient

>>> json_body = [
    {
        "measurement": "cpu_load_short",
        "tags": {
            "host": "server01",
            "region": "us-west"
        },
        "time": "2009-11-10T23:00:00Z",
        "fields": {
            "value": 0.64
        }
    }
]

>>> client = InfluxDBClient('localhost', 8086, 'root', 'root', 'example')

>>> client.create_database('example')

>>> client.write_points(json_body)

>>> result = client.query('select value from cpu_load_short;')

>>> print("Result: {0}".format(result))

If you want to connect to a cluster, you could initialize a InfluxDBClusterClient:

$ python

>>> from influxdb import InfluxDBClusterClient

>>> cc = InfluxDBClusterClient(hosts = [('192.168.0.1', 8086),
                                        ('192.168.0.2', 8086),
                                        ('192.168.0.3', 8086)],
                               username='root',
                               password='root',
                               database='example')

InfluxDBClusterClient has the same methods as InfluxDBClient, it basically is a proxy to multiple InfluxDBClients.

Testing

Make sure you have tox by running the following:

$ pip install tox

To test influxdb-python with multiple version of Python, you can use Tox:

$ tox

Support

For issues with, questions about, or feedback for InfluxDB, please look into our community page: http://influxdb.com/community/.

Development

All development is done on Github. Use Issues to report problems or submit contributions.

TODO

The TODO/Roadmap can be found in Github bug tracker: https://github.com/influxdb/influxdb-python/issues

Source code

The source code is currently available on Github: https://github.com/influxdb/influxdb-python

Project details


Download files

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

Source Distribution

influxdb-2.11.0.tar.gz (47.8 kB view hashes)

Uploaded Source

Built Distribution

influxdb-2.11.0-py2.py3-none-any.whl (261.6 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page