mon-describe-alarms
Description
Gets information on the specified alarms. If you don't specify an alarm name, this command returns information about all of your alarms. You can retrieve alarms by using only the alarm name prefix, the alarm state, or an action prefix.
Syntax
mon-describe-alarms
[AlarmNames [
AlarmNames
...]] [--action-prefix value
] [--alarm-name-prefix value
]
[--state-value value
] [Common Options]
Options
Name | Description |
---|---|
|
The names of the alarms. You can also set this value using
Type: Argument Valid values: An existing alarm name, otherwise no response is returned. Default: n/a, displays all alarms by default. Required: No |
|
Prefix of action names. Type: Argument Valid values: The prefix of an existing action name, in ARN format. Default: n/a, display the first action by default. Required: No |
|
Prefix of alarm names. Type: Argument Valid values: The prefix of an existing alarm name. Default: n/a Required: No |
|
The state of the alarm. Type: Enumeration Valid values: OK, ALARM, or INSUFFICIENT_DATA Default: All alarm states. Required: No |
Common options
Name | Description |
---|---|
|
The location of the file with your AWS credentials. You can set this
value using the environment variable Type: String Valid values: A valid path to a file containing your access key ID and secret access key. Default: Uses the environment variable |
|
The location of your EC2 certificate file for signing requests. You
can use the environment variable Type: String Valid values: A valid file path to the PEM file provided by Amazon EC2 or AWS Identity and Access Management. Default: Uses the environment variable |
|
The connection timeout value, in seconds. Type: Integer Valid values: Any positive number. Default: 30 |
|
The delimiter to use when displaying delimited (long) results. Type: String Valid values: Any string. Default: Comma (,) |
|
If you are displaying tabular or delimited results, include the column headers. If you are showing XML results, return the HTTP headers from the service request, if applicable. Type: Flag Valid values: When present, shows headers. Default: The |
|
The access key ID that will be used, in conjunction with the secret key, to sign the request. This must be used in conjunction with --secret-key, otherwise the option is ignored. All requests to CloudWatch must be signed, otherwise the request is rejected. Type: String Valid values: A valid access key ID. Default: None |
|
The private key that will be used to sign the
request. Using public/private keys causes the CLI to use SOAP. The request is
signed with a public certificate and private key. This parameter must be used in
conjunction with Type: String Valid values: The path to a valid ASN.1 private key. Default: None |
|
The region requests are directed to. You can use the environment
variable Type: String Valid values: Any AWS region, for example, us-east-1. Default: us-east-1, unless the |
|
The secret access key that will be used to sign the request, in conjunction with an access
key ID. This parameter must be used in conjunction with
Type: String Valid values: Your access key ID. Default: None |
|
Shows empty fields using (nil) as a placeholder to indicate that this data was not requested. Type: Flag Valid values: None Default: Empty fields are not shown by default. |
|
Displays the URL the CLI uses to call AWS. Type: Flag Valid values: None Default: false |
|
Specifies how the results are displayed: in a table, delimited (long), XML, or
no output (quiet). The Type: Flag Valid values: None Default: |
|
The URL used to contact CloudWatch. You can set this value using the
environment variable Type: String Valid values: A valid HTTP or HTTPS URL. Default: Uses the value specified in |
Output
This command returns a table that contains the following:
-
ALARM - Alarm name.
-
DESCRIPTION - The alarm description. This column appears only in the --show-long view.
-
STATE - The alarm state.
-
STATE_REASON - A human-readable reason for state. This column appears only in the --show-long view.
-
STATE_REASON_DATA - A machine-readable reason for state (JSON format). This column appears only in the --show-long view.
-
ENABLED - Enables or disables actions. This column appears only in the --show-long view.
-
OK_ACTIONS - The action to execute on OK status. This column appears only in the --show-long view.
-
ALARM_ACTIONS - The action to execute on ALARM status.
-
INSUFFICIENT_DATA_ACTIONS - The action to execute on INSUFFICIENT_DATA status. This column appears only in the --show-long view.
-
NAMESPACE - A namespace for the metric.
-
METRIC_NAME - The name of the metric.
-
DIMENSIONS - The metric dimensions. This column appears only in the --show-long view.
-
PERIOD - The period.
-
STATISTIC - The statistic (Average, Minimum, Maximum, Sum, SampleCount).
-
EXTENDEDSTATISTIC - The percentile statistic.
-
UNIT - The unit. This column appears only in the --show-long view.
-
EVAL_PERIODS - The number of periods to evaluate the metric.
-
COMPARISON - The comparison operator.
-
THRESHOLD - The threshold.
The Amazon CloudWatch CLI displays errors on stderr.
Examples
Example request
This example describes all of your alarms whose name starts with my-alarm.
mon-describe-alarms --alarm-name-prefix my-alarm --headers
This is an example output of this command.
ALARM STATE ALARM_ACTIONS NAMESPACE METRIC_NAME PERIOD STATISTIC EVAL_PERIODS COMPARISON THRESHOLD my-alarm1 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 3 GreaterThanThreshold 100.0 my-alarm2 OK arn:aws:sns:.. AWS/EC2 CPUUtilization 60 Average 5 GreaterThanThreshold 80o.0