1EUWATCH-PUT-METRIC-ALARM(1) User Commands EUWATCH-PUT-METRIC-ALARM(1)
2
3
4
6 euwatch-put-metric-alarm - Create or update an alarm
7
9 euwatch-put-metric-alarm --comparison-operator
10
11 {GreaterThanOrEqualToThreshold,GreaterThanThreshold,LessThanThresh‐
12 old,LessThanOrEqualToThreshold}
13 --evaluation-periods COUNT --metric-name METRIC --namespace
14 NAMESPACE --period SECONDS --statistic {Average,Maximum,Mini‐
15 mum,SampleCount,Sum} --threshold FLOAT [--actions-enabled
16 {true,false}] [--alarm-actions ARN1,ARN2,...] [--alarm-descrip‐
17 tion DESCRIPTION] [-d KEY1=VALUE1,KEY2=VALUE2,...] [--insuffi‐
18 cient-data-actions ARN1,ARN2,...] [--ok-actions ARN1,ARN2,...]
19 [--unit UNIT] [--show-empty-fields] [-U URL] [--region
20 USER@REGION] [-I KEY_ID] [-S KEY] [--security-token TOKEN]
21 [--debug] [--debugger] [--version] [-h] ALARM
22
24 Create or update an alarm
25
26 positional arguments:
27 ALARM name of the alarm (required)
28
29 optional arguments:
30 --comparison-operator {GreaterThanOrEqualToThreshold,GreaterThanThresh‐
31 old,LessThanThreshold,LessThanOrEqualToThreshold}
32 arithmetic operator with which the comparison with the threshold
33 will be made (required)
34
35 --evaluation-periods COUNT
36 number of consecutive periods for which the value of the metric
37 needs to be compared to the threshold (required)
38
39 --metric-name METRIC
40 name for the alarm's associated metric (required)
41
42 --namespace NAMESPACE
43 namespace for the alarm's associated metric (required)
44
45 --period SECONDS
46 period over which the specified statistic is applied (required)
47
48 --statistic {Average,Maximum,Minimum,SampleCount,Sum}
49 statistic on which to alarm (required)
50
51 --threshold FLOAT
52 value to compare the statistic against (required)
53
54 --actions-enabled {true,false}
55 whether this alarm's actions should be executed when it changes
56 state
57
58 --alarm-actions ARN1,ARN2,...
59 ARNs of SNS topics to publish to when the alarm changes to the
60 ALARM state
61
62 --alarm-description DESCRIPTION
63 description of the alarm
64
65 -d KEY1=VALUE1,KEY2=VALUE2,..., --dimensions
66 KEY1=VALUE1,KEY2=VALUE2,...
67 dimensions for the alarm's associated metric
68
69 --insufficient-data-actions ARN1,ARN2,...
70 ARNs of SNS topics to publish to when the alarm changes to the
71 INSUFFICIENT_DATA state
72
73 --ok-actions ARN1,ARN2,...
74 ARNs of SNS topics to publish to when the alarm changes to the
75 OK state
76
77 --unit UNIT
78 unit for the alarm's associated metric
79
80 --show-empty-fields
81 show empty values as "(nil)"
82
83 -U URL, --url URL
84 instance monitoring service endpoint URL
85
86 --region USER@REGION
87 region and/or user names to search when looking up config file
88 data
89
90 -I KEY_ID, --access-key-id KEY_ID
91
92 -S KEY, --secret-key KEY
93
94 --security-token TOKEN
95
96 --debug
97 show debugging output
98
99 --debugger
100 launch interactive debugger on error
101
102 --version
103 show the program's version and exit
104
105 -h, --help
106 show this help message and exit
107
108
109
110euca2ools 3.4 December 2016 EUWATCH-PUT-METRIC-ALARM(1)