Repository files navigation

InfluxDB-python, the InfluxDB Python Client (1.x), is a client library for interacting withInfluxDB 1.x instances.

InfluxDB is the time series platform designed to handle high write and query loads.

This module is tested with InfluxDB versions v1.2.4, v1.3.9, v1.4.3, v1.5.4, v1.6.4, and 1.7.4.

Users on InfluxDB v0.8.x may still use the legacy client by importingfrom influxdb.influxdb08 import InfluxDBClient.

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

The influxdb-python distribution is supported and tested on Python 2.7, 3.5, 3.6, 3.7, PyPy and PyPy3.

Note: Python <3.5 are currently untested. See.travis.yml.

Main dependency is:

• Requests: HTTP library for human beings (http://docs.python-requests.org/)

Additional dependencies are:

• pandas: for writing from and reading to DataFrames (http://pandas.pydata.org/)
• Sphinx: Tool to create and manage the documentation (http://sphinx-doc.org/)
• Nose: to auto-discover tests (http://nose.readthedocs.org/en/latest/)
• Mock: to mock tests (https://pypi.python.org/pypi/mock)

Documentation is available athttps://influxdb-python.readthedocs.io/en/latest/.

You will needSphinx installed to generate the documentation.

The documentation can be generated by running:

$ tox -e docs

Generated documentation can be found in thedocs/build/html/ directory.

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))

Make sure you have tox by running the following:

$ pip install tox

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

$ tox

For issues with, questions about, or feedback forInfluxDB, please look intoour community page:http://influxdb.com/community/.

We are also lurking on the following:

• #influxdb on irc.freenode.net
• #influxdb on gophers.slack.com

The v1 client libraries for InfluxDB 1.x were typically developed and maintained by InfluxDB community members. If you are an InfluxDB v1 user interested in maintaining this client library (at a minimum, keeping it updated with security patches) please contact the InfluxDB team at on theCommunity Forums orInfluxData Slack.

All development is done onGithub. UseIssues to reportproblems or submit contributions.

Please note that we will answer you question as quickly as possible.

Maintainers:

The source code for the InfluxDB Python Client (1.x) is currently available on Github:https://github.com/influxdata/influxdb-python

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