Blueprints

Set up alerts for failed workflow executions using Gmail

Source

yaml
id: failed-alert-gmail
namespace: system
tasks:
  - id: notify
    type: io.kestra.plugin.notifications.mail.MailSend
    from: [email protected]
    to: [email protected]
    username: "{{ secret('G_EMAIL') }}"
    password: "{{ secret('G_APP_PASSWORD') }}"
    host: smtp.gmail.com
    port: 465
    subject: Failed Execution - {{ trigger.executionId }}
    htmlTextContent: "{{ trigger.executionId }}"
triggers:
  - id: on_failure
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatusCondition
        in:
          - FAILED
          - WARNING

About this blueprint

System Notifications

This system flow will help you set up alerts for failed workflow executions. Using this pattern, you can manage alerts on failure in one place.

This flow sends an email alert with Gmail whenever a flow execution fails.

If you have 2FA setup on your Google account, you'll need to set up an App password. Once you've generated an App password, save it as a secret which you can reference in the password property.

For more information on creating App passwords, check out the guide here.

Restricting alerts using conditions

You can restrict the flow to only send alerts for specific namespaces by adding an ExecutionNamespaceCondition to the trigger. You can read more about that in the Administrator Guide.

Mail Send

Flow

Execution Status Condition

More Related Blueprints

New to Kestra?

Use blueprints to kickstart your first workflows.

Get started with Kestra