Current File : //lib/python2.7/site-packages/salt/modules/influxdb08mod.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z y d d l Z e Z Wn e k
rQ e
Z n Xd d l Z e j e
� Z d Z d � Z d d d d d � Z d d d d d � Z d d d d d � Z d d d d d � Z d d d d d
� Z d d d d d d � Z d d d d d d � Z d d d d d d
� Z d d d d d d � Z d d d d d d � Z d d d d d � Z d d d d d � Z e
d d d d d � Z e
d d d d d � Z d e
d d d d d � Z d d d d � Z! d S( u�
InfluxDB - A distributed time series database
Module to provide InfluxDB compatibility to Salt (compatible with InfluxDB
version 0.5-0.8)
.. versionadded:: 2014.7.0
:depends: - influxdb Python module (>= 1.0.0)
:configuration: This module accepts connection configuration details either as
parameters or as configuration settings in /etc/salt/minion on the relevant
minions::
influxdb08.host: 'localhost'
influxdb08.port: 8086
influxdb08.user: 'root'
influxdb08.password: 'root'
This data can also be passed into pillar. Options passed into opts will
overwrite options passed into pillar.
i ( t absolute_importt print_functiont unicode_literalsNu
influxdb08c C@ s t r
t St d f S( u.
Only load if influxdb lib is present
uM The influx execution module cannot be loaded: influxdb library not available.( t HAS_INFLUXDB_08t __virtualname__t False( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt __virtual__+ s c C@ s� | s t d d d � } n | s8 t d d d � } n | sT t d d d � } n | sp t d d d � } n t j j d | d
| d | d | � S(
Nu
config.optionu influxdb08.useru rootu influxdb08.passwordu influxdb08.hostu localhostu influxdb08.porti� t hostt portt usernamet password( t __salt__t influxdbt
influxdb08t InfluxDBClient( t userR
R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt _client4 s c C@ s+ t d | d | d | d | � } | j � S( ue
List all InfluxDB databases
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.db_list
salt '*' influxdb08.db_list <user> <password> <host> <port>
R R
R R ( R t get_list_database( R R
R R t client( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt db_listA s !c C@ sI t | | | | � } t | t � s( t S| g | D] } | d ^ q2 k S( u�
Checks if a database exists in Influxdb
name
Database name to create
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.db_exists <name>
salt '*' influxdb08.db_exists <name> <user> <password> <host> <port>
u name( R t
isinstancet listR ( t nameR R
R R t dbst db( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt db_exists] s c C@ s^ t | | | | | � r, t j d | � t St d | d | d | d | � } | j | � t S( u�
Create a database
name
Database name to create
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.db_create <name>
salt '*' influxdb08.db_create <name> <user> <password> <host> <port>
u DB '%s' already existsR R
R R ( R t logt infoR R t create_databaset True( R R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt db_create} s !
c C@ sZ t | | | | | � s, t j d | � t St d | d | d | d | � } | j | � S( u�
Remove a database
name
Database name to remove
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.db_remove <name>
salt '*' influxdb08.db_remove <name> <user> <password> <host> <port>
u DB '%s' does not existR R
R R ( R R R R R t delete_database( R R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt db_remove� s
!c C@ sH t d | d | d | d | � } | s1 | j � S| j | � | j � S( uv
List cluster admins or database users.
If a database is specified: it will return database users list.
If a database is not specified: it will return cluster admins list.
database
The database to list the users from
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.user_list
salt '*' influxdb08.user_list <database>
salt '*' influxdb08.user_list <database> <user> <password> <host> <port>
R R
R R ( R t get_list_cluster_adminst switch_databaset get_list_users( t databaseR R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt user_list� s
!
c C@ s� t | | | | | � } t | t � s+ t SxR | D]J } | j d | j d � � } | rl | | k r| t Sq2 t j d | � q2 Wt S( u�
Checks if a cluster admin or database user exists.
If a database is specified: it will check for database user existence.
If a database is not specified: it will check for cluster admin existence.
name
User name
database
The database to check for the user to exist
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.user_exists <name>
salt '*' influxdb08.user_exists <name> <database>
salt '*' influxdb08.user_exists <name> <database> <user> <password> <host> <port>
u useru nameu# Could not find username in user: %s( R% R R R t getR R t warning( R R$ R R
R R t usersR ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt user_exists� s !
c C@ s� t | | | | | | � rK | r7 t j d | | � n t j d | � t St d | d | d | d | � } | s� | j | | � S| j | � | j | | � S( u
Create a cluster admin or a database user.
If a database is specified: it will create database user.
If a database is not specified: it will create a cluster admin.
name
User name for the new user to create
passwd
Password for the new user to create
database
The database to create the user in
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.user_create <name> <passwd>
salt '*' influxdb08.user_create <name> <passwd> <database>
salt '*' influxdb08.user_create <name> <passwd> <database> <user> <password> <host> <port>
u$ User '%s' already exists for DB '%s'u! Cluster admin '%s' already existsR R
R R ( R) R R R R t add_cluster_adminR" t add_database_user( R t passwdR$ R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt user_create s *!
c C@ s� t | | | | | | � sK | r7 t j d | | � n t j d | � t St d | d | d | d | � } | s� | j | | � S| j | � | j | | � S( u
Change password for a cluster admin or a database user.
If a database is specified: it will update database user password.
If a database is not specified: it will update cluster admin password.
name
User name for whom to change the password
passwd
New password
database
The database on which to operate
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.user_chpass <name> <passwd>
salt '*' influxdb08.user_chpass <name> <passwd> <database>
salt '*' influxdb08.user_chpass <name> <passwd> <database> <user> <password> <host> <port>
u$ User '%s' does not exist for DB '%s'u! Cluster admin '%s' does not existR R
R R ( R) R R R R t update_cluster_admin_passwordR" t update_database_user_password( R R, R$ R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt user_chpassR s *!
c C@ s� t | | | | | | � sK | r7 t j d | | � n t j d | � t St d | d | d | d | � } | s | j | � S| j | � | j | � S( u�
Remove a cluster admin or a database user.
If a database is specified: it will remove the database user.
If a database is not specified: it will remove the cluster admin.
name
User name to remove
database
The database to remove the user from
user
User name for the new user to delete
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.user_remove <name>
salt '*' influxdb08.user_remove <name> <database>
salt '*' influxdb08.user_remove <name> <database> <user> <password> <host> <port>
u$ User '%s' does not exist for DB '%s'u! Cluster admin '%s' does not existR R
R R ( R) R R R R t delete_cluster_adminR" t delete_database_user( R R$ R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt user_remove� s )!
c C@ sS t d | d | d | d | � } x+ | j | � D] } | d | k r1 | Sq1 Wd S( u�
Get an existing retention policy.
database
The database to operate on.
name
Name of the policy to modify.
CLI Example:
.. code-block:: bash
salt '*' influxdb08.retention_policy_get metrics default
R R
R R u nameN( R t get_list_retention_policiest None( R$ R R R
R R R t policy( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt retention_policy_get� s
!c C@ s% t | | | | | | � } | d k S( u
Check if a retention policy exists.
database
The database to operate on.
name
Name of the policy to modify.
CLI Example:
.. code-block:: bash
salt '*' influxdb08.retention_policy_exists metrics default
N( R7 R5 ( R$ R R R
R R R6 ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt retention_policy_exists� s c
C@ s> t d | d | d | d | � } | j | | | | | � t S( u�
Add a retention policy.
database
The database to operate on.
name
Name of the policy to modify.
duration
How long InfluxDB keeps the data.
replication
How many copies of the data are stored in the cluster.
default
Whether this policy should be the default or not. Default is False.
CLI Example:
.. code-block:: bash
salt '*' influxdb.retention_policy_add metrics default 1d 1
R R
R R ( R t create_retention_policyR (
R$ R t durationt replicationt defaultR R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt retention_policy_add� s !!c
C@ s> t d | d | d | d | � } | j | | | | | � t S( u�
Modify an existing retention policy.
database
The database to operate on.
name
Name of the policy to modify.
duration
How long InfluxDB keeps the data.
replication
How many copies of the data are stored in the cluster.
default
Whether this policy should be the default or not. Default is False.
CLI Example:
.. code-block:: bash
salt '*' influxdb08.retention_policy_modify metrics default 1d 1
R R
R R ( R t alter_retention_policyR (
R$ R R: R; R< R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt retention_policy_alter" s !!u sc C@ sG t d | d | d | d | � } | j | � | j | d | d | �S( u[
Querying data
database
The database to query
query
Query to be executed
time_precision
Time precision to use ('s', 'm', or 'u')
chunked
Whether is chunked or not
user
The user to connect as
password
The password of the user
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.query <database> <query>
salt '*' influxdb08.query <database> <query> <time_precision> <chunked> <user> <password> <host> <port>
R R
R R t time_precisiont chunked( R R" t query( R$ RB R@ RA R R
R R R ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyRB H s *!
c C@ sl y3 t d | d | d | d | � } | j � t SWn2 t j j j k
rg } | j d k ra t S� n Xd S( u�
Checks if a credential pair can log in at all.
If a database is specified: it will check for database user existence.
If a database is not specified: it will check for cluster admin existence.
name
The user to connect as
password
The password of the user
database
The database to try to log in to
host
The host to connect to
port
The port to connect to
CLI Example:
.. code-block:: bash
salt '*' influxdb08.login_test <name>
salt '*' influxdb08.login_test <name> <database>
salt '*' influxdb08.login_test <name> <database> <user> <password> <host> <port>
R R
R R i� N( R R R R R
R t InfluxDBClientErrort codeR ( R R
R$ R R R t e( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt
login_testw s !
(" t __doc__t
__future__R R R t influxdb.influxdb08R R R t ImportErrorR t loggingt getLoggert __name__R R R R5 R R R R R R% R) R- R0 R3 R7 R8 R= R? RB RF ( ( ( s> /usr/lib/python2.7/site-packages/salt/modules/influxdb08mod.pyt <module> sr
"!'3 6 5 6 " (
Mini Shell