Skip to content
Python client for InfluxDB
Branch: master
Clone or download
shantanoo-desai and xginn8 Add Example for sending information to DB via UDP (#648)
Due to lack of documentation for UDP, this example
provides basic usage of sending information points
via UDP. The code structure followed is similar, if
not same as other examples in the `examples` directory.

Signed-off-by: Shantanoo <shantanoo.desai@gmail.com>
Latest commit d5d1249 Apr 10, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Add Example for sending information to DB via UDP (#648) Apr 10, 2019
examples Add Example for sending information to DB via UDP (#648) Apr 10, 2019
influxdb
.gitignore Added 'env' to .gitignore Apr 27, 2015
.travis.yml [WIP] add py37 and recent influxdb (#692) Mar 15, 2019
CHANGELOG.md add consistency parameter to write_points (#664) Apr 8, 2019
CODEOWNERS Add CODEOWNERS file for automatic reviewers on GitHub Mar 20, 2019
LICENSE Initial commit Nov 5, 2013
MANIFEST.in newline Feb 29, 2016
README.rst Python and influxdb supported versions (#693) Mar 16, 2019
dev-requirements.txt Test on py35 and py36 (#458) Jun 5, 2017
release.sh Add wheel/twine support Mar 29, 2015
requirements.txt updating deps for py27, including pandas Jun 2, 2017
setup.cfg removed unneeded python directory tag Feb 29, 2016
setup.py Fix a warning under Python 3.7 (#697) Apr 7, 2019
test-requirements.txt fixing broken pypy test Oct 28, 2017
test.sh Add a test script Jun 9, 2014
tox.ini [WIP] add py37 and recent influxdb (#692) Mar 15, 2019

README.rst

InfluxDB-Python

https://travis-ci.org/influxdata/influxdb-python.svg?branch=master Documentation Status Coverage PyPI Status

InfluxDB-Python is a client for interacting with InfluxDB.

Development of this library is maintained by:

Github ID URL
@aviau (https://github.com/aviau)
@xginn8 (https://github.com/xginn8)
@sebito91 (https://github.com/sebito91)

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

InfluxDB pre v1.1.0 users

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.

Those users still on InfluxDB v0.8.x users may still use the legacy client by importing from influxdb.influxdb08 import InfluxDBClient.

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.5, 3.6, 3.7, PyPy and PyPy3.

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

Main dependency is:

Additional dependencies are:

Documentation

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

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

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/.

We are also lurking on the following:

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

Development

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

Please note that we WILL get to your questions/issues/concerns as quickly as possible. We maintain many software repositories and sometimes things may get pushed to the backburner. Please don't take offense, we will do our best to reply as soon as possible!

Source code

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

TODO

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

You can’t perform that action at this time.