Overview
Thelist_alert_grouping_settings tool retrieves all alert grouping settings in your PagerDuty account. Alert grouping settings define how alerts are automatically grouped into incidents based on various criteria.
This is a read-only tool that does not modify any data in your PagerDuty account. Alert Grouping features are available only on certain PagerDuty plans.
Parameters
Filter alert grouping settings by service IDs. Only returns settings related to the specified services.Example:
["PSVC123", "PSVC456"]Maximum number of results to return. Must be between 1 and 100.Example:
50Cursor to retrieve the next page of results. Only present if a next page exists.Example:
"cursor_token_here"Cursor to retrieve the previous page of results. Only present if not on the first page.Example:
"cursor_token_here"Set to
true to include the total count of settings in the response. By default, this is set to false for faster response times.Example: trueResponse
Returns a list of alert grouping setting objects.Array of alert grouping setting objects
Example Usage
Use Cases
- Audit grouping configuration - Review how alerts are grouped across services
- Service-specific review - View grouping settings for specific services
- Configuration discovery - Find existing grouping rules before creating new ones
- Optimization - Identify services using different grouping strategies
- Compliance - Verify alert grouping meets organizational standards
Grouping Types Explained
Content-Based
Groups alerts when specified fields match exactly. Best for consistent alert formats.Content-Based Intelligent
Combines field matching with intelligent analysis for more sophisticated grouping.Intelligent
Uses AI to intelligently group related alerts without explicit field matching.Time-Based
Groups all alerts within a specified time window, regardless of content.Related Tools
- Get Alert Grouping Setting - Retrieve a specific setting by ID
- Create Alert Grouping Setting - Create a new grouping configuration
- Update Alert Grouping Setting - Modify an existing setting
- Delete Alert Grouping Setting - Remove a grouping configuration