Skip to main content

CloudWatch Logs Describe Log Groups

Lists the specified log groups. You can list all your log groups or filter the results by prefix. The results are ASCII-sorted by log group name.

CloudWatch Logs doesn’t support IAM policies that control access to the DescribeLogGroups action by using the aws:ResourceTag/key-name condition key. Other CloudWatch Logs actions do support the use of the aws:ResourceTag/key-name condition key to control access. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

External Documentation

To learn more, visit the AWS documentation.

Basic Parameters

ParameterDescription
AWS Region(s)Enter the desired AWS Region(s).

To execute the action in multiple regions, provide a comma-separated list.
For example: us-east-1,eu-west-2.

If you wish to run the action in all available regions, use the asterisk symbol (*) instead.
Log Group Name PrefixThe prefix to match.

Advanced Parameters

ParameterDescription
Disable XML To JSON Auto ConvertWhen checked, XML responses are not automatically converted into JSON format.
LimitThe maximum number of items returned.
If you don't specify a value, the default is up to 50 items.
Next TokenThe token for the next set of items to return. (You received this token from a previous call.)

Example Output

{
"logGroups": [
{
"arn": "string",
"creationTime": 0,
"kmsKeyId": "string",
"logGroupName": "[\\.\\-_/#A-Za-z0-9]+",
"metricFilterCount": 0,
"retentionInDays": 0,
"storedBytes": 0
}
],
"nextToken": "The token for the next set of items to return. The token expires after 24 hours."
}

Automation Library Example

Cloudwatch Logs Describe Log Groups with Aws and Send Results Via Email

Automation LibraryPreview this Automation on desktop