.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH EUWATCH-PUT-METRIC-ALARM "1" "March 2016" "euca2ools 3.3" "User Commands"
.SH NAME
euwatch-put-metric-alarm \- Create or update an alarm
.SH SYNOPSIS
euwatch\-put\-metric\-alarm \fB\-\-comparison\-operator\fR
.TP
{GreaterThanOrEqualToThreshold,GreaterThanThreshold,LessThanThreshold,LessThanOrEqualToThreshold}
\fB\-\-evaluation\-periods\fR COUNT \fB\-\-metric\-name\fR
METRIC \fB\-\-namespace\fR NAMESPACE \fB\-\-period\fR SECONDS
\fB\-\-statistic\fR
{Average,Maximum,Minimum,SampleCount,Sum}
\fB\-\-threshold\fR FLOAT
[\-\-actions\-enabled {true,false}]
[\-\-alarm\-actions ARN1,ARN2,...]
[\-\-alarm\-description DESCRIPTION]
[\-d KEY1=VALUE1,KEY2=VALUE2,...]
[\-\-insufficient\-data\-actions ARN1,ARN2,...]
[\-\-ok\-actions ARN1,ARN2,...] [\-\-unit UNIT]
[\-\-show\-empty\-fields] [\-U URL]
[\-\-region USER@REGION] [\-I KEY_ID] [\-S KEY]
[\-\-security\-token TOKEN] [\-\-debug]
[\-\-debugger] [\-\-version] [\-h]
ALARM
.SH DESCRIPTION
Create or update an alarm
.SS "positional arguments:"
.TP
ALARM
name of the alarm (required)
.SS "optional arguments:"
.TP
\fB\-\-comparison\-operator\fR {GreaterThanOrEqualToThreshold,GreaterThanThreshold,LessThanThreshold,LessThanOrEqualToThreshold}
arithmetic operator with which the comparison with the
threshold will be made (required)
.TP
\fB\-\-evaluation\-periods\fR COUNT
number of consecutive periods for which the value of
the metric needs to be compared to the threshold
(required)
.TP
\fB\-\-metric\-name\fR METRIC
name for the alarm's associated metric (required)
.TP
\fB\-\-namespace\fR NAMESPACE
namespace for the alarm's associated metric (required)
.TP
\fB\-\-period\fR SECONDS
period over which the specified statistic is applied
(required)
.TP
\fB\-\-statistic\fR {Average,Maximum,Minimum,SampleCount,Sum}
statistic on which to alarm (required)
.TP
\fB\-\-threshold\fR FLOAT
value to compare the statistic against (required)
.TP
\fB\-\-actions\-enabled\fR {true,false}
whether this alarm's actions should be executed when
it changes state
.TP
\fB\-\-alarm\-actions\fR ARN1,ARN2,...
ARNs of SNS topics to publish to when the alarm
changes to the ALARM state
.TP
\fB\-\-alarm\-description\fR DESCRIPTION
description of the alarm
.TP
\fB\-d\fR KEY1=VALUE1,KEY2=VALUE2,..., \fB\-\-dimensions\fR KEY1=VALUE1,KEY2=VALUE2,...
dimensions for the alarm's associated metric
.TP
\fB\-\-insufficient\-data\-actions\fR ARN1,ARN2,...
ARNs of SNS topics to publish to when the alarm
changes to the INSUFFICIENT_DATA state
.TP
\fB\-\-ok\-actions\fR ARN1,ARN2,...
ARNs of SNS topics to publish to when the alarm
changes to the OK state
.TP
\fB\-\-unit\fR UNIT
unit for the alarm's associated metric
.TP
\fB\-\-show\-empty\-fields\fR
show empty values as "(nil)"
.TP
\fB\-U\fR URL, \fB\-\-url\fR URL
instance monitoring service endpoint URL
.TP
\fB\-\-region\fR USER@REGION
region and/or user names to search when looking up
config file data
.HP
\fB\-I\fR KEY_ID, \fB\-\-access\-key\-id\fR KEY_ID
.HP
\fB\-S\fR KEY, \fB\-\-secret\-key\fR KEY
.HP
\fB\-\-security\-token\fR TOKEN
.TP
\fB\-\-debug\fR
show debugging output
.TP
\fB\-\-debugger\fR
launch interactive debugger on error
.TP
\fB\-\-version\fR
show the program's version and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit