Zenduty ZendutyExecution

Zenduty ZendutyExecution

Certified

Notify Zenduty on flow execution

Sends a templated Zenduty message with execution link, namespace, flow, start time, duration, status, and failing task (if any). Use only in Flow trigger notifications; for errors handlers prefer ZendutyAlert.

yaml
type: io.kestra.plugin.zenduty.ZendutyExecution

Send a Zenduty notification on a failed flow execution.

yaml
id: zenduty_failure_alert
namespace: company.team

tasks:
  - id: send_alert
    type: io.kestra.plugin.zenduty.ZendutyExecution
    url: "https://www.zenduty.com/api/events/{{ secret('ZENDUTY_INTEGRATION_KEY') }}/"
    executionId: "{{ trigger.executionId }}"
    message: Kestra workflow execution {{ trigger.executionId }} of a flow {{ trigger.flowId }} in the namespace {{ trigger.namespace }} changed status to {{ trigger.state }}

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

Zenduty Events API URL

Full Events API endpoint including integration key, e.g. https://www.zenduty.com/api/events/<integration_key>/

Possible Values
CRITICALACKNOWLEDGEDRESOLVEDERRORWARNINGINFO

Alert severity

Zenduty alert type value rendered to lowercase string

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150

Custom fields to be added on notification

Custom message to be added on notification

Alert entity id

Optional unique id for the alert; Zenduty generates one if omitted

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.

Event title

Rendered into message in the Zenduty payload

Tune Zenduty HTTP client

Optional HTTP client settings such as timeouts, charset, headers, and response size limits. Defaults: read timeout 10s, read idle timeout 5m, connection pool idle timeout 0s (no reuse), max content length 10 MB, charset UTF-8

Definitions
connectTimeoutstring

Connection timeout before failing

connectionPoolIdleTimeoutstring
DefaultPT0S

Connection pool idle timeout

Defaults to 0s; disables keeping idle connections in the pool

defaultCharsetstring
DefaultUTF-8

Request charset

Defaults to UTF-8 for request encoding

headersobject

HTTP headers

Additional headers to include on the Zenduty request; supports expression rendering

maxContentLengthintegerstring
Default10485760

Maximum response size

Defaults to 10 MB; responses larger than this fail

readIdleTimeoutstring
DefaultPT5M

Idle read timeout

Defaults to 5m; closes the connection if no data is read during this interval

readTimeoutstring
DefaultPT10S

Read timeout before failing

Defaults to 10s; aborts if the server does not send data within this duration

Alert payload JSON

Raw JSON body sent to Zenduty; supports expressions before send

Event summary

Rendered into summary in the Zenduty payload

Template variables map

Values injected into the template; supports expressions

SubTypestring

Related URLs

List of URLs added under urls in the payload