Overview
Retrieves detailed information about a specific alert within an incident. Use this tool when you need to examine the full details of a particular alert.
This is a read-only tool. It retrieves data without modifying your PagerDuty account.
Parameters
The ID of the incident containing the alert. Example: Q1XQPZ3PYQ0ABC
The ID of the alert to retrieve. Example: PALERT123ABC
Response
Returns a single Alert object with complete details.
The unique identifier for the alert.
The type of the object (always "alert").
A short summary of the alert.
The API URL at which this alert is accessible.
The URL at which this alert is accessible in the PagerDuty UI.
The date/time when this alert was created.
The current status of the alert (e.g., triggered, resolved).
The unique key identifying this alert.
Reference to the service this alert is associated with. The type (always "service_reference").
A short summary of the service.
Reference to the incident this alert is associated with. The type of the reference.
A short summary of the incident.
The API URL for the incident.
The UI URL for the incident.
The detailed body of the alert. Additional context information for the alert.
Detailed information about the alert, which varies based on the integration and alert type.
The severity level of the alert (e.g., critical, error, warning, info).
Whether the alert is suppressed.
Reference to the integration that created this alert. Show IntegrationReference
The ID of the integration.
The type of the integration.
A short summary of the integration.
The API URL for the integration.
The UI URL for the integration.
Example Usage
Natural Language
Get Alert Details
Show me alert PALERT123ABC from incident Q1XQPZ3PYQ0ABC
Example Response
{
"id" : "PALERT123ABC" ,
"type" : "alert" ,
"summary" : "High CPU usage on web-server-01" ,
"self" : "https://api.pagerduty.com/alerts/PALERT123ABC" ,
"html_url" : "https://myaccount.pagerduty.com/alerts/PALERT123ABC" ,
"created_at" : "2024-03-15T14:30:00Z" ,
"status" : "triggered" ,
"alert_key" : "cpu-high-web-01" ,
"service" : {
"id" : "PSERVICE1" ,
"type" : "service_reference" ,
"summary" : "Production Web Service"
},
"incident" : {
"id" : "Q1XQPZ3PYQ0ABC" ,
"type" : "incident_reference" ,
"summary" : "High CPU usage detected" ,
"self" : "https://api.pagerduty.com/incidents/Q1XQPZ3PYQ0ABC" ,
"html_url" : "https://myaccount.pagerduty.com/incidents/Q1XQPZ3PYQ0ABC"
},
"body" : {
"type" : "alert_body" ,
"contexts" : [],
"details" : {
"cpu_usage" : "95%" ,
"hostname" : "web-server-01" ,
"timestamp" : "2024-03-15T14:30:00Z" ,
"metric" : "system.cpu.usage"
}
},
"severity" : "critical" ,
"suppressed" : false ,
"integration" : {
"id" : "PINTEGRATION1" ,
"type" : "inbound_integration_reference" ,
"summary" : "Datadog Integration" ,
"self" : "https://api.pagerduty.com/services/PSERVICE1/integrations/PINTEGRATION1" ,
"html_url" : "https://myaccount.pagerduty.com/services/PSERVICE1/integrations/PINTEGRATION1"
}
}
list_alerts_from_incident List all alerts for an incident
get_incident Get incident details