PagerDuty PagerDutyExecution

PagerDuty PagerDutyExecution

Certified

Send PagerDuty alert for a flow run

Posts execution details (UI link, IDs, namespace, flow name, start time, duration, and final status with failing task when present) to PagerDuty via the Events API v2. Use only in flows triggered by a Flow trigger; for errors handlers use PagerDutyAlert instead. Defaults executionId to the current run.

yaml
type: io.kestra.plugin.pagerduty.PagerDutyExecution

Send a PagerDuty notification on a failed flow execution.

yaml
id: failure_alert
namespace: company.team

tasks:
  - id: send_alert
    type: io.kestra.plugin.pagerduty.PagerDutyExecution
    url: "{{ secret('PAGERDUTY_EVENT') }}" # format: https://events.pagerduty.com/v2/enqueue
    payloadSummary: "PagerDuty Alert"
    routingKey: "routingkey"
    eventAction: "trigger"
    executionId: "{{trigger.executionId}}"

triggers:
  - id: failed_prod_workflows
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatus
        in:
          - FAILED
          - WARNING
      - type: io.kestra.plugin.core.condition.ExecutionNamespace
        namespace: prod
        prefix: true
Properties
Min length1

PagerDuty Events API URL

Endpoint such as https://events.pagerduty.com/v2/enqueue; store secrets with secret().

Custom fields to be added on notification

Custom message to be added on notification

Deduplication key for correlating events

Allows PagerDuty to correlate trigger and resolve/acknowledge events.

PagerDuty event action

One of trigger, acknowledge, or resolve.

Default{{ execution.id }}

The execution id to use

Default is the current execution, change it to {{ trigger.executionId }} if you use this task with a Flow trigger to use the original execution.

HTTP client options

Optional overrides for timeouts, charset, and headers when calling PagerDuty. Defaults: read timeout 10s, read idle 5m, pool idle 0s, max content 10MB, charset UTF-8.

Definitions
connectTimeoutstring

Connect timeout before fail

connectionPoolIdleTimeoutstring
DefaultPT0S

Idle connection pool timeout

defaultCharsetstring
DefaultUTF-8

Default request charset

headersobject

HTTP headers

HTTP headers to include in the request

maxContentLengthintegerstring
Default10485760

Maximum response size in bytes

readIdleTimeoutstring
DefaultPT5M

Idle read timeout before close

readTimeoutstring
DefaultPT10S

Read timeout before fail

PagerDuty message payload

Raw JSON string sent to PagerDuty; must include routing_key and event_action. Supports templating.

Max length1024

Summary used in alert title

Brief text summary (max 1024 chars) rendered into the payload.

Reference (ref) of the pluginDefaults to apply to this task.

PagerDuty routing key

Integration key for the target PagerDuty service.

Template render variables

Key/value map rendered into the template before sending. Uses the current run scope.

More Plugins in this Category

YouTube
YouTube

Tasks that interact with the YouTube Data API.

Business

4 tasks

X
X

Tasks that post messages to X (formerly Twitter).

Business

1 tasks