aggregate_log_group_summaries
Creates, updates, deletes, gets or lists an aggregate_log_group_summaries resource.
Overview
| Name | aggregate_log_group_summaries |
| Type | Resource |
| Id | aws.logs.aggregate_log_group_summaries |
Fields
The following fields are returned by SELECT queries:
- list_aggregate_log_group_summaries
| Name | Datatype | Description |
|---|---|---|
grouping_identifiers | array | An array of key-value pairs that identify the data source characteristics used to group the log groups. The size and content of this array depends on the groupBy parameter specified in the request. |
log_group_count | integer | The number of log groups in this aggregate summary group. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_aggregate_log_group_summaries | select | region | Returns an aggregate summary of all log groups in the Region grouped by specified data source characteristics. Supports optional filtering by log group class, name patterns, and data sources. If you perform this action in a monitoring account, you can also return aggregated summaries of log groups from source accounts that are linked to the monitoring account. For more information about using cross-account observability to set up monitoring accounts and source accounts, see CloudWatch cross-account observability. The operation aggregates log groups by data source name and type and optionally format, providing counts of log groups that share these characteristics. The operation paginates results. By default, it returns up to 50 results and includes a token to retrieve more results. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- list_aggregate_log_group_summaries
Returns an aggregate summary of all log groups in the Region grouped by specified data source characteristics. Supports optional filtering by log group class, name patterns, and data sources. If you perform this action in a monitoring account, you can also return aggregated summaries of log groups from source accounts that are linked to the monitoring account. For more information about using cross-account observability to set up monitoring accounts and source accounts, see CloudWatch cross-account observability. The operation aggregates log groups by data source name and type and optionally format, providing counts of log groups that share these characteristics. The operation paginates results. By default, it returns up to 50 results and includes a token to retrieve more results.
SELECT
grouping_identifiers,
log_group_count
FROM aws.logs.aggregate_log_group_summaries
WHERE region = '{{ region }}' -- required
;