Network.AWS.CloudWatch

Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the applications you run on AWS in real-time. You can use CloudWatch to collect and track metrics, which are the variables you want to measure for your resources and applications.

CloudWatch alarms send notifications or automatically make changes to the resources you are monitoring based on rules that you define. For example, you can monitor the CPU usage and disk reads and writes of your Amazon Elastic Compute Cloud (Amazon EC2) instances and then use this data to determine whether you should launch additional instances to handle increased load. You can also use this data to stop under-used instances to save money.

In addition to monitoring the built-in metrics that come with AWS, you can monitor your own custom metrics. With CloudWatch, you gain system-wide visibility into resource utilization, application performance, and operational health.

Service Configuration

cloudWatch :: Service

API version '2010-08-01' of the Amazon CloudWatch SDK configuration.

Errors

Error matchers are designed for use with the functions provided by Control.Exception.Lens. This allows catching (and rethrowing) service specific errors returned by CloudWatch.

LimitExceededFault

_LimitExceededFault :: AsError a => Getting (First ServiceError) a ServiceError

The quota for alarms for this customer has already been reached.

InvalidNextToken

_InvalidNextToken :: AsError a => Getting (First ServiceError) a ServiceError

The next token specified is invalid.

InternalServiceFault

_InternalServiceFault :: AsError a => Getting (First ServiceError) a ServiceError

Indicates that the request processing has failed due to some unknown error, exception, or failure.

InvalidParameterValueException

_InvalidParameterValueException :: AsError a => Getting (First ServiceError) a ServiceError

Bad or out-of-range value was supplied for the input parameter.

InvalidFormatFault

_InvalidFormatFault :: AsError a => Getting (First ServiceError) a ServiceError

Data was not syntactically valid JSON.

MissingRequiredParameterException

_MissingRequiredParameterException :: AsError a => Getting (First ServiceError) a ServiceError

An input parameter that is mandatory for processing the request is not supplied.

InvalidParameterCombinationException

_InvalidParameterCombinationException :: AsError a => Getting (First ServiceError) a ServiceError

Parameters that must not be used together were used together.

ResourceNotFound

_ResourceNotFound :: AsError a => Getting (First ServiceError) a ServiceError

The named resource does not exist.

Waiters

Waiters poll by repeatedly sending a request until some remote success condition configured by the Wait specification is fulfilled. The Wait specification determines how many attempts should be made, in addition to delay and retry strategies.

Operations

Some AWS operations return results that are incomplete and require subsequent requests in order to obtain the entire result set. The process of sending subsequent requests to continue where a previous request left off is called pagination. For example, the ListObjects operation of Amazon S3 returns up to 1000 objects at a time, and you must send subsequent requests with the appropriate Marker in order to retrieve the next page of results.

Operations that have an AWSPager instance can transparently perform subsequent requests, correctly setting Markers and other request facets to iterate through the entire result set of a truncated API operation. Operations which support this have an additional note in the documentation.

Many operations have the ability to filter results on the server side. See the individual operation parameters for details.

EnableAlarmActions

module Network.AWS.CloudWatch.EnableAlarmActions

PutMetricData

module Network.AWS.CloudWatch.PutMetricData

DescribeAlarms (Paginated)

module Network.AWS.CloudWatch.DescribeAlarms

ListMetrics (Paginated)

module Network.AWS.CloudWatch.ListMetrics

DeleteAlarms

module Network.AWS.CloudWatch.DeleteAlarms

DescribeAlarmHistory (Paginated)

module Network.AWS.CloudWatch.DescribeAlarmHistory

GetMetricStatistics

module Network.AWS.CloudWatch.GetMetricStatistics

DescribeAlarmsForMetric

module Network.AWS.CloudWatch.DescribeAlarmsForMetric

DisableAlarmActions

module Network.AWS.CloudWatch.DisableAlarmActions

PutMetricAlarm

module Network.AWS.CloudWatch.PutMetricAlarm

SetAlarmState

module Network.AWS.CloudWatch.SetAlarmState

Types

ComparisonOperator

data ComparisonOperator

Constructors

GreaterThanOrEqualToThreshold

GreaterThanThreshold

LessThanOrEqualToThreshold

LessThanThreshold

Instances

Bounded ComparisonOperator

Enum ComparisonOperator

Eq ComparisonOperator

Data ComparisonOperator

Ord ComparisonOperator

Read ComparisonOperator

Show ComparisonOperator

Generic ComparisonOperator

Hashable ComparisonOperator

ToHeader ComparisonOperator

FromXML ComparisonOperator

ToQuery ComparisonOperator

ToByteString ComparisonOperator

