PagerDuty

PagerDuty é uma plataforma líder de gerenciamento de incidentes que ajuda equipes de engenharia e operações a detectar, triar e resolver problemas de infraestrutura e aplicações em tempo real. O PagerDuty integra-se a ferramentas de monitoramento, orquestra escalas on-call e garante que as pessoas certas sejam alertadas quando ocorrem incidentes.

A integração do PagerDuty no Zoen conecta-se à PagerDuty REST API v2 com autenticação por API key, permitindo que seus agentes gerenciem o ciclo de vida completo dos incidentes e consultem informações on-call de forma programática.

Com a integração do PagerDuty, seus agentes podem:

  • Listar e filtrar incidentes: Recuperar incidentes filtrados por status (triggered, acknowledged, resolved), serviço, intervalo de datas e ordem de classificação para monitorar a saúde operacional
  • Criar incidentes: Disparar novos incidentes em serviços específicos com títulos, descrições, níveis de urgência e assignees personalizados diretamente dos seus workflows
  • Atualizar incidentes: Acknowledge ou resolver incidentes, alterar urgência e adicionar notas de resolução para manter o gerenciamento de incidentes sincronizado com processos automatizados
  • Adicionar notas a incidentes: Anexar informações contextuais, achados de investigação ou diagnósticos automatizados como notas em incidentes existentes
  • Listar serviços: Consultar o catálogo de serviços do PagerDuty para descobrir IDs e metadados para uso em outras operações
  • Verificar escalas on-call: Recuperar entradas on-call atuais filtradas por política de escalonamento ou schedule para determinar quem é responsável a qualquer momento

No Zoen, a integração com o PagerDuty habilita cenários poderosos de automação de incidentes. Seus agentes podem criar incidentes automaticamente com base em alertas de monitoramento, enriquecer incidentes com dados diagnósticos de outras ferramentas, resolver incidentes quando a remediação automatizada tem sucesso, ou construir workflows de escalonamento que verificam escalas on-call e roteiam notificações. Ao conectar o Zoen ao PagerDuty, você pode construir agentes inteligentes que unem detecção e resposta, reduzindo o mean time to resolution e garantindo tratamento consistente de incidentes em toda a organização.

Usage Instructions

Integrate PagerDuty into your workflow to list, get, create, update, snooze, and merge incidents, add notes and list alerts, look up services and escalation policies, check on-call schedules, list users, and send monitoring events through the Events API v2.

Actions

pagerduty_list_incidents

