Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
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.
- cloudWatch :: Service
- _LimitExceededFault :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidNextToken :: AsError a => Getting (First ServiceError) a ServiceError
- _InternalServiceFault :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidParameterValueException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidFormatFault :: AsError a => Getting (First ServiceError) a ServiceError
- _MissingRequiredParameterException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidParameterCombinationException :: AsError a => Getting (First ServiceError) a ServiceError
- _ResourceNotFound :: AsError a => Getting (First ServiceError) a ServiceError
- module Network.AWS.CloudWatch.EnableAlarmActions
- module Network.AWS.CloudWatch.PutMetricData
- module Network.AWS.CloudWatch.DescribeAlarms
- module Network.AWS.CloudWatch.ListMetrics
- module Network.AWS.CloudWatch.DeleteAlarms
- module Network.AWS.CloudWatch.DescribeAlarmHistory
- module Network.AWS.CloudWatch.GetMetricStatistics
- module Network.AWS.CloudWatch.DescribeAlarmsForMetric
- module Network.AWS.CloudWatch.DisableAlarmActions
- module Network.AWS.CloudWatch.PutMetricAlarm
- module Network.AWS.CloudWatch.SetAlarmState
- data ComparisonOperator
- data HistoryItemType
- data StandardUnit
- = 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
- data StateValue
- = Alarm
- | InsufficientData
- | OK
- data Statistic
- = Average
- | Maximum
- | Minimum
- | SampleCount
- | Sum
- data AlarmHistoryItem
- alarmHistoryItem :: AlarmHistoryItem
- ahiAlarmName :: Lens' AlarmHistoryItem (Maybe Text)
- ahiHistoryItemType :: Lens' AlarmHistoryItem (Maybe HistoryItemType)
- ahiHistoryData :: Lens' AlarmHistoryItem (Maybe Text)
- ahiHistorySummary :: Lens' AlarmHistoryItem (Maybe Text)
- ahiTimestamp :: Lens' AlarmHistoryItem (Maybe UTCTime)
- data Datapoint
- datapoint :: Datapoint
- dSampleCount :: Lens' Datapoint (Maybe Double)
- dMaximum :: Lens' Datapoint (Maybe Double)
- dAverage :: Lens' Datapoint (Maybe Double)
- dMinimum :: Lens' Datapoint (Maybe Double)
- dSum :: Lens' Datapoint (Maybe Double)
- dUnit :: Lens' Datapoint (Maybe StandardUnit)
- dTimestamp :: Lens' Datapoint (Maybe UTCTime)
- data Dimension
- dimension :: Text -> Text -> Dimension
- dName :: Lens' Dimension Text
- dValue :: Lens' Dimension Text
- data DimensionFilter
- dimensionFilter :: Text -> DimensionFilter
- dfValue :: Lens' DimensionFilter (Maybe Text)
- dfName :: Lens' DimensionFilter Text
- data Metric
- metric :: Metric
- mMetricName :: Lens' Metric (Maybe Text)
- mNamespace :: Lens' Metric (Maybe Text)
- mDimensions :: Lens' Metric [Dimension]
- data MetricAlarm
- metricAlarm :: MetricAlarm
- maAlarmName :: Lens' MetricAlarm (Maybe Text)
- maStateUpdatedTimestamp :: Lens' MetricAlarm (Maybe UTCTime)
- maPeriod :: Lens' MetricAlarm (Maybe Natural)
- maAlarmDescription :: Lens' MetricAlarm (Maybe Text)
- maEvaluationPeriods :: Lens' MetricAlarm (Maybe Natural)
- maMetricName :: Lens' MetricAlarm (Maybe Text)
- maNamespace :: Lens' MetricAlarm (Maybe Text)
- maComparisonOperator :: Lens' MetricAlarm (Maybe ComparisonOperator)
- maOKActions :: Lens' MetricAlarm [Text]
- maStateValue :: Lens' MetricAlarm (Maybe StateValue)
- maThreshold :: Lens' MetricAlarm (Maybe Double)
- maAlarmConfigurationUpdatedTimestamp :: Lens' MetricAlarm (Maybe UTCTime)
- maActionsEnabled :: Lens' MetricAlarm (Maybe Bool)
- maInsufficientDataActions :: Lens' MetricAlarm [Text]
- maStateReason :: Lens' MetricAlarm (Maybe Text)
- maStateReasonData :: Lens' MetricAlarm (Maybe Text)
- maDimensions :: Lens' MetricAlarm [Dimension]
- maAlarmARN :: Lens' MetricAlarm (Maybe Text)
- maAlarmActions :: Lens' MetricAlarm [Text]
- maUnit :: Lens' MetricAlarm (Maybe StandardUnit)
- maStatistic :: Lens' MetricAlarm (Maybe Statistic)
- data MetricDatum
- metricDatum :: Text -> MetricDatum
- mdValue :: Lens' MetricDatum (Maybe Double)
- mdDimensions :: Lens' MetricDatum [Dimension]
- mdUnit :: Lens' MetricDatum (Maybe StandardUnit)
- mdTimestamp :: Lens' MetricDatum (Maybe UTCTime)
- mdStatisticValues :: Lens' MetricDatum (Maybe StatisticSet)
- mdMetricName :: Lens' MetricDatum Text
- data StatisticSet
- statisticSet :: Double -> Double -> Double -> Double -> StatisticSet
- ssSampleCount :: Lens' StatisticSet Double
- ssSum :: Lens' StatisticSet Double
- ssMinimum :: Lens' StatisticSet Double
- ssMaximum :: Lens' StatisticSet Double
Service Configuration
cloudWatch :: Service Source #
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 Source #
The quota for alarms for this customer has already been reached.
InvalidNextToken
_InvalidNextToken :: AsError a => Getting (First ServiceError) a ServiceError Source #
The next token specified is invalid.
InternalServiceFault
_InternalServiceFault :: AsError a => Getting (First ServiceError) a ServiceError Source #
Indicates that the request processing has failed due to some unknown error, exception, or failure.
InvalidParameterValueException
_InvalidParameterValueException :: AsError a => Getting (First ServiceError) a ServiceError Source #
Bad or out-of-range value was supplied for the input parameter.
InvalidFormatFault
_InvalidFormatFault :: AsError a => Getting (First ServiceError) a ServiceError Source #
Data was not syntactically valid JSON.
MissingRequiredParameterException
_MissingRequiredParameterException :: AsError a => Getting (First ServiceError) a ServiceError Source #
An input parameter that is mandatory for processing the request is not supplied.
InvalidParameterCombinationException
_InvalidParameterCombinationException :: AsError a => Getting (First ServiceError) a ServiceError Source #
Parameters that must not be used together were used together.
ResourceNotFound
_ResourceNotFound :: AsError a => Getting (First ServiceError) a ServiceError Source #
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
PutMetricData
DescribeAlarms (Paginated)
ListMetrics (Paginated)
DeleteAlarms
DescribeAlarmHistory (Paginated)
GetMetricStatistics
DescribeAlarmsForMetric
DisableAlarmActions
PutMetricAlarm
SetAlarmState
Types
ComparisonOperator
data ComparisonOperator Source #
HistoryItemType
data HistoryItemType Source #
StandardUnit
data StandardUnit Source #
StateValue
data StateValue Source #
Statistic
AlarmHistoryItem
data AlarmHistoryItem Source #
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.
alarmHistoryItem :: AlarmHistoryItem Source #
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 :: Lens' AlarmHistoryItem (Maybe Text) Source #
The descriptive name for the alarm.
ahiHistoryItemType :: Lens' AlarmHistoryItem (Maybe HistoryItemType) Source #
The type of alarm history item.
ahiHistoryData :: Lens' AlarmHistoryItem (Maybe Text) Source #
Machine-readable data about the alarm in JSON format.
ahiHistorySummary :: Lens' AlarmHistoryItem (Maybe Text) Source #
A human-readable summary of the alarm history.
ahiTimestamp :: Lens' AlarmHistoryItem (Maybe UTCTime) Source #
The time stamp for the alarm history item.
Datapoint
datapoint :: Datapoint Source #
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 :: Lens' Datapoint (Maybe Double) Source #
The number of metric values that contributed to the aggregate value of this datapoint.
dMaximum :: Lens' Datapoint (Maybe Double) Source #
The maximum of the metric value used for the datapoint.
dAverage :: Lens' Datapoint (Maybe Double) Source #
The average of metric values that correspond to the datapoint.
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.
DimensionFilter
data DimensionFilter Source #
The DimensionFilter
data type is used to filter ListMetrics
results.
See: dimensionFilter
smart constructor.
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 :: Lens' DimensionFilter (Maybe Text) Source #
The value of the dimension to be matched.
Specifying a Name
without specifying a Value
returns all values
associated with that Name
.
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.
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:
MetricAlarm
data MetricAlarm Source #
The MetricAlarm data type represents an alarm. You can use PutMetricAlarm to create or update an alarm.
See: metricAlarm
smart constructor.
metricAlarm :: MetricAlarm Source #
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) Source #
The name of the alarm.
maStateUpdatedTimestamp :: Lens' MetricAlarm (Maybe UTCTime) Source #
The time stamp of the last update to the alarm's state.
maPeriod :: Lens' MetricAlarm (Maybe Natural) Source #
The period in seconds over which the statistic is applied.
maAlarmDescription :: Lens' MetricAlarm (Maybe Text) Source #
The description for the alarm.
maEvaluationPeriods :: Lens' MetricAlarm (Maybe Natural) Source #
The number of periods over which data is compared to the specified threshold.
maMetricName :: Lens' MetricAlarm (Maybe Text) Source #
The name of the alarm's metric.
maNamespace :: Lens' MetricAlarm (Maybe Text) Source #
The namespace of alarm's associated metric.
maOKActions :: Lens' MetricAlarm [Text] Source #
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) Source #
The state value for the alarm.
maThreshold :: Lens' MetricAlarm (Maybe Double) Source #
The value against which the specified statistic is compared.
maAlarmConfigurationUpdatedTimestamp :: Lens' MetricAlarm (Maybe UTCTime) Source #
The time stamp of the last update to the alarm configuration.
maActionsEnabled :: Lens' MetricAlarm (Maybe Bool) Source #
Indicates whether actions should be executed during any changes to the alarm's state.
maInsufficientDataActions :: Lens' MetricAlarm [Text] Source #
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) Source #
A human-readable explanation for the alarm's state.
maStateReasonData :: Lens' MetricAlarm (Maybe Text) Source #
An explanation for the alarm's state in machine-readable JSON format
maDimensions :: Lens' MetricAlarm [Dimension] Source #
The list of dimensions associated with the alarm's associated metric.
maAlarmARN :: Lens' MetricAlarm (Maybe Text) Source #
The Amazon Resource Name (ARN) of the alarm.
maAlarmActions :: Lens' MetricAlarm [Text] Source #
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) Source #
The unit of the alarm's associated metric.
maStatistic :: Lens' MetricAlarm (Maybe Statistic) Source #
The statistic to apply to the alarm's associated metric.
MetricDatum
data MetricDatum Source #
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.
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 :: Lens' MetricDatum (Maybe Double) Source #
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] Source #
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) Source #
The unit of the metric.
mdTimestamp :: Lens' MetricDatum (Maybe UTCTime) Source #
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) Source #
A set of statistical values describing the metric.
mdMetricName :: Lens' MetricDatum Text Source #
The name of the metric.
StatisticSet
data StatisticSet Source #
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.
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 :: Lens' StatisticSet Double Source #
The number of samples used for the statistic set.