FromText ComparisonOperator

ToText ComparisonOperator

type Rep ComparisonOperator

HistoryItemType

data HistoryItemType

Constructors

Action

ConfigurationUpdate

StateUpdate

Instances

Bounded HistoryItemType

Enum HistoryItemType

Eq HistoryItemType

Data HistoryItemType

Ord HistoryItemType

Read HistoryItemType

Show HistoryItemType

Generic HistoryItemType

Hashable HistoryItemType

ToHeader HistoryItemType

FromXML HistoryItemType

ToQuery HistoryItemType

ToByteString HistoryItemType

FromText HistoryItemType

ToText HistoryItemType

type Rep HistoryItemType

StandardUnit

data StandardUnit

Constructors

Bits

BitsSecond

Bytes

BytesSecond

Count

CountSecond

Gigabits

GigabitsSecond

Gigabytes

GigabytesSecond

Kilobits

KilobitsSecond

Kilobytes

KilobytesSecond

Megabits

MegabitsSecond

Megabytes

MegabytesSecond

Microseconds

Milliseconds

None

Percent

Seconds

Terabits

TerabitsSecond

Terabytes

TerabytesSecond

Instances

Bounded StandardUnit

Enum StandardUnit

Eq StandardUnit

Data StandardUnit

Ord StandardUnit

Read StandardUnit

Show StandardUnit

Generic StandardUnit

Hashable StandardUnit

ToHeader StandardUnit

FromXML StandardUnit

ToQuery StandardUnit

ToByteString StandardUnit

FromText StandardUnit

ToText StandardUnit

type Rep StandardUnit

StateValue

data StateValue

Constructors

Alarm

InsufficientData

OK

Instances

Bounded StateValue

Enum StateValue

Eq StateValue

Data StateValue

Ord StateValue

Read StateValue

Show StateValue

Generic StateValue

Hashable StateValue

ToHeader StateValue

FromXML StateValue

ToQuery StateValue

ToByteString StateValue

FromText StateValue

ToText StateValue

type Rep StateValue

Statistic

data Statistic

Constructors

Average

Maximum

Minimum

SampleCount

Sum

Instances

Bounded Statistic

Enum Statistic

Eq Statistic

Data Statistic

Ord Statistic

Read Statistic

Show Statistic

Generic Statistic

Hashable Statistic

ToHeader Statistic

FromXML Statistic

ToQuery Statistic

ToByteString Statistic

FromText Statistic

ToText Statistic

type Rep Statistic

AlarmHistoryItem

data AlarmHistoryItem

The AlarmHistoryItem data type contains descriptive information about the history of a specific alarm. If you call DescribeAlarmHistory, Amazon CloudWatch returns this data type as part of the DescribeAlarmHistoryResult data type.

See: alarmHistoryItem smart constructor.

Instances

Eq AlarmHistoryItem

Data AlarmHistoryItem

Read AlarmHistoryItem

Show AlarmHistoryItem

Generic AlarmHistoryItem

Hashable AlarmHistoryItem

FromXML AlarmHistoryItem

type Rep AlarmHistoryItem

alarmHistoryItem :: AlarmHistoryItem

Creates a value of AlarmHistoryItem with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ahiAlarmName
• ahiHistoryItemType
• ahiHistoryData
• ahiHistorySummary
• ahiTimestamp

ahiAlarmName :: Lens' AlarmHistoryItem (Maybe Text)

The descriptive name for the alarm.

ahiHistoryItemType :: Lens' AlarmHistoryItem (Maybe HistoryItemType)

The type of alarm history item.

ahiHistoryData :: Lens' AlarmHistoryItem (Maybe Text)

Machine-readable data about the alarm in JSON format.

ahiHistorySummary :: Lens' AlarmHistoryItem (Maybe Text)

A human-readable summary of the alarm history.

ahiTimestamp :: Lens' AlarmHistoryItem (Maybe UTCTime)

The time stamp for the alarm history item.

Datapoint

data Datapoint

The Datapoint data type encapsulates the statistical data that Amazon CloudWatch computes from metric data.

See: datapoint smart constructor.

Instances

Eq Datapoint

Data Datapoint

Read Datapoint

Show Datapoint

Generic Datapoint

Hashable Datapoint

FromXML Datapoint

type Rep Datapoint

datapoint :: Datapoint

Creates a value of Datapoint with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dSampleCount
• dMaximum
• dAverage
• dMinimum
• dSum
• dUnit
• dTimestamp

dSampleCount :: Lens' Datapoint (Maybe Double)

The number of metric values that contributed to the aggregate value of this datapoint.

dMaximum :: Lens' Datapoint (Maybe Double)

