Current File : //usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z d d l Z
d d l j j
Z
d d l Z
e j e � Z yS d d l Z d d l Z d d l Z d d l Z e j d � j e j � e Z Wn e k
r� e Z n Xd � Z d d d d d � Z d � Z d d d d d d � Z d d d d d d d d d d d
d d d d d d d d d � Z! d d d d d � Z" d d d d d
� Z# d � Z$ d S( u�
Connection module for Amazon CloudWatch
.. versionadded:: 2014.7.0
:configuration: This module accepts explicit credentials but can also utilize
IAM roles assigned to the instance through Instance Profiles. Dynamic
credentials are then automatically obtained from AWS API and no further
configuration is necessary. More Information available at:
.. code-block:: text
http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html
If IAM roles are not used you need to specify them either in a pillar or
in the minion's config file:
.. code-block:: yaml
cloudwatch.keyid: GKTADJGHEIQSXMKKRBJ08H
cloudwatch.key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
A region may also be specified in the configuration:
.. code-block:: yaml
cloudwatch.region: us-east-1
If a region is not specified, the default is us-east-1.
It's also possible to specify key, keyid and region via a profile, either
as a passed in dict, or as a string to pull from pillars or minion config:
.. code-block:: yaml
myprofile:
keyid: GKTADJGHEIQSXMKKRBJ08H
key: askdjghsdfjkghWupUjasdflkdfklgjsdfjajkghs
region: us-east-1
:depends: boto
i ( t absolute_importt print_functiont unicode_literalsN( t sixu botoc C@ sH t j j j d t � } | t k rD t d t d d d d t �n | S( u,
Only load if boto libraries exist.
t check_boto3u boto.assign_funcsu
cloudwatcht moduleu ec2.cloudwatcht pack( t saltt utilst versionst check_boto_reqst Falset Truet __utils__t __name__t __salt__( t
has_boto_reqs( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt __virtual__I s
c C@ s t d | d | d | d | � } | j d | g � } t | � d k rL d St | � d k rq t j d | � n t | d � S(
u�
Get alarm details. Also can be used to check to see if an alarm exists.
CLI example::
salt myminion boto_cloudwatch.get_alarm myalarm region=us-east-1
t regiont keyt keyidt profilet alarm_namesi i u! multiple alarms matched name '%s'N( t _get_connt describe_alarmst lent Nonet logt errort _metric_alarm_to_dict( t nameR R R R t connt alarms( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt get_alarmU s !c C@ sz t d d � } d � } t j t j j j j | d | �d � } t j t j j j j | d | �t d | d | �S( uv
this presenter magic makes yaml.safe_dump
work with the objects returned from
boto.describe_alarms()
u yaml.get_dumperu SafeOrderedDumperc S@ s | j t | � � S( N( t represent_listt list( t dumpert data( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt boto_listelement_presentero s t Dumperc S@ s | j t | � � S( N( t represent_dictt dict( R$ R% ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt dimension_presenterv s u yaml.dump(
R
t yamlt add_representert botot ec2t
cloudwatcht listelementt ListElementt dimensiont Dimension( R% t
custom_dumperR& R* ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt
_safe_dumpg s
c C@ s� t d | d | d | d | � } | j � } t j � } x� | D]~ } t | � } | d } | r� | j | � rw q@ n | | d } n | d =i | d 6i | d 6g }
i |
d 6| d | <q@ Wt | � S( u7
Get all alarm details. Produces results that can be used to create an sls
file.
If prefix parameter is given, alarm names in the output will be prepended
with the prefix; alarms that have the prefix will be skipped. This can be
used to convert existing alarms to be managed by salt, as follows:
1. Make a "backup" of all existing alarms
$ salt-call boto_cloudwatch.get_all_alarms --out=txt | sed "s/local: //" > legacy_alarms.sls
2. Get all alarms with new prefixed names
$ salt-call boto_cloudwatch.get_all_alarms "prefix=**MANAGED BY SALT** " --out=txt | sed "s/local: //" > managed_alarms.sls
3. Insert the managed alarms into cloudwatch
$ salt-call state.template managed_alarms.sls
4. Manually verify that the new alarms look right
5. Delete the original alarms
$ sed s/present/absent/ legacy_alarms.sls > remove_legacy_alarms.sls
$ salt-call state.template remove_legacy_alarms.sls
6. Get all alarms again, verify no changes
$ salt-call boto_cloudwatch.get_all_alarms --out=txt | sed "s/local: //" > final_alarms.sls
$ diff final_alarms.sls managed_alarms.sls
CLI example::
salt myminion boto_cloudwatch.get_all_alarms region=us-east-1 --out=txt
R R R R u nameu
attributesu boto_cloudwatch_alarm.presentu
manage alarm ( R R t odictt OrderedDictR t
startswithR5 ( R t prefixR R R R R t resultst alarmR t alarm_sls( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt get_all_alarms s !!
u c C@ s0 | r t | � } n | r* t | � } n | r? t | � } n t | t j � r� t j j j | � } t | t � s� t
j d | � t Sn t | t j � r� | j
d � } n t |
t j � r� |
j
d � }
n t | t j � r� | j
d � } n | r%t | d | d | d | d | �} n |
rRt |
d | d | d | d | �}
n | rt | d | d | d | d | �} n t d | d | d | d | � } t j j j j d | d | d | d
| d | d | d
| d | d | d | d |
d | d | d |
d | � } | j | � t
j d | � t S( u=
Create or update a cloudwatch alarm.
Params are the same as:
https://boto.readthedocs.io/en/latest/ref/cloudwatch.html#boto.ec2.cloudwatch.alarm.MetricAlarm.
Dimensions must be a dict. If the value of Dimensions is a string, it will
be json decoded to produce a dict. alarm_actions, insufficient_data_actions,
and ok_actions must be lists of string. If the passed-in value is a string,
it will be split on "," to produce a list. The strings themselves for
alarm_actions, insufficient_data_actions, and ok_actions must be Amazon
resource names (ARN's); however, this method also supports an arn lookup
notation, as follows:
arn:aws:.... ARN as per http://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
scaling_policy:<as_name>:<scaling_policy_name> The named autoscale group scaling policy, for the named group (e.g. scaling_policy:my-asg:ScaleDown)
This is convenient for setting up autoscaling as follows. First specify a
boto_asg.present state for an ASG with scaling_policies, and then set up
boto_cloudwatch_alarm.present states which have alarm_actions that
reference the scaling_policy.
CLI example:
salt myminion boto_cloudwatch.create_alarm name=myalarm ... region=us-east-1
uJ could not parse dimensions argument: must be json encoding of a dict: '%s'u ,R R R R t
connectionR t metrict namespacet statistict
comparisont thresholdt periodt evaluation_periodst unitt descriptiont
dimensionst
alarm_actionst insufficient_data_actionst
ok_actionsu Created/updated alarm %s( t floatt intt
isinstanceR t string_typesR R t jsont loadsR) R R R t splitt convert_to_arnR R- R. R/ R; t MetricAlarmt create_alarmt infoR ( R> R R? R@ RA RB RC RD RE RF RG RH RI RJ RK R R R R R R; ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt create_or_update_alarm� sn " !
c C@ s� g } x� | D]� } | j d � r� | j d � \ } } } t d | | | | | | � }
|
ro | j |
� q� t j d | � q
| j | � q
W| S( u�
Convert a list of strings into actual arns. Converts convenience names such
as 'scaling_policy:...'
CLI Example::
salt '*' convert_to_arn 'scaling_policy:'
u scaling_policy:u :u boto_asg.get_scaling_policy_arnu Could not convert: %s( R8 RR R t appendR R ( t arnsR R R R R: t arnt _t as_groupt scaling_policy_namet
policy_arn( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyRS s
c C@ sE t d | d | d | d | � } | j | g � t j d | � t S( u�
Delete a cloudwatch alarm
CLI example to delete a queue::
salt myminion boto_cloudwatch.delete_alarm myalarm region=us-east-1
R R R R u Deleted alarm %s( R t
delete_alarmsR RV R ( R R R R R R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt delete_alarm+ s !c C@ sv t j � } d d d d d d d d d d
d d d
d g } x3 | D]+ } t | | � rC t | | � | | <qC qC W| S( uk
Convert a boto.ec2.cloudwatch.alarm.MetricAlarm into a dict. Convenience
for pretty printing.
u nameu metricu namespaceu statisticu
comparisonu thresholdu periodu evaluation_periodsu unitu descriptionu
dimensionsu
alarm_actionsu insufficient_data_actionsu
ok_actions( R6 R7 t hasattrt getattr( R; t dt fieldst f( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyR : s
(% t __doc__t
__future__R R R t loggingR+ t salt.extR t salt.utils.jsonR t salt.utils.odictR R6 t salt.utils.versionst getLoggerR R R- t boto.ec2.cloudwatcht boto.ec2.cloudwatch.listelementt boto.ec2.cloudwatch.dimensiont setLevelt CRITICALR t HAS_BOTOt ImportErrorR R R R! R5 R= RW RS R` R ( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/boto_cloudwatch.pyt <module>+ s>
3 Z
Mini Shell