mon-describe-alarm-history - Online in the Cloud

PROGRAM:

NAME

mon-describe-alarm-history - Describe alarm history

SYNOPSIS

mon-describe-alarm-history
[AlarmName] [--end-date value ] [--history-item-type value ]
[--start-date value ] [General Options]

DESCRIPTION

Describe alarm history

ARGUMENTS

AlarmName
Names of the alarm. By default history for all alarms will be
returned.
You can also set this value using "--alarm-name".

SPECIFIC OPTIONS

--end-date VALUE
End of date range for history. By default, it is current time.

--history-item-type VALUE
Type of history items you want to retrieve: one of
ConfigurationUpdate,
StateUpdate or Action. By default, all types will be returned.

--start-date VALUE
Start of date range for history. By default it extends to all
available
history.

GENERAL OPTIONS

--aws-credential-file VALUE
Location of the file with your AWS credentials. This value can be
set by
using the environment variable 'AWS_CREDENTIAL_FILE'.

-C, --ec2-cert-file-path VALUE
Location of your EC2 certificate file. This value can be set by
using the
environment variable 'EC2_CERT'.

--connection-timeout VALUE
Specify a connection timeout VALUE (in seconds). The default value
is
'30'.

--delimiter VALUE
What delimiter to use when displaying delimited (long) results.

--headers
If you are displaying tabular or delimited results, it includes the
column headers. If you are showing xml results, it returns the HTTP
headers from the service request, if applicable. This is off by
default.

-I, --access-key-id VALUE
Specify VALUE as the AWS Access Id to use.

-K, --ec2-private-key-file-path VALUE
Location of your EC2 private key file. This value can be set by
using the
environment variable 'EC2_PRIVATE_KEY'.

--region VALUE
Specify region VALUE as the web service region to use. This value
can be
set by using the environment variable 'EC2_REGION'.

-S, --secret-key VALUE
Specify VALUE as the AWS Secret Key to use.

--show-empty-fields
Show empty fields and rows, using a "(nil)" value. The default is
to not
show empty fields or columns.

--show-request
Displays the URL the tools used to call the AWS Service. The
default
value is 'false'.

--show-table, --show-long, --show-xml, --quiet
Specify how the results are displayed: tabular, delimited (long),
xml, or
no output (quiet). Tabular shows a subset of the data in fixed
column-width form, while long shows all of the returned values
delimited
by a character. The xml is the raw return from the service, while
quiet
suppresses all standard output. The default is tabular, or
'show-table'.

-U, --url VALUE
This option will override the URL for the service call with VALUE.
This
value can be set by using the environment variable
'AWS_CLOUDWATCH_URL'.

INPUT EXAMPLES

Describe all history items for the alarm my-alarm

$PROMPT> mon-describe-alarm-history --alarm-name my-alarm --headers

OUTPUT

This command returns a table that contains the following:
* ALARM - Alarm name.
* TIMESTAMP - Timestamp.
* TYPE - Type of event, one of ConfigurationUpdate, StateUpdate and
Action.
* SUMMARY - Human readable summary of history event.
* DATA - Detailed data on event in machine readable JSON format. This
column
appears only in the --show-long view.

OUTPUT EXAMPLES

This is an example output of this command.

ALARM TIMESTAMP TYPE SUMMARY

my-alarm 2010-05-07T18:46:16.121Z Action Published a
notification to arn:aws:sns:... my-alarm 2010-05-07T18:46:16.118Z
StateUpdate ALARM updated from INSUFFICIENT_DATA to OK
my-alarm 2010-05-07T18:46:07.362Z ConfigurationUpdate ALARM
"my-alarm" created

Use mon-describe-alarm-history online using onworks.net services