@Generated(value="software.amazon.awssdk:codegen") public final class MetricAlarm extends Object implements SdkPojo, Serializable, ToCopyableBuilder<MetricAlarm.Builder,MetricAlarm>
Represents an alarm.
Modifier and Type | Class and Description |
---|---|
static interface |
MetricAlarm.Builder |
Modifier and Type | Method and Description |
---|---|
Boolean |
actionsEnabled()
Indicates whether actions should be executed during any changes to the alarm state.
|
List<String> |
alarmActions()
The actions to execute when this alarm transitions to the
ALARM state from any other state. |
String |
alarmArn()
The Amazon Resource Name (ARN) of the alarm.
|
Instant |
alarmConfigurationUpdatedTimestamp()
The time stamp of the last update to the alarm configuration.
|
String |
alarmDescription()
The description of the alarm.
|
String |
alarmName()
The name of the alarm.
|
static MetricAlarm.Builder |
builder() |
ComparisonOperator |
comparisonOperator()
The arithmetic operation to use when comparing the specified statistic and threshold.
|
String |
comparisonOperatorAsString()
The arithmetic operation to use when comparing the specified statistic and threshold.
|
Integer |
datapointsToAlarm()
The number of datapoints that must be breaching to trigger the alarm.
|
List<Dimension> |
dimensions()
The dimensions for the metric associated with the alarm.
|
boolean |
equals(Object obj) |
boolean |
equalsBySdkFields(Object obj) |
String |
evaluateLowSampleCountPercentile()
Used only for alarms based on percentiles.
|
Integer |
evaluationPeriods()
The number of periods over which data is compared to the specified threshold.
|
String |
extendedStatistic()
The percentile statistic for the metric associated with the alarm.
|
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
int |
hashCode() |
List<String> |
insufficientDataActions()
The actions to execute when this alarm transitions to the
INSUFFICIENT_DATA state from any other
state. |
String |
metricName()
The name of the metric associated with the alarm, if this is an alarm based on a single metric.
|
List<MetricDataQuery> |
metrics()
An array of MetricDataQuery structures, used in an alarm based on a metric math expression.
|
String |
namespace()
The namespace of the metric associated with the alarm.
|
List<String> |
okActions()
The actions to execute when this alarm transitions to the
OK state from any other state. |
Integer |
period()
The period, in seconds, over which the statistic is applied.
|
List<SdkField<?>> |
sdkFields() |
static Class<? extends MetricAlarm.Builder> |
serializableBuilderClass() |
String |
stateReason()
An explanation for the alarm state, in text format.
|
String |
stateReasonData()
An explanation for the alarm state, in JSON format.
|
Instant |
stateUpdatedTimestamp()
The time stamp of the last update to the alarm state.
|
StateValue |
stateValue()
The state value for the alarm.
|
String |
stateValueAsString()
The state value for the alarm.
|
Statistic |
statistic()
The statistic for the metric associated with the alarm, other than percentile.
|
String |
statisticAsString()
The statistic for the metric associated with the alarm, other than percentile.
|
Double |
threshold()
The value to compare with the specified statistic.
|
String |
thresholdMetricId()
In an alarm based on an anomaly detection model, this is the ID of the
ANOMALY_DETECTION_BAND
function used as the threshold for the alarm. |
MetricAlarm.Builder |
toBuilder() |
String |
toString()
Returns a string representation of this object.
|
String |
treatMissingData()
Sets how this alarm is to handle missing data points.
|
StandardUnit |
unit()
The unit of the metric associated with the alarm.
|
String |
unitAsString()
The unit of the metric associated with the alarm.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
copy
public String alarmName()
The name of the alarm.
public String alarmArn()
The Amazon Resource Name (ARN) of the alarm.
public String alarmDescription()
The description of the alarm.
public Instant alarmConfigurationUpdatedTimestamp()
The time stamp of the last update to the alarm configuration.
public Boolean actionsEnabled()
Indicates whether actions should be executed during any changes to the alarm state.
public List<String> okActions()
The actions to execute when this alarm transitions to the OK
state from any other state. Each action
is specified as an Amazon Resource Name (ARN).
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
OK
state from any other state.
Each action is specified as an Amazon Resource Name (ARN).public List<String> alarmActions()
The actions to execute when this alarm transitions to the ALARM
state from any other state. Each
action is specified as an Amazon Resource Name (ARN).
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
ALARM
state from any other state.
Each action is specified as an Amazon Resource Name (ARN).public List<String> insufficientDataActions()
The actions to execute when this alarm transitions to the INSUFFICIENT_DATA
state from any other
state. Each action is specified as an Amazon Resource Name (ARN).
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
INSUFFICIENT_DATA
state from any
other state. Each action is specified as an Amazon Resource Name (ARN).public StateValue stateValue()
The state value for the alarm.
If the service returns an enum value that is not available in the current SDK version, stateValue
will
return StateValue.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
stateValueAsString()
.
StateValue
public String stateValueAsString()
The state value for the alarm.
If the service returns an enum value that is not available in the current SDK version, stateValue
will
return StateValue.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
stateValueAsString()
.
StateValue
public String stateReason()
An explanation for the alarm state, in text format.
public String stateReasonData()
An explanation for the alarm state, in JSON format.
public Instant stateUpdatedTimestamp()
The time stamp of the last update to the alarm state.
public String metricName()
The name of the metric associated with the alarm, if this is an alarm based on a single metric.
public String namespace()
The namespace of the metric associated with the alarm.
public Statistic statistic()
The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use
ExtendedStatistic
.
If the service returns an enum value that is not available in the current SDK version, statistic
will
return Statistic.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
statisticAsString()
.
ExtendedStatistic
.Statistic
public String statisticAsString()
The statistic for the metric associated with the alarm, other than percentile. For percentile statistics, use
ExtendedStatistic
.
If the service returns an enum value that is not available in the current SDK version, statistic
will
return Statistic.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
statisticAsString()
.
ExtendedStatistic
.Statistic
public String extendedStatistic()
The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100.
public List<Dimension> dimensions()
The dimensions for the metric associated with the alarm.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
public Integer period()
The period, in seconds, over which the statistic is applied.
public StandardUnit unit()
The unit of the metric associated with the alarm.
If the service returns an enum value that is not available in the current SDK version, unit
will return
StandardUnit.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
unitAsString()
.
StandardUnit
public String unitAsString()
The unit of the metric associated with the alarm.
If the service returns an enum value that is not available in the current SDK version, unit
will return
StandardUnit.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
unitAsString()
.
StandardUnit
public Integer evaluationPeriods()
The number of periods over which data is compared to the specified threshold.
public Integer datapointsToAlarm()
The number of datapoints that must be breaching to trigger the alarm.
public Double threshold()
The value to compare with the specified statistic.
public ComparisonOperator comparisonOperator()
The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first operand.
If the service returns an enum value that is not available in the current SDK version,
comparisonOperator
will return ComparisonOperator.UNKNOWN_TO_SDK_VERSION
. The raw value returned
by the service is available from comparisonOperatorAsString()
.
ComparisonOperator
public String comparisonOperatorAsString()
The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first operand.
If the service returns an enum value that is not available in the current SDK version,
comparisonOperator
will return ComparisonOperator.UNKNOWN_TO_SDK_VERSION
. The raw value returned
by the service is available from comparisonOperatorAsString()
.
ComparisonOperator
public String treatMissingData()
Sets how this alarm is to handle missing data points. If this parameter is omitted, the default behavior of
missing
is used.
missing
is used.public String evaluateLowSampleCountPercentile()
Used only for alarms based on percentiles. If ignore
, the alarm state does not change during periods
with too few data points to be statistically significant. If evaluate
or this parameter is not used,
the alarm is always evaluated and possibly changes state no matter how many data points are available.
ignore
, the alarm state does not change during
periods with too few data points to be statistically significant. If evaluate
or this
parameter is not used, the alarm is always evaluated and possibly changes state no matter how many data
points are available.public List<MetricDataQuery> metrics()
An array of MetricDataQuery structures, used in an alarm based on a metric math expression. Each structure either
retrieves a metric or performs a math expression. One item in the Metrics array is the math expression that the
alarm watches. This expression by designated by having ReturnValue
set to true.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
ReturnValue
set to true.public String thresholdMetricId()
In an alarm based on an anomaly detection model, this is the ID of the ANOMALY_DETECTION_BAND
function used as the threshold for the alarm.
ANOMALY_DETECTION_BAND
function used as the threshold for the alarm.public MetricAlarm.Builder toBuilder()
toBuilder
in interface ToCopyableBuilder<MetricAlarm.Builder,MetricAlarm>
public static MetricAlarm.Builder builder()
public static Class<? extends MetricAlarm.Builder> serializableBuilderClass()
public boolean equalsBySdkFields(Object obj)
equalsBySdkFields
in interface SdkPojo
public String toString()
Copyright © 2019. All rights reserved.