Current File : //lib/python2.7/site-packages/salt/modules/influxdbmod.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
d d l Z d d l Z
d d l m Z e j e � Z d Z d � Z d d d d d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z d � Z e d � Z d � Z d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& e d � Z' e d � Z( d � Z) d � Z* d � Z+ d � Z, d � Z- d d d � Z. d � Z/ d � Z0 d! � Z1 d S(" u�
InfluxDB - A distributed time series database
Module to provide InfluxDB compatibility to Salt (compatible with InfluxDB
version 0.9+)
:depends: - influxdb Python module (>= 3.0.0)
:configuration: This module accepts connection configuration details either as
parameters or as configuration settings in /etc/salt/minion on the relevant
minions::
influxdb.host: 'localhost'
influxdb.port: 8086
influxdb.user: 'root'
influxdb.password: 'root'
This data can also be passed into pillar. Options passed into opts will
overwrite options passed into pillar.
Most functions in this module allow you to override or provide some or all
of these settings via keyword arguments::
salt '*' influxdb.foo_function user='influxadmin' passwd='s3cr1t'
would override ``user`` and ``password`` while still using the defaults for
``host`` and ``port``.
i ( t absolute_importt print_functiont unicode_literalsN( t STATE_INTERNAL_KEYWORDSu influxdbc C@ s t r
t St d f S( u.
Only load if influxdb lib is present
uQ The influxdb execution module could not be loaded:influxdb library not available.( t HAS_INFLUXDBt __virtualname__t False( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt __virtual__3 s c
K@ 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 x$ t D] } | | k rw | | =qw qw Wt j d | d
| d | d | | � S(
Nu
config.optionu
influxdb.useru rootu influxdb.passwordu
influxdb.hostu localhostu
influxdb.porti� t hostt portt usernamet password( t __salt__t _STATE_INTERNAL_KEYWORDSt influxdbt InfluxDBClient( t
influxdb_usert influxdb_passwordt
influxdb_hostt
influxdb_portt client_argst ignore( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt _client= s
c K@ s t | � } | j � S( uv
List all InfluxDB databases.
CLI Example:
.. code-block:: bash
salt '*' influxdb.list_dbs
( R t get_list_database( R t client( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt list_dbsP s
c K@ s1 | g t | � D] } | d ^ q k r- t St S( u�
Checks if a database exists in InfluxDB.
name
Name of the database to check.
CLI Example:
.. code-block:: bash
salt '*' influxdb.db_exists <name>
u name( R t TrueR ( t nameR t db( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt db_exists_ s
)c K@ s@ t | | � r# t j d | � t St | � } | j | � t S( u�
Create a database.
name
Name of the database to create.
CLI Example:
.. code-block:: bash
salt '*' influxdb.create_db <name>
u DB '%s' already exists( R t logt infoR R t create_databaseR ( R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt create_dbr s
c K@ s@ t | | � s# t j d | � t St | � } | j | � t S( u�
Drop a database.
name
Name of the database to drop.
CLI Example:
.. code-block:: bash
salt '*' influxdb.drop_db <name>
u DB '%s' does not exist( R R R R R t
drop_databaseR ( R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt drop_db� s
c K@ s t | � } | j � S( uk
List all users.
CLI Example:
.. code-block:: bash
salt '*' influxdb.list_users
( R t get_list_users( R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt
list_users� s
c K@ s t | | � r t St S( u�
Check if a user exists.
name
Name of the user to check.
CLI Example:
.. code-block:: bash
salt '*' influxdb.user_exists <name>
( t user_infoR R ( R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt user_exists� s
c @ sB � f d � t | � D� } y t | � SWn t k
r= n Xd S( u�
Get information about given user.
name
Name of the user for which to get information.
CLI Example:
.. code-block:: bash
salt '*' influxdb.user_info <name>
c 3@ s* | ] } | j d � � k r | Vq d S( u userN( t get( t .0t user( R ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pys <genexpr>� s N( R% t nextt
StopIteration( R R t matching_users( ( R s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR& � s
c K@ sF t | | � r# t j d | � t St | � } | j | | | � t S( u�
Create a user.
name
Name of the user to create.
passwd
Password of the new user.
admin : False
Whether the user should have cluster administration
privileges or not.
CLI Example:
.. code-block:: bash
salt '*' influxdb.create_user <name> <password>
salt '*' influxdb.create_user <name> <password> admin=True
u User '%s' already exists( R' R R R R t create_userR ( R t passwdt adminR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR. � s c K@ sC t | | � s# t j d | � t St | � } | j | | � t S( u�
Change password of a user.
name
Name of the user for whom to set the password.
passwd
New password of the user.
CLI Example:
.. code-block:: bash
salt '*' influxdb.set_user_password <name> <password>
u User '%s' does not exist( R' R R R R t set_user_passwordR ( R R/ R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR1 � s c K@ s t | � } | j | � t S( u�
Grant cluster administration privileges to a user.
name
Name of the user to whom admin privileges will be granted.
CLI Example:
.. code-block:: bash
salt '*' influxdb.grant_admin_privileges <name>
( R t grant_admin_privilegesR ( R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR2 s
c K@ s t | � } | j | � t S( u�
Revoke cluster administration privileges from a user.
name
Name of the user from whom admin privileges will be revoked.
CLI Example:
.. code-block:: bash
salt '*' influxdb.revoke_admin_privileges <name>
( R t revoke_admin_privilegesR ( R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR3 $ s
c K@ s@ t | | � s# t j d | � t St | � } | j | � t S( u�
Remove a user.
name
Name of the user to remove
CLI Example:
.. code-block:: bash
salt '*' influxdb.remove_user <name>
u User '%s' does not exist( R' R R R R t drop_userR ( R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt remove_user7 s
c @ sL t | � } y' t � f d � | j | � D� � SWn t k
rG i SXd S( u&
Get an existing retention policy.
database
Name of the database for which the retention policy was
defined.
name
Name of the retention policy.
CLI Example:
.. code-block:: bash
salt '*' influxdb.get_retention_policy metrics default
c 3@ s* | ] } | j d � � k r | Vq d S( u nameN( R( ( R) t p( R ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pys <genexpr>b s N( R R+ t get_list_retention_policiesR, ( t databaseR R R ( ( R s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt get_retention_policyN s
'
c K@ s t | | | � r t St S( uB
Check if retention policy with given name exists.
database
Name of the database for which the retention policy was
defined.
name
Name of the retention policy to check.
CLI Example:
.. code-block:: bash
salt '*' influxdb.retention_policy_exists metrics default
( R9 R R ( R8 R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt retention_policy_existsh s c K@ s t | � } | j | | � t S( u
Drop a retention policy.
database
Name of the database for which the retention policy will be dropped.
name
Name of the retention policy to drop.
CLI Example:
.. code-block:: bash
salt '*' influxdb.drop_retention_policy mydb mypr
( R t drop_retention_policyR ( R8 R R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR; s c K@ s) t | � } | j | | | | | � t S( u�
Create a retention policy.
database
Name of the database for which the retention policy will be created.
name
Name of the new retention policy.
duration
Duration of the new retention policy.
Durations such as 1h, 90m, 12h, 7d, and 4w, are all supported and mean
1 hour, 90 minutes, 12 hours, 7 day, and 4 weeks, respectively. For
infinite retention – meaning the data will never be deleted – use 'INF'
for duration. The minimum retention period is 1 hour.
replication
Replication factor of the retention policy.
This determines how many independent copies of each data point are
stored in a cluster.
default : False
Whether or not the policy as default will be set as default.
CLI Example:
.. code-block:: bash
salt '*' influxdb.create_retention_policy metrics default 1d 1
( R t create_retention_policyR ( R8 R t durationt replicationt defaultR R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR< � s & c K@ s) t | � } | j | | | | | � t S( u�
Modify an existing retention policy.
name
Name of the retention policy to modify.
database
Name of the database for which the retention policy was defined.
duration
New duration of given retention policy.
Durations such as 1h, 90m, 12h, 7d, and 4w, are all supported
and mean 1 hour, 90 minutes, 12 hours, 7 day, and 4 weeks,
respectively. For infinite retention – meaning the data will
never be deleted – use 'INF' for duration.
The minimum retention period is 1 hour.
replication
New replication of given retention policy.
This determines how many independent copies of each data point are
stored in a cluster.
default : False
Whether or not to set the modified policy as default.
CLI Example:
.. code-block:: bash
salt '*' influxdb.alter_retention_policy metrics default 1d 1
( R t alter_retention_policyR ( R8 R R= R> R? R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyR@ � s ' c K@ sR t | � } i } x9 | j | � D]( } | d j � d j � | | d <q" W| S( u�
List privileges from a user.
name
Name of the user from whom privileges will be listed.
CLI Example:
.. code-block:: bash
salt '*' influxdb.list_privileges <name>
u privilegei u database( R t get_list_privilegest splitt lower( R R R t rest item( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt list_privileges� s
&c K@ s# t | � } | j | | | � t S( u
Grant a privilege on a database to a user.
database
Name of the database to grant the privilege on.
privilege
Privilege to grant. Can be one of 'read', 'write' or 'all'.
username
Name of the user to grant the privilege to.
( R t grant_privilegeR ( R8 t privilegeR
R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyRG s
c K@ s# t | � } | j | | | � t S( u
Revoke a privilege on a database from a user.
database
Name of the database to grant the privilege on.
privilege
Privilege to grant. Can be one of 'read', 'write' or 'all'.
username
Name of the user to grant the privilege to.
( R t revoke_privilegeR ( R8 RH R
R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyRI s
c K@ s t | | | � r t St S( uR
Check if continuous query with given name exists on the database.
database
Name of the database for which the continuous query was
defined.
name
Name of the continuous query to check.
CLI Example:
.. code-block:: bash
salt '*' influxdb.continuous_query_exists metrics default
( t get_continuous_queryR R ( R8 R R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt continuous_query_exists* s c @ sy t | � } yT xM | j d � j � D]6 \ } } | d | k r% t � f d � | D� � Sq% WWn t k
rt i SXi S( u+
Get an existing continuous query.
database
Name of the database for which the continuous query was
defined.
name
Name of the continuous query to get.
CLI Example:
.. code-block:: bash
salt '*' influxdb.get_continuous_query mydb cq_month
u SHOW CONTINUOUS QUERIESi c 3@ s* | ] } | j d � � k r | Vq d S( u nameN( R( ( R) t cq( R ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pys <genexpr>W s ( R t queryt itemsR+ R, ( R8 R R R R t cqs( ( R s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyRJ A s ""
c K@ s} t | � } d } | r% | d 7} n | r8 | d 7} n | d 7} | j d | d | d | d | d | � } | j | � t S(
uX
Create a continuous query.
database
Name of the database for which the continuous query will be
created on.
name
Name of the continuous query to create.
query
The continuous query string.
resample_time : None
Duration between continuous query resampling.
coverage_period : None
Duration specifying time period per sample.
CLI Example:
.. code-block:: bash
salt '*' influxdb.create_continuous_query mydb cq_month 'SELECT mean(*) INTO mydb.a_month.:MEASUREMENT FROM mydb.a_week./.*/ GROUP BY time(5m), *' u, CREATE CONTINUOUS QUERY {name} ON {database}u RESAMPLE EVERY {resample_time}u FOR {coverage_period}u BEGIN {query} ENDR R8 RM t
resample_timet coverage_period( R t formatRM R ( R8 R RM RP RQ R R t
full_query( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt create_continuous_query] s
c K@ s/ t | � } d j | | � } | j | � t S( u'
Drop a continuous query.
database
Name of the database for which the continuous query will
be drop from.
name
Name of the continuous query to drop.
CLI Example:
.. code-block:: bash
salt '*' influxdb.drop_continuous_query mydb my_cq
u DROP CONTINUOUS QUERY {0} ON {1}( R RR RM R ( R8 R R R RM ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt drop_continuous_query� s
c C@ s� t j d � � } x| | j � D]n \ } } | \ } } | rp g | D] } | ^ qD | | t j j j | � <q g | D] } | ^ qw | | <q Wt t | j � � � S( u�
Parses a ResultSet returned from InfluxDB into a dictionary of results,
grouped by series names and optional JSON-encoded grouping tags.
c S@ s i S( N( ( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt <lambda>� s ( t collectionst defaultdictRN t saltt utilst jsont dumpst dictt sorted( t resultsett _resultst _headert _valuest _group_tagst _value( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt _pull_query_results� s 3!c K@ so t | � } | j | d | �} t | t j � rV g | D] } | r: t | � ^ q: S| rh t | � n i g S( u|
Execute a query.
database
Name of the database to query on.
query
InfluxQL query string.
R8 ( R RM t
isinstanceRW t SequenceRe ( R8 RM R R t _resultt
_query_result( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyRM � s
#(2 t __doc__t
__future__R R R R R R t ImportErrorR RW t loggingt salt.utils.jsonRY t
salt.stateR R
t getLoggert __name__R R R t NoneR R R R! R# R% R' R& R. R1 R2 R3 R5 R9 R: R; R< R@ RF RG RI RK RJ RT RU Re RM ( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/influxdbmod.pyt <module> sP
- ) +
Mini Shell