Copyright | (c) 2013-2017 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
- Service Configuration
- Errors
- Waiters
- Operations
- DescribeDestinations (Paginated)
- UntagLogGroup
- CreateExportTask
- PutDestination
- DescribeSubscriptionFilters (Paginated)
- GetLogEvents
- DescribeLogGroups (Paginated)
- DeleteDestination
- DisassociateKMSKey
- FilterLogEvents (Paginated)
- TagLogGroup
- DescribeResourcePolicies
- DeleteLogStream
- CreateLogStream
- CreateLogGroup
- DescribeExportTasks
- CancelExportTask
- PutSubscriptionFilter
- DeleteLogGroup
- DeleteSubscriptionFilter
- PutLogEvents
- DescribeMetricFilters (Paginated)
- TestMetricFilter
- PutDestinationPolicy
- PutMetricFilter
- DeleteRetentionPolicy
- DeleteMetricFilter
- PutRetentionPolicy
- ListTagsLogGroup
- PutResourcePolicy
- DeleteResourcePolicy
- AssociateKMSKey
- DescribeLogStreams (Paginated)
- Types
You can use Amazon CloudWatch Logs to monitor, store, and access your log files from Amazon EC2 instances, AWS CloudTrail, or other sources. You can then retrieve the associated log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the AWS CLI, CloudWatch Logs API, or CloudWatch Logs SDK.
You can use CloudWatch Logs to:
- Monitor logs from EC2 instances in real-time : You can use CloudWatch Logs to monitor applications and systems using log data. For example, CloudWatch Logs can track the number of errors that occur in your application logs and send you a notification whenever the rate of errors exceeds a threshold that you specify. CloudWatch Logs uses your log data for monitoring; so, no code changes are required. For example, you can monitor application logs for specific literal terms (such as NullReferenceException) or count the number of occurrences of a literal term at a particular position in log data (such as "404" status codes in an Apache access log). When the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch metric that you specify.
- Monitor AWS CloudTrail logged events : You can create alarms in CloudWatch and receive notifications of particular API activity as captured by CloudTrail and use the notification to perform troubleshooting.
- Archive log data : You can use CloudWatch Logs to store your log data in highly durable storage. You can change the log retention setting so that any log events older than this setting are automatically deleted. The CloudWatch Logs agent makes it easy to quickly send both rotated and non-rotated log data off of a host and into the log service. You can then access the raw log data when you need it.
- cloudWatchLogs :: Service
- _InvalidParameterException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidSequenceTokenException :: AsError a => Getting (First ServiceError) a ServiceError
- _ResourceAlreadyExistsException :: AsError a => Getting (First ServiceError) a ServiceError
- _OperationAbortedException :: AsError a => Getting (First ServiceError) a ServiceError
- _ServiceUnavailableException :: AsError a => Getting (First ServiceError) a ServiceError
- _DataAlreadyAcceptedException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidOperationException :: AsError a => Getting (First ServiceError) a ServiceError
- _ResourceNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError
- _LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError
- module Network.AWS.CloudWatchLogs.DescribeDestinations
- module Network.AWS.CloudWatchLogs.UntagLogGroup
- module Network.AWS.CloudWatchLogs.CreateExportTask
- module Network.AWS.CloudWatchLogs.PutDestination
- module Network.AWS.CloudWatchLogs.DescribeSubscriptionFilters
- module Network.AWS.CloudWatchLogs.GetLogEvents
- module Network.AWS.CloudWatchLogs.DescribeLogGroups
- module Network.AWS.CloudWatchLogs.DeleteDestination
- module Network.AWS.CloudWatchLogs.DisassociateKMSKey
- module Network.AWS.CloudWatchLogs.FilterLogEvents
- module Network.AWS.CloudWatchLogs.TagLogGroup
- module Network.AWS.CloudWatchLogs.DescribeResourcePolicies
- module Network.AWS.CloudWatchLogs.DeleteLogStream
- module Network.AWS.CloudWatchLogs.CreateLogStream
- module Network.AWS.CloudWatchLogs.CreateLogGroup
- module Network.AWS.CloudWatchLogs.DescribeExportTasks
- module Network.AWS.CloudWatchLogs.CancelExportTask
- module Network.AWS.CloudWatchLogs.PutSubscriptionFilter
- module Network.AWS.CloudWatchLogs.DeleteLogGroup
- module Network.AWS.CloudWatchLogs.DeleteSubscriptionFilter
- module Network.AWS.CloudWatchLogs.PutLogEvents
- module Network.AWS.CloudWatchLogs.DescribeMetricFilters
- module Network.AWS.CloudWatchLogs.TestMetricFilter
- module Network.AWS.CloudWatchLogs.PutDestinationPolicy
- module Network.AWS.CloudWatchLogs.PutMetricFilter
- module Network.AWS.CloudWatchLogs.DeleteRetentionPolicy
- module Network.AWS.CloudWatchLogs.DeleteMetricFilter
- module Network.AWS.CloudWatchLogs.PutRetentionPolicy
- module Network.AWS.CloudWatchLogs.ListTagsLogGroup
- module Network.AWS.CloudWatchLogs.PutResourcePolicy
- module Network.AWS.CloudWatchLogs.DeleteResourcePolicy
- module Network.AWS.CloudWatchLogs.AssociateKMSKey
- module Network.AWS.CloudWatchLogs.DescribeLogStreams
- data Distribution
- data ExportTaskStatusCode
- data OrderBy
- data Destination
- destination :: Destination
- dTargetARN :: Lens' Destination (Maybe Text)
- dCreationTime :: Lens' Destination (Maybe Natural)
- dArn :: Lens' Destination (Maybe Text)
- dAccessPolicy :: Lens' Destination (Maybe Text)
- dDestinationName :: Lens' Destination (Maybe Text)
- dRoleARN :: Lens' Destination (Maybe Text)
- data ExportTask
- exportTask :: ExportTask
- etDestinationPrefix :: Lens' ExportTask (Maybe Text)
- etDestination :: Lens' ExportTask (Maybe Text)
- etStatus :: Lens' ExportTask (Maybe ExportTaskStatus)
- etTaskName :: Lens' ExportTask (Maybe Text)
- etTaskId :: Lens' ExportTask (Maybe Text)
- etTo :: Lens' ExportTask (Maybe Natural)
- etFrom :: Lens' ExportTask (Maybe Natural)
- etLogGroupName :: Lens' ExportTask (Maybe Text)
- etExecutionInfo :: Lens' ExportTask (Maybe ExportTaskExecutionInfo)
- data ExportTaskExecutionInfo
- exportTaskExecutionInfo :: ExportTaskExecutionInfo
- eteiCreationTime :: Lens' ExportTaskExecutionInfo (Maybe Natural)
- eteiCompletionTime :: Lens' ExportTaskExecutionInfo (Maybe Natural)
- data ExportTaskStatus
- exportTaskStatus :: ExportTaskStatus
- etsCode :: Lens' ExportTaskStatus (Maybe ExportTaskStatusCode)
- etsMessage :: Lens' ExportTaskStatus (Maybe Text)
- data FilteredLogEvent
- filteredLogEvent :: FilteredLogEvent
- fleIngestionTime :: Lens' FilteredLogEvent (Maybe Natural)
- fleLogStreamName :: Lens' FilteredLogEvent (Maybe Text)
- fleMessage :: Lens' FilteredLogEvent (Maybe Text)
- fleTimestamp :: Lens' FilteredLogEvent (Maybe Natural)
- fleEventId :: Lens' FilteredLogEvent (Maybe Text)
- data InputLogEvent
- inputLogEvent :: Natural -> Text -> InputLogEvent
- ileTimestamp :: Lens' InputLogEvent Natural
- ileMessage :: Lens' InputLogEvent Text
- data LogGroup
- logGroup :: LogGroup
- lgCreationTime :: Lens' LogGroup (Maybe Natural)
- lgMetricFilterCount :: Lens' LogGroup (Maybe Int)
- lgArn :: Lens' LogGroup (Maybe Text)
- lgLogGroupName :: Lens' LogGroup (Maybe Text)
- lgRetentionInDays :: Lens' LogGroup (Maybe Int)
- lgKmsKeyId :: Lens' LogGroup (Maybe Text)
- lgStoredBytes :: Lens' LogGroup (Maybe Natural)
- data LogStream
- logStream :: LogStream
- lsCreationTime :: Lens' LogStream (Maybe Natural)
- lsUploadSequenceToken :: Lens' LogStream (Maybe Text)
- lsArn :: Lens' LogStream (Maybe Text)
- lsFirstEventTimestamp :: Lens' LogStream (Maybe Natural)
- lsLogStreamName :: Lens' LogStream (Maybe Text)
- lsStoredBytes :: Lens' LogStream (Maybe Natural)
- lsLastIngestionTime :: Lens' LogStream (Maybe Natural)
- lsLastEventTimestamp :: Lens' LogStream (Maybe Natural)
- data MetricFilter
- metricFilter :: MetricFilter
- mfCreationTime :: Lens' MetricFilter (Maybe Natural)
- mfFilterName :: Lens' MetricFilter (Maybe Text)
- mfLogGroupName :: Lens' MetricFilter (Maybe Text)
- mfFilterPattern :: Lens' MetricFilter (Maybe Text)
- mfMetricTransformations :: Lens' MetricFilter (Maybe (NonEmpty MetricTransformation))
- data MetricFilterMatchRecord
- metricFilterMatchRecord :: MetricFilterMatchRecord
- mfmrExtractedValues :: Lens' MetricFilterMatchRecord (HashMap Text Text)
- mfmrEventNumber :: Lens' MetricFilterMatchRecord (Maybe Integer)
- mfmrEventMessage :: Lens' MetricFilterMatchRecord (Maybe Text)
- data MetricTransformation
- metricTransformation :: Text -> Text -> Text -> MetricTransformation
- mtDefaultValue :: Lens' MetricTransformation (Maybe Double)
- mtMetricName :: Lens' MetricTransformation Text
- mtMetricNamespace :: Lens' MetricTransformation Text
- mtMetricValue :: Lens' MetricTransformation Text
- data OutputLogEvent
- outputLogEvent :: OutputLogEvent
- oleIngestionTime :: Lens' OutputLogEvent (Maybe Natural)
- oleMessage :: Lens' OutputLogEvent (Maybe Text)
- oleTimestamp :: Lens' OutputLogEvent (Maybe Natural)
- data RejectedLogEventsInfo
- rejectedLogEventsInfo :: RejectedLogEventsInfo
- rleiTooOldLogEventEndIndex :: Lens' RejectedLogEventsInfo (Maybe Int)
- rleiTooNewLogEventStartIndex :: Lens' RejectedLogEventsInfo (Maybe Int)
- rleiExpiredLogEventEndIndex :: Lens' RejectedLogEventsInfo (Maybe Int)
- data ResourcePolicy
- resourcePolicy :: ResourcePolicy
- rpPolicyName :: Lens' ResourcePolicy (Maybe Text)
- rpPolicyDocument :: Lens' ResourcePolicy (Maybe Text)
- rpLastUpdatedTime :: Lens' ResourcePolicy (Maybe Natural)
- data SearchedLogStream
- searchedLogStream :: SearchedLogStream
- slsLogStreamName :: Lens' SearchedLogStream (Maybe Text)
- slsSearchedCompletely :: Lens' SearchedLogStream (Maybe Bool)
- data SubscriptionFilter
- subscriptionFilter :: SubscriptionFilter
- sfCreationTime :: Lens' SubscriptionFilter (Maybe Natural)
- sfFilterName :: Lens' SubscriptionFilter (Maybe Text)
- sfDistribution :: Lens' SubscriptionFilter (Maybe Distribution)
- sfDestinationARN :: Lens' SubscriptionFilter (Maybe Text)
- sfLogGroupName :: Lens' SubscriptionFilter (Maybe Text)
- sfFilterPattern :: Lens' SubscriptionFilter (Maybe Text)
- sfRoleARN :: Lens' SubscriptionFilter (Maybe Text)
Service Configuration
cloudWatchLogs :: Service Source #
API version 2014-03-28
of the Amazon CloudWatch Logs 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 CloudWatchLogs
.
InvalidParameterException
_InvalidParameterException :: AsError a => Getting (First ServiceError) a ServiceError Source #
A parameter is specified incorrectly.
InvalidSequenceTokenException
_InvalidSequenceTokenException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The sequence token is not valid.
ResourceAlreadyExistsException
_ResourceAlreadyExistsException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The specified resource already exists.
OperationAbortedException
_OperationAbortedException :: AsError a => Getting (First ServiceError) a ServiceError Source #
Multiple requests to update the same resource were in conflict.
ServiceUnavailableException
_ServiceUnavailableException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The service cannot complete the request.
DataAlreadyAcceptedException
_DataAlreadyAcceptedException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The event was already logged.
InvalidOperationException
_InvalidOperationException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The operation is not valid on the specified resource.
ResourceNotFoundException
_ResourceNotFoundException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The specified resource does not exist.
LimitExceededException
_LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError Source #
You have reached the maximum number of resources that can be created.
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.
DescribeDestinations (Paginated)
UntagLogGroup
CreateExportTask
PutDestination
DescribeSubscriptionFilters (Paginated)
GetLogEvents
DescribeLogGroups (Paginated)
DeleteDestination
DisassociateKMSKey
FilterLogEvents (Paginated)
TagLogGroup
DescribeResourcePolicies
DeleteLogStream
CreateLogStream
CreateLogGroup
DescribeExportTasks
CancelExportTask
PutSubscriptionFilter
DeleteLogGroup
DeleteSubscriptionFilter
PutLogEvents
DescribeMetricFilters (Paginated)
TestMetricFilter
PutDestinationPolicy
PutMetricFilter
DeleteRetentionPolicy
DeleteMetricFilter
PutRetentionPolicy
ListTagsLogGroup
PutResourcePolicy
DeleteResourcePolicy
AssociateKMSKey
DescribeLogStreams (Paginated)
Types
Distribution
data Distribution Source #
The method used to distribute log data to the destination, which can be either random or grouped by log stream.
ExportTaskStatusCode
data ExportTaskStatusCode Source #
OrderBy
Destination
data Destination Source #
Represents a cross-account destination that receives subscription log events.
See: destination
smart constructor.
destination :: Destination Source #
Creates a value of Destination
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
dTargetARN
- The Amazon Resource Name (ARN) of the physical target to where the log events are delivered (for example, a Kinesis stream).dCreationTime
- The creation time of the destination, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.dArn
- The ARN of this destination.dAccessPolicy
- An IAM policy document that governs which AWS accounts can create subscription filters against this destination.dDestinationName
- The name of the destination.dRoleARN
- A role for impersonation, used when delivering log events to the target.
dTargetARN :: Lens' Destination (Maybe Text) Source #
The Amazon Resource Name (ARN) of the physical target to where the log events are delivered (for example, a Kinesis stream).
dCreationTime :: Lens' Destination (Maybe Natural) Source #
The creation time of the destination, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
dAccessPolicy :: Lens' Destination (Maybe Text) Source #
An IAM policy document that governs which AWS accounts can create subscription filters against this destination.
dDestinationName :: Lens' Destination (Maybe Text) Source #
The name of the destination.
dRoleARN :: Lens' Destination (Maybe Text) Source #
A role for impersonation, used when delivering log events to the target.
ExportTask
data ExportTask Source #
Represents an export task.
See: exportTask
smart constructor.
exportTask :: ExportTask Source #
Creates a value of ExportTask
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
etDestinationPrefix
- The prefix that was used as the start of Amazon S3 key for every object exported.etDestination
- The name of Amazon S3 bucket to which the log data was exported.etStatus
- The status of the export task.etTaskName
- The name of the export task.etTaskId
- The ID of the export task.etTo
- The end time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp later than this time are not exported.etFrom
- The start time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp before this time are not exported.etLogGroupName
- The name of the log group from which logs data was exported.etExecutionInfo
- Execution info about the export task.
etDestinationPrefix :: Lens' ExportTask (Maybe Text) Source #
The prefix that was used as the start of Amazon S3 key for every object exported.
etDestination :: Lens' ExportTask (Maybe Text) Source #
The name of Amazon S3 bucket to which the log data was exported.
etStatus :: Lens' ExportTask (Maybe ExportTaskStatus) Source #
The status of the export task.
etTaskName :: Lens' ExportTask (Maybe Text) Source #
The name of the export task.
etTo :: Lens' ExportTask (Maybe Natural) Source #
The end time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp later than this time are not exported.
etFrom :: Lens' ExportTask (Maybe Natural) Source #
The start time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. Events with a time stamp before this time are not exported.
etLogGroupName :: Lens' ExportTask (Maybe Text) Source #
The name of the log group from which logs data was exported.
etExecutionInfo :: Lens' ExportTask (Maybe ExportTaskExecutionInfo) Source #
Execution info about the export task.
ExportTaskExecutionInfo
data ExportTaskExecutionInfo Source #
Represents the status of an export task.
See: exportTaskExecutionInfo
smart constructor.
exportTaskExecutionInfo :: ExportTaskExecutionInfo Source #
Creates a value of ExportTaskExecutionInfo
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
eteiCreationTime
- The creation time of the export task, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.eteiCompletionTime
- The completion time of the export task, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
eteiCreationTime :: Lens' ExportTaskExecutionInfo (Maybe Natural) Source #
The creation time of the export task, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
eteiCompletionTime :: Lens' ExportTaskExecutionInfo (Maybe Natural) Source #
The completion time of the export task, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
ExportTaskStatus
data ExportTaskStatus Source #
Represents the status of an export task.
See: exportTaskStatus
smart constructor.
exportTaskStatus :: ExportTaskStatus Source #
Creates a value of ExportTaskStatus
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
etsCode
- The status code of the export task.etsMessage
- The status message related to the status code.
etsCode :: Lens' ExportTaskStatus (Maybe ExportTaskStatusCode) Source #
The status code of the export task.
etsMessage :: Lens' ExportTaskStatus (Maybe Text) Source #
The status message related to the status code.
FilteredLogEvent
data FilteredLogEvent Source #
Represents a matched event.
See: filteredLogEvent
smart constructor.
filteredLogEvent :: FilteredLogEvent Source #
Creates a value of FilteredLogEvent
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
fleIngestionTime
- The time the event was ingested, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.fleLogStreamName
- The name of the log stream this event belongs to.fleMessage
- The data contained in the log event.fleTimestamp
- The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.fleEventId
- The ID of the event.
fleIngestionTime :: Lens' FilteredLogEvent (Maybe Natural) Source #
The time the event was ingested, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
fleLogStreamName :: Lens' FilteredLogEvent (Maybe Text) Source #
The name of the log stream this event belongs to.
fleMessage :: Lens' FilteredLogEvent (Maybe Text) Source #
The data contained in the log event.
fleTimestamp :: Lens' FilteredLogEvent (Maybe Natural) Source #
The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
fleEventId :: Lens' FilteredLogEvent (Maybe Text) Source #
The ID of the event.
InputLogEvent
data InputLogEvent Source #
Represents a log event, which is a record of activity that was recorded by the application or resource being monitored.
See: inputLogEvent
smart constructor.
Creates a value of InputLogEvent
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
ileTimestamp
- The time the event occurred, expressed as the number of milliseconds fter Jan 1, 1970 00:00:00 UTC.ileMessage
- The raw event message.
ileTimestamp :: Lens' InputLogEvent Natural Source #
The time the event occurred, expressed as the number of milliseconds fter Jan 1, 1970 00:00:00 UTC.
ileMessage :: Lens' InputLogEvent Text Source #
The raw event message.
LogGroup
Represents a log group.
See: logGroup
smart constructor.
Creates a value of LogGroup
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lgCreationTime
- The creation time of the log group, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.lgMetricFilterCount
- The number of metric filters.lgArn
- The Amazon Resource Name (ARN) of the log group.lgLogGroupName
- The name of the log group.lgRetentionInDays
- Undocumented member.lgKmsKeyId
- The Amazon Resource Name (ARN) of the CMK to use when encrypting log data.lgStoredBytes
- The number of bytes stored.
lgCreationTime :: Lens' LogGroup (Maybe Natural) Source #
The creation time of the log group, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
lgKmsKeyId :: Lens' LogGroup (Maybe Text) Source #
The Amazon Resource Name (ARN) of the CMK to use when encrypting log data.
LogStream
Represents a log stream, which is a sequence of log events from a single emitter of logs.
See: logStream
smart constructor.
logStream :: LogStream Source #
Creates a value of LogStream
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
lsCreationTime
- The creation time of the stream, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.lsUploadSequenceToken
- The sequence token.lsArn
- The Amazon Resource Name (ARN) of the log stream.lsFirstEventTimestamp
- The time of the first event, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.lsLogStreamName
- The name of the log stream.lsStoredBytes
- The number of bytes stored.lsLastIngestionTime
- The ingestion time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.lsLastEventTimestamp
- the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.
lsCreationTime :: Lens' LogStream (Maybe Natural) Source #
The creation time of the stream, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
lsFirstEventTimestamp :: Lens' LogStream (Maybe Natural) Source #
The time of the first event, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
lsLastIngestionTime :: Lens' LogStream (Maybe Natural) Source #
The ingestion time, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
lsLastEventTimestamp :: Lens' LogStream (Maybe Natural) Source #
the time of the most recent log event in the log stream in CloudWatch Logs. This number is expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC. lastEventTime updates on an eventual consistency basis. It typically updates in less than an hour from ingestion, but may take longer in some rare situations.
MetricFilter
data MetricFilter Source #
Metric filters express how CloudWatch Logs would extract metric observations from ingested log events and transform them into metric data in a CloudWatch metric.
See: metricFilter
smart constructor.
metricFilter :: MetricFilter Source #
Creates a value of MetricFilter
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
mfCreationTime
- The creation time of the metric filter, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.mfFilterName
- The name of the metric filter.mfLogGroupName
- The name of the log group.mfFilterPattern
- Undocumented member.mfMetricTransformations
- The metric transformations.
mfCreationTime :: Lens' MetricFilter (Maybe Natural) Source #
The creation time of the metric filter, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
mfFilterName :: Lens' MetricFilter (Maybe Text) Source #
The name of the metric filter.
mfLogGroupName :: Lens' MetricFilter (Maybe Text) Source #
The name of the log group.
mfFilterPattern :: Lens' MetricFilter (Maybe Text) Source #
Undocumented member.
mfMetricTransformations :: Lens' MetricFilter (Maybe (NonEmpty MetricTransformation)) Source #
The metric transformations.
MetricFilterMatchRecord
data MetricFilterMatchRecord Source #
Represents a matched event.
See: metricFilterMatchRecord
smart constructor.
metricFilterMatchRecord :: MetricFilterMatchRecord Source #
Creates a value of MetricFilterMatchRecord
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
mfmrExtractedValues
- The values extracted from the event data by the filter.mfmrEventNumber
- The event number.mfmrEventMessage
- The raw event data.
mfmrExtractedValues :: Lens' MetricFilterMatchRecord (HashMap Text Text) Source #
The values extracted from the event data by the filter.
mfmrEventNumber :: Lens' MetricFilterMatchRecord (Maybe Integer) Source #
The event number.
mfmrEventMessage :: Lens' MetricFilterMatchRecord (Maybe Text) Source #
The raw event data.
MetricTransformation
data MetricTransformation Source #
Indicates how to transform ingested log events in to metric data in a CloudWatch metric.
See: metricTransformation
smart constructor.
Creates a value of MetricTransformation
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
mtDefaultValue
- (Optional) The value to emit when a filter pattern does not match a log event. This value can be null.mtMetricName
- The name of the CloudWatch metric.mtMetricNamespace
- The namespace of the CloudWatch metric.mtMetricValue
- The value to publish to the CloudWatch metric when a filter pattern matches a log event.
mtDefaultValue :: Lens' MetricTransformation (Maybe Double) Source #
(Optional) The value to emit when a filter pattern does not match a log event. This value can be null.
mtMetricName :: Lens' MetricTransformation Text Source #
The name of the CloudWatch metric.
mtMetricNamespace :: Lens' MetricTransformation Text Source #
The namespace of the CloudWatch metric.
mtMetricValue :: Lens' MetricTransformation Text Source #
The value to publish to the CloudWatch metric when a filter pattern matches a log event.
OutputLogEvent
data OutputLogEvent Source #
Represents a log event.
See: outputLogEvent
smart constructor.
outputLogEvent :: OutputLogEvent Source #
Creates a value of OutputLogEvent
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
oleIngestionTime
- The time the event was ingested, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.oleMessage
- The data contained in the log event.oleTimestamp
- The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
oleIngestionTime :: Lens' OutputLogEvent (Maybe Natural) Source #
The time the event was ingested, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
oleMessage :: Lens' OutputLogEvent (Maybe Text) Source #
The data contained in the log event.
oleTimestamp :: Lens' OutputLogEvent (Maybe Natural) Source #
The time the event occurred, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
RejectedLogEventsInfo
data RejectedLogEventsInfo Source #
Represents the rejected events.
See: rejectedLogEventsInfo
smart constructor.
rejectedLogEventsInfo :: RejectedLogEventsInfo Source #
Creates a value of RejectedLogEventsInfo
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rleiTooOldLogEventEndIndex
- The log events that are too old.rleiTooNewLogEventStartIndex
- The log events that are too new.rleiExpiredLogEventEndIndex
- The expired log events.
rleiTooOldLogEventEndIndex :: Lens' RejectedLogEventsInfo (Maybe Int) Source #
The log events that are too old.
rleiTooNewLogEventStartIndex :: Lens' RejectedLogEventsInfo (Maybe Int) Source #
The log events that are too new.
rleiExpiredLogEventEndIndex :: Lens' RejectedLogEventsInfo (Maybe Int) Source #
The expired log events.
ResourcePolicy
data ResourcePolicy Source #
A policy enabling one or more entities to put logs to a log group in this account.
See: resourcePolicy
smart constructor.
resourcePolicy :: ResourcePolicy Source #
Creates a value of ResourcePolicy
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rpPolicyName
- The name of the resource policy.rpPolicyDocument
- The details of the policy.rpLastUpdatedTime
- Time stamp showing when this policy was last updated, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
rpPolicyName :: Lens' ResourcePolicy (Maybe Text) Source #
The name of the resource policy.
rpPolicyDocument :: Lens' ResourcePolicy (Maybe Text) Source #
The details of the policy.
rpLastUpdatedTime :: Lens' ResourcePolicy (Maybe Natural) Source #
Time stamp showing when this policy was last updated, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
SearchedLogStream
data SearchedLogStream Source #
Represents the search status of a log stream.
See: searchedLogStream
smart constructor.
searchedLogStream :: SearchedLogStream Source #
Creates a value of SearchedLogStream
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
slsLogStreamName
- The name of the log stream.slsSearchedCompletely
- Indicates whether all the events in this log stream were searched.
slsLogStreamName :: Lens' SearchedLogStream (Maybe Text) Source #
The name of the log stream.
slsSearchedCompletely :: Lens' SearchedLogStream (Maybe Bool) Source #
Indicates whether all the events in this log stream were searched.
SubscriptionFilter
data SubscriptionFilter Source #
Represents a subscription filter.
See: subscriptionFilter
smart constructor.
subscriptionFilter :: SubscriptionFilter Source #
Creates a value of SubscriptionFilter
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
sfCreationTime
- The creation time of the subscription filter, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.sfFilterName
- The name of the subscription filter.sfDistribution
- Undocumented member.sfDestinationARN
- The Amazon Resource Name (ARN) of the destination.sfLogGroupName
- The name of the log group.sfFilterPattern
- Undocumented member.sfRoleARN
-
sfCreationTime :: Lens' SubscriptionFilter (Maybe Natural) Source #
The creation time of the subscription filter, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
sfFilterName :: Lens' SubscriptionFilter (Maybe Text) Source #
The name of the subscription filter.
sfDistribution :: Lens' SubscriptionFilter (Maybe Distribution) Source #
Undocumented member.
sfDestinationARN :: Lens' SubscriptionFilter (Maybe Text) Source #
The Amazon Resource Name (ARN) of the destination.
sfLogGroupName :: Lens' SubscriptionFilter (Maybe Text) Source #
The name of the log group.
sfFilterPattern :: Lens' SubscriptionFilter (Maybe Text) Source #
Undocumented member.