The maximum of the metric value used for the datapoint.

dAverage :: Lens' Datapoint (Maybe Double)

The average of metric values that correspond to the datapoint.

dMinimum :: Lens' Datapoint (Maybe Double)

The minimum metric value used for the datapoint.

dSum :: Lens' Datapoint (Maybe Double)

The sum of metric values used for the datapoint.

dUnit :: Lens' Datapoint (Maybe StandardUnit)

The standard unit used for the datapoint.

dTimestamp :: Lens' Datapoint (Maybe UTCTime)

The time stamp used for the datapoint.

Dimension

data Dimension

The Dimension data type further expands on the identity of a metric using a Name, Value pair.

For examples that use one or more dimensions, see PutMetricData.

See: dimension smart constructor.

Instances

Eq Dimension

Data Dimension

Read Dimension

Show Dimension

Generic Dimension

Hashable Dimension

FromXML Dimension

ToQuery Dimension

type Rep Dimension

dimension

Arguments

:: Text

dName

-> Text

dValue

-> Dimension

Creates a value of Dimension with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dName
• dValue

dName :: Lens' Dimension Text

The name of the dimension.

dValue :: Lens' Dimension Text

The value representing the dimension measurement

DimensionFilter

data DimensionFilter

The DimensionFilter data type is used to filter ListMetrics results.

See: dimensionFilter smart constructor.

Instances

Eq DimensionFilter

Data DimensionFilter

Read DimensionFilter

Show DimensionFilter

Generic DimensionFilter

Hashable DimensionFilter

ToQuery DimensionFilter

type Rep DimensionFilter

dimensionFilter

Arguments

:: Text

dfName

-> DimensionFilter

Creates a value of DimensionFilter with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dfValue
• dfName

dfValue :: Lens' DimensionFilter (Maybe Text)

The value of the dimension to be matched.

Specifying a Name without specifying a Value returns all values associated with that Name.

dfName :: Lens' DimensionFilter Text

The dimension name to be matched.

Metric

data Metric

The Metric data type contains information about a specific metric. If you call ListMetrics, Amazon CloudWatch returns information contained by this data type.

The example in the Examples section publishes two metrics named buffers and latency. Both metrics are in the examples namespace. Both metrics have two dimensions, InstanceID and InstanceType.

See: metric smart constructor.

Instances

Eq Metric

Data Metric

Read Metric

Show Metric

Generic Metric

Hashable Metric

FromXML Metric

type Rep Metric

metric :: Metric

Creates a value of Metric with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• mMetricName
• mNamespace
• mDimensions

mMetricName :: Lens' Metric (Maybe Text)

The name of the metric.

mNamespace :: Lens' Metric (Maybe Text)

The namespace of the metric.

mDimensions :: Lens' Metric [Dimension]

A list of dimensions associated with the metric.

MetricAlarm

data MetricAlarm

The MetricAlarm data type represents an alarm. You can use PutMetricAlarm to create or update an alarm.

See: metricAlarm smart constructor.

Instances

Eq MetricAlarm

Data MetricAlarm

Read MetricAlarm

Show MetricAlarm

Generic MetricAlarm

Hashable MetricAlarm

FromXML MetricAlarm

type Rep MetricAlarm

metricAlarm :: MetricAlarm

Creates a value of MetricAlarm with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• maAlarmName
• maStateUpdatedTimestamp
• maPeriod
• maAlarmDescription
• maEvaluationPeriods
• maMetricName
• maNamespace
• maComparisonOperator
• maOKActions
• maStateValue
• maThreshold
• maAlarmConfigurationUpdatedTimestamp
• maActionsEnabled
• maInsufficientDataActions
• maStateReason
• maStateReasonData
• maDimensions
• maAlarmARN
• maAlarmActions
• maUnit
• maStatistic

maAlarmName :: Lens' MetricAlarm (Maybe Text)

The name of the alarm.

maStateUpdatedTimestamp :: Lens' MetricAlarm (Maybe UTCTime)

The time stamp of the last update to the alarm's state.

maPeriod :: Lens' MetricAlarm (Maybe Natural)

The period in seconds over which the statistic is applied.

maAlarmDescription :: Lens' MetricAlarm (Maybe Text)

The description for the alarm.

maEvaluationPeriods :: Lens' MetricAlarm (Maybe Natural)

The number of periods over which data is compared to the specified threshold.

maMetricName :: Lens' MetricAlarm (Maybe Text)

The name of the alarm's metric.

maNamespace :: Lens' MetricAlarm (Maybe Text)

The namespace of alarm's associated metric.

maComparisonOperator :: Lens' MetricAlarm (Maybe ComparisonOperator)

