@aws-lite/cloudwatch-logs
Maintained by: @architect
Install
npm i @aws-lite/cloudwatch-logs
Optionally install types:
npm i -D @aws-lite/cloudwatch-logs-types
Methods
DeleteLogGroup
Properties
logGroupName
(string) [required]-
Name of the log group
Example
await aws.CloudWatchLogs.DeleteLogGroup({
logGroupName: String, // required
})
DescribeLogGroups
Properties
accountIdentifiers
(array)-
List of accounts to search when
includeLinkedAccounts
istrue
includeLinkedAccounts
(boolean)-
Return log groups in the accounts enumerated by
accountIdentifiers
limit
(number)-
Maximum number of items to evaluate and return
logGroupClass
(string)-
Log group class setting:
STANDARD
(supports all CloudWatch Logs features), orINFREQUENT_ACCESS
(feature subset with lower costs) - Example
await aws.CloudWatchLogs.DescribeLogGroups({ accountIdentifiers: Array, includeLinkedAccounts: Boolean, limit: Number, logGroupClass: String, logGroupNamePattern: String, logGroupNamePrefix: String, nextToken: String, paginate: Boolean || String, })
DescribeLogStreams
Properties
descending
(boolean)-
Return results in descending order (if
true
) limit
(number)-
Maximum number of items to evaluate and return
logGroupIdentifier
(string)-
Name or ARN of the log group
logGroupName
(string)-
Name of the log group
logStreamNamePrefix
(string)-
Prefix to match
nextToken
(string)-
Pagination cursor token to be used if
NextToken
was returned in a previous response orderBy
(string)-
Order results by log stream name (
LogStreamName
) or event time (LastEventTime
) paginate
(boolean, string)-
Enable automatic result pagination; use this instead of making your own individual pagination requests
Example
await aws.CloudWatchLogs.DescribeLogStreams({
descending: Boolean,
limit: Number,
logGroupIdentifier: String,
logGroupName: String,
logStreamNamePrefix: String,
nextToken: String,
orderBy: String,
paginate: Boolean || String,
})
GetLogEvents
Properties
logStreamName
(string) [required]-
Name of the log stream
endTime
(number)-
End of the time range in epoch milliseconds
limit
(number)-
Maximum number of items to evaluate and return
logGroupIdentifier
(string)-
Name or ARN of the log group
logGroupName
(string)-
Name of the log group
nextToken
(string)-
Pagination cursor token to be used if
NextToken
was returned in a previous response paginate
(boolean, string)-
Enable automatic result pagination; use this instead of making your own individual pagination requests
startFromHead
(boolean)-
Return earliest log events first (
true
) startTime
(number)-
Start of the time range in epoch milliseconds
unmask
(boolean)-
Display log event fields with all sensitive data unmasked and visible (
true
)
Example
await aws.CloudWatchLogs.GetLogEvents({
logStreamName: String, // required
endTime: Number,
limit: Number,
logGroupIdentifier: String,
logGroupName: String,
nextToken: String,
paginate: Boolean || String,
startFromHead: Boolean,
startTime: Number,
unmask: Boolean,
})
GetQueryResults
Properties
queryId
(string)-
The ID of the query
Example
await aws.CloudWatchLogs.GetQueryResults({
queryId: String,
})
StartQuery
Properties
endTime
(number)-
End of the time range in epoch seconds
limit
(number)-
Maximum number of items to evaluate and return
logGroupIdentifiers
(array)-
List of log groups to query.
StartQuery
requires exactly one oflogGroupName
,logGroupNames
orlogGroupIdentifiers
. logGroupName
(string)-
Name of the log group
logGroupNames
(array)-
List of log groups to query.
StartQuery
requires exactly one oflogGroupName
,logGroupNames
orlogGroupIdentifiers
. query
(string)-
The query string to use
startTime
(number)-
Start of the time range in epoch seconds
Example
await aws.CloudWatchLogs.StartQuery({
endTime: Number,
limit: Number,
logGroupIdentifiers: Array,
logGroupName: String,
logGroupNames: Array,
query: String,
startTime: Number,
})
Methods yet to be implemented
Please help out by opening a PR!
AssociateKmsKey
CancelExportTask
CreateDelivery
CreateExportTask
CreateLogAnomalyDetector
CreateLogGroup
CreateLogStream
DeleteAccountPolicy
DeleteDataProtectionPolicy
DeleteDelivery
DeleteDeliveryDestination
DeleteDeliveryDestinationPolicy
DeleteDeliverySource
DeleteDestination
DeleteLogAnomalyDetector
DeleteLogStream
DeleteMetricFilter
DeleteQueryDefinition
DeleteResourcePolicy
DeleteRetentionPolicy
DeleteSubscriptionFilter
DescribeAccountPolicies
DescribeDeliveries
DescribeDeliveryDestinations
DescribeDeliverySources
DescribeDestinations
DescribeExportTasks
DescribeMetricFilters
DescribeQueries
DescribeQueryDefinitions
DescribeResourcePolicies
DescribeSubscriptionFilters
DisassociateKmsKey
FilterLogEvents
GetDataProtectionPolicy
GetDelivery
GetDeliveryDestination
GetDeliveryDestinationPolicy
GetDeliverySource
GetLogAnomalyDetector
GetLogGroupFields
GetLogRecord
ListAnomalies
ListLogAnomalyDetectors
ListTagsForResource
ListTagsLogGroup
PutAccountPolicy
PutDataProtectionPolicy
PutDeliveryDestination
PutDeliveryDestinationPolicy
PutDeliverySource
PutDestination
PutDestinationPolicy
PutLogEvents
PutMetricFilter
PutQueryDefinition
PutResourcePolicy
PutRetentionPolicy
PutSubscriptionFilter
StartLiveTail
StopQuery
TagLogGroup
TagResource
TestMetricFilter
UntagLogGroup
UntagResource
UpdateAnomaly
UpdateLogAnomalyDetector