Skip to main content

Email Alerts for Dataform Errors

💎Premium Feature

This feature is available exclusively for Premium users.

When a Dataform workflow invocation fails, you want to know immediately - not discover it days later when dashboards go stale. Email alerts automatically notify you when errors occur in your Dataform workflows.

How It Works​

  1. Error detection - A Cloud Logging sink in your project captures failed Dataform workflow invocations and publishes them to a Pub/Sub topic
  2. Error forwarding - An Eventarc trigger launches a Cloud Workflow that enriches the error with invocation details and forwards it to GA4Dataform's notification system
  3. Error collection - Events are stored and deduplicated so you don't get spammed with repeat notifications for the same failure
  4. Hourly digest - Every hour, new errors are grouped by project and repository, then sent as a single email per affected repository

This gives you timely awareness of failures without alert fatigue from duplicate notifications.

tip

Errors are deduplicated based on the combination of project, repository, invocation, and error message. If the same workflow fails repeatedly with the same error, you receive one notification - not dozens.

Enabling Email Alerts​

Email alerts are configured during installation at setup.ga4dataform.com. When you install or update your Premium deployment, select the option to enable email notifications.

The installer provisions the required infrastructure in your GCP project:

  • Cloud Logging sink filtered to Dataform workflow error events
  • Pub/Sub topic and subscription
  • Eventarc trigger
  • Cloud Workflow that forwards errors to GA4Dataform's notification system

See the Installer Permissions page for the additional GCP roles required.

What You Receive​

When errors occur, you receive an HTML email containing:

  • The GCP project and Dataform repository where the error happened
  • The specific workflow invocation that failed
  • The error message from Dataform
  • A timestamp of when the failure occurred

Emails are sent at most once per hour, batching any errors that occurred since the last check.