Zenduty ZendutyAlert

Zenduty ZendutyAlert

Certified

Send Zenduty alert payload

Posts a custom JSON payload to the Zenduty Events API. Use in errors to signal flow failures. Payload must follow the Events API (required: message, alert_type).

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

Send a Zenduty alert on a failed flow execution. Make sure that the payload follows the Zenduty Events API specification, including the message and alert_type payload properties, which are required.

yaml
id: unreliable_flow
namespace: company.team

tasks:
  - id: fail
    type: io.kestra.plugin.scripts.shell.Commands
    commands:
      - exit 1

errors:
  - id: alert_on_failure
    type: io.kestra.plugin.zenduty.ZendutyAlert
    url: "https://www.zenduty.com/api/events/{{ secret('ZENDUTY_INTEGRATION_KEY') }}/"
    payload: |
      {
        "alert_type": "info",
        "message": "This is info alert",
        "summary": "This is the incident summary",
        "suppressed": false,
        "entity_id": 12345,
        "payload": {
            "status": "ACME Payments are failing",
            "severity": "1",
            "project": "kubeprod"
          },
        "urls": [
          {
            "link_url": "https://www.example.com/alerts/12345/",
            "link_text": "Alert URL"
          }
        ]
      }
Properties
Min length1

Zenduty Events API URL

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

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

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

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