@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
includeLinkedAccountsistrue 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
NextTokenwas 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
NextTokenwas 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.
StartQueryrequires exactly one oflogGroupName,logGroupNamesorlogGroupIdentifiers. logGroupName(string)-
Name of the log group
logGroupNames(array)-
List of log groups to query.
StartQueryrequires exactly one oflogGroupName,logGroupNamesorlogGroupIdentifiers. 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!
AssociateKmsKeyCancelExportTaskCreateDeliveryCreateExportTaskCreateLogAnomalyDetectorCreateLogGroupCreateLogStreamDeleteAccountPolicyDeleteDataProtectionPolicyDeleteDeliveryDeleteDeliveryDestinationDeleteDeliveryDestinationPolicyDeleteDeliverySourceDeleteDestinationDeleteLogAnomalyDetectorDeleteLogStreamDeleteMetricFilterDeleteQueryDefinitionDeleteResourcePolicyDeleteRetentionPolicyDeleteSubscriptionFilterDescribeAccountPoliciesDescribeDeliveriesDescribeDeliveryDestinationsDescribeDeliverySourcesDescribeDestinationsDescribeExportTasksDescribeMetricFiltersDescribeQueriesDescribeQueryDefinitionsDescribeResourcePoliciesDescribeSubscriptionFiltersDisassociateKmsKeyFilterLogEventsGetDataProtectionPolicyGetDeliveryGetDeliveryDestinationGetDeliveryDestinationPolicyGetDeliverySourceGetLogAnomalyDetectorGetLogGroupFieldsGetLogRecordListAnomaliesListLogAnomalyDetectorsListTagsForResourceListTagsLogGroupPutAccountPolicyPutDataProtectionPolicyPutDeliveryDestinationPutDeliveryDestinationPolicyPutDeliverySourcePutDestinationPutDestinationPolicyPutLogEventsPutMetricFilterPutQueryDefinitionPutResourcePolicyPutRetentionPolicyPutSubscriptionFilterStartLiveTailStopQueryTagLogGroupTagResourceTestMetricFilterUntagLogGroupUntagResourceUpdateAnomalyUpdateLogAnomalyDetector