The arithmetic operation to use when comparing the specified Statistic and Threshold. The specified Statistic value is used as the first operand.

maOKActions :: Lens' MetricAlarm [Text]

The list of actions to execute when this alarm transitions into an OK state from any other state. Each action is specified as an Amazon Resource Name (ARN).

maStateValue :: Lens' MetricAlarm (Maybe StateValue)

The state value for the alarm.

maThreshold :: Lens' MetricAlarm (Maybe Double)

The value against which the specified statistic is compared.

maAlarmConfigurationUpdatedTimestamp :: Lens' MetricAlarm (Maybe UTCTime)

The time stamp of the last update to the alarm configuration.

maActionsEnabled :: Lens' MetricAlarm (Maybe Bool)

Indicates whether actions should be executed during any changes to the alarm's state.

maInsufficientDataActions :: Lens' MetricAlarm [Text]

The list of actions to execute when this alarm transitions into an INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Name (ARN).

The current WSDL lists this attribute as UnknownActions.

maStateReason :: Lens' MetricAlarm (Maybe Text)

A human-readable explanation for the alarm's state.

maStateReasonData :: Lens' MetricAlarm (Maybe Text)

An explanation for the alarm's state in machine-readable JSON format

maDimensions :: Lens' MetricAlarm [Dimension]

The list of dimensions associated with the alarm's associated metric.

maAlarmARN :: Lens' MetricAlarm (Maybe Text)

The Amazon Resource Name (ARN) of the alarm.

maAlarmActions :: Lens' MetricAlarm [Text]

The list of actions to execute when this alarm transitions into an ALARM state from any other state. Each action is specified as an Amazon Resource Name (ARN).

maUnit :: Lens' MetricAlarm (Maybe StandardUnit)

The unit of the alarm's associated metric.

maStatistic :: Lens' MetricAlarm (Maybe Statistic)

The statistic to apply to the alarm's associated metric.

MetricDatum

data MetricDatum

The MetricDatum data type encapsulates the information sent with PutMetricData to either create a new metric or add new values to be aggregated into an existing metric.

See: metricDatum smart constructor.

Instances

Eq MetricDatum

Data MetricDatum

Read MetricDatum

Show MetricDatum

Generic MetricDatum

Hashable MetricDatum

ToQuery MetricDatum

type Rep MetricDatum

metricDatum

Arguments

:: Text

mdMetricName

-> MetricDatum

Creates a value of MetricDatum with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• mdValue
• mdDimensions
• mdUnit
• mdTimestamp
• mdStatisticValues
• mdMetricName

mdValue :: Lens' MetricDatum (Maybe Double)

The value for the metric.

Although the Value parameter accepts numbers of type Double, Amazon CloudWatch rejects values that are either too small or too large. Values must be in the range of 8.515920e-109 to 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2). In addition, special values (e.g., NaN, +Infinity, -Infinity) are not supported.

mdDimensions :: Lens' MetricDatum [Dimension]

A list of dimensions associated with the metric. Note, when using the Dimensions value in a query, you need to append .member.N to it (e.g., Dimensions.member.N).

mdUnit :: Lens' MetricDatum (Maybe StandardUnit)

The unit of the metric.

mdTimestamp :: Lens' MetricDatum (Maybe UTCTime)

The time stamp used for the metric in ISO 8601 Universal Coordinated Time (UTC) format. If not specified, the default value is set to the time the metric data was received.

mdStatisticValues :: Lens' MetricDatum (Maybe StatisticSet)

A set of statistical values describing the metric.

mdMetricName :: Lens' MetricDatum Text

The name of the metric.

StatisticSet

data StatisticSet

The StatisticSet data type describes the StatisticValues component of MetricDatum, and represents a set of statistics that describes a specific metric.

See: statisticSet smart constructor.

Instances

Eq StatisticSet

Data StatisticSet

Read StatisticSet

Show StatisticSet

Generic StatisticSet

Hashable StatisticSet

ToQuery StatisticSet

type Rep StatisticSet

statisticSet

Arguments

:: Double

ssSampleCount

-> Double

ssSum

-> Double

ssMinimum

-> Double

ssMaximum

-> StatisticSet

Creates a value of StatisticSet with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ssSampleCount
• ssSum
• ssMinimum
• ssMaximum

ssSampleCount :: Lens' StatisticSet Double

The number of samples used for the statistic set.

ssSum :: Lens' StatisticSet Double

The sum of values for the sample set.

ssMinimum :: Lens' StatisticSet Double

The minimum value of the sample set.

ssMaximum :: Lens' StatisticSet Double

The maximum value of the sample set.