# salt.returners.influxdb_return

Return data to an influxdb server.

Added in version 2015.8.0.

To enable this returner the minion will need the python client for influxdb installed and the following values configured in the minion or master config, these are the defaults:

    influxdb.db: 'salt'
    influxdb.user: 'salt'
    influxdb.password: 'salt'
    influxdb.host: 'localhost'
    influxdb.port: 8086

Alternative configuration values can be used by prefacing the configuration. Any values not found in the alternative configuration will be pulled from the default location:

    alternative.influxdb.db: 'salt'
    alternative.influxdb.user: 'salt'
    alternative.influxdb.password: 'salt'
    alternative.influxdb.host: 'localhost'
    alternative.influxdb.port: 6379

To use the influxdb returner, append '--return influxdb' to the salt command.

    salt '*' test.ping --return influxdb

To use the alternative configuration, append '--return_config alternative' to the salt command.

    salt '*' test.ping --return influxdb --return_config alternative

To override individual configuration items, append --return_kwargs '{"key:": "value"}' to the salt command.

Added in version 2016.3.0.

    salt '*' test.ping --return influxdb --return_kwargs '{"db": "another-salt"}'

salt.returners.influxdb_return.get_fun(fun)

  Return a dict of the last function called for all minions

salt.returners.influxdb_return.get_jid(jid)

  Return the information returned when the specified job id was executed

salt.returners.influxdb_return.get_jids()

  Return a list of all job ids

salt.returners.influxdb_return.get_load(jid)

  Return the load data that marks a specified jid

salt.returners.influxdb_return.get_minions()

  Return a list of minions

salt.returners.influxdb_return.prep_jid(nocache=False, passed_jid=None)

  Do any work necessary to prepare a JID, including sending a custom id

salt.returners.influxdb_return.returner(ret)

  Return data to a influxdb data store

salt.returners.influxdb_return.save_load(jid, load, minions=None)

  Save the load to the specified jid

salt.returners.influxdb_return.save_minions(jid, minions, syndic_id=None)

  Included for API consistency