List incidents from PagerDuty with optional filters.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
statusesstringNoComma-separated statuses to filter (triggered, acknowledged, resolved)
urgenciesstringNoComma-separated urgencies to filter (high, low)
serviceIdsstringNoComma-separated service IDs to filter
sincestringNoStart date filter (ISO 8601 format)
untilstringNoEnd date filter (ISO 8601 format)
sortBystringNoSort field (e.g., created_at:desc)
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
incidentsarrayArray of incidents
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringIncident status
urgencystringIncident urgency
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
serviceNamestringService name
serviceIdstringService ID
assigneeNamestringAssignee name
assigneeIdstringAssignee ID
escalationPolicyNamestringEscalation policy name
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching incidents (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_get_incident

Get a single incident from PagerDuty by ID.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
incidentIdstringYesID of the incident to fetch

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringIncident status
urgencystringIncident urgency
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
resolvedAtstringResolution timestamp
serviceNamestringService name
serviceIdstringService ID
assigneeNamestringAssignee name
assigneeIdstringAssignee ID
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
incidentKeystringDe-duplication key
htmlUrlstringPagerDuty web URL

pagerduty_create_incident

Create a new incident in PagerDuty.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
titlestringYesIncident title/summary
serviceIdstringYesID of the PagerDuty service
urgencystringNoUrgency level (high or low)
bodystringNoDetailed description of the incident
escalationPolicyIdstringNoEscalation policy ID to assign
assigneeIdstringNoUser ID to assign the incident to
incidentKeystringNoDe-duplication key. A subsequent request with the same service and incident key updates the existing open incident instead of creating a new one

Output

ParameterTypeDescription
idstringCreated incident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringIncident status
urgencystringIncident urgency
createdAtstringCreation timestamp
serviceNamestringService name
serviceIdstringService ID
htmlUrlstringPagerDuty web URL

pagerduty_update_incident

Update an incident in PagerDuty (acknowledge, resolve, change urgency, etc.).

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
incidentIdstringYesID of the incident to update
statusstringNoNew status (triggered, acknowledged, or resolved)
titlestringNoNew incident title
urgencystringNoNew urgency (high or low)
escalationLevelstringNoEscalation level to escalate to
resolutionstringNoResolution note added to the incident's log entry. Only used when status is set to resolved

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringUpdated status
urgencystringUpdated urgency
updatedAtstringLast updated timestamp
htmlUrlstringPagerDuty web URL

pagerduty_snooze_incident

Snooze a triggered PagerDuty incident for a number of seconds, after which it returns to triggered.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
incidentIdstringYesID of the incident to snooze
durationstringYesNumber of seconds to snooze the incident for (1 to 604800)

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
statusstringIncident status after snoozing
htmlUrlstringPagerDuty web URL

pagerduty_merge_incidents

Merge one or more source incidents into a target incident. Source incidents are resolved and their alerts move to the target.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
targetIncidentIdstringYesID of the incident that will absorb the source incidents
sourceIncidentIdsstringYesComma-separated IDs of the incidents to merge into the target incident

Output

ParameterTypeDescription
idstringTarget incident ID
incidentNumbernumberTarget incident number
titlestringTarget incident title
statusstringTarget incident status
htmlUrlstringPagerDuty web URL

pagerduty_add_note

Add a note to an existing PagerDuty incident.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
incidentIdstringYesID of the incident to add the note to
contentstringYesNote content text

Output

ParameterTypeDescription
idstringNote ID
contentstringNote content
createdAtstringCreation timestamp
userNamestringName of the user who created the note

pagerduty_list_incident_alerts

List the individual alerts attached to a PagerDuty incident.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
incidentIdstringYesID of the incident whose alerts to list
statusesstringNoComma-separated statuses to filter (triggered, resolved)
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
alertsarrayArray of alerts attached to the incident
idstringAlert ID
summarystringAlert summary
statusstringAlert status
severitystringAlert severity
createdAtstringCreation timestamp
alertKeystringDe-duplication key
serviceNamestringService name
serviceIdstringService ID
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching alerts (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_services

List services from PagerDuty with optional name filter.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter services by name
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
servicesarrayArray of services
idstringService ID
namestringService name
descriptionstringService description
statusstringService status
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
createdAtstringCreation timestamp
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching services (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_get_service

Get a single service from PagerDuty by ID.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
serviceIdstringYesID of the service to fetch

Output

ParameterTypeDescription
idstringService ID
namestringService name
descriptionstringService description
statusstringService status
autoResolveTimeoutnumberSeconds before an open incident auto-resolves
acknowledgementTimeoutnumberSeconds before an acknowledged incident reverts to triggered
createdAtstringCreation timestamp
lastIncidentTimestampstringTimestamp of the most recent incident
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
htmlUrlstringPagerDuty web URL

pagerduty_list_oncalls

List current on-call entries from PagerDuty.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
escalationPolicyIdsstringNoComma-separated escalation policy IDs to filter
scheduleIdsstringNoComma-separated schedule IDs to filter
sincestringNoStart time filter (ISO 8601 format)
untilstringNoEnd time filter (ISO 8601 format)
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
oncallsarrayArray of on-call entries
userNamestringOn-call user name
userIdstringOn-call user ID
escalationLevelnumberEscalation level
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
scheduleNamestringSchedule name
scheduleIdstringSchedule ID
startstringOn-call start time
endstringOn-call end time
totalnumberTotal number of matching on-call entries (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_escalation_policies

List escalation policies from PagerDuty with an optional name filter.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter escalation policies by name
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
escalationPoliciesarrayArray of escalation policies
idstringEscalation policy ID
namestringEscalation policy name
descriptionstringEscalation policy description
numLoopsnumberNumber of times the policy repeats
onCallHandoffNotificationsstringHandoff notification setting (if_has_services or always)
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching escalation policies (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_schedules

List on-call schedules from PagerDuty with an optional name filter.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter schedules by name
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
schedulesarrayArray of on-call schedules
idstringSchedule ID
namestringSchedule name
descriptionstringSchedule description
timeZonestringSchedule time zone
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching schedules (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_users

List users from PagerDuty with an optional name/email filter.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter users by name or email
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
usersarrayArray of users
idstringUser ID
namestringUser name
emailstringUser email
rolestringUser role
jobTitlestringUser job title
timeZonestringUser preferred time zone
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching users (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_send_event

Send a trigger, acknowledge, or resolve event to PagerDuty Events API v2 using a service integration key. Used to page from monitoring/alerting sources without a PagerDuty user account.

Input

ParameterTypeRequiredDescription
routingKeystringYesThe Events API v2 integration key (routing key) for the target service
eventActionstringYesEvent action: trigger, acknowledge, or resolve
summarystringNoBrief summary of the event. Required when eventAction is trigger
sourcestringNoUnique location of the affected system (e.g. hostname). Required when eventAction is trigger
severitystringNoPerceived severity: critical, warning, error, or info. Required when eventAction is trigger
dedupKeystringNoDe-duplication key identifying the alert. Required when eventAction is acknowledge or resolve; optional on trigger
componentstringNoComponent of the source machine responsible for the event
groupstringNoLogical grouping of components of a service
classstringNoThe class/type of the event

Output

ParameterTypeDescription
statusstringResult status ("success" if accepted)
messagestringDescription of the result
dedupKeystringDe-duplication key for the alert

Triggers

A Trigger is a block that starts a workflow when an event happens in this service.

PagerDuty Incident Acknowledged

Trigger workflow when an incident is acknowledged in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Escalated

Trigger workflow when an incident is escalated in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Event

Trigger workflow from any PagerDuty incident event

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Reassigned

Trigger workflow when an incident is reassigned in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Resolved

Trigger workflow when an incident is resolved in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Triggered

Trigger workflow when a new incident is triggered in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

On this page