Juan Fabrega
12/05/2025, 7:21 PMkapa.ai
12/05/2025, 7:21 PMstartedAt, finishedAt - durationInSeconds, durationFormatted - success flag - errorType, errorOrigin (for failures) Example for a failed sync webhook:[[Webhook payloads](https://docs.airbyte.com/platform/cloud/managing-airbyte-cloud/manage-airbyte-cloud-notifications#set-up-webhook-notifications)] json { "data": { "workspace": {...}, "connection": {...}, "jobId": 9988, "startedAt": "2024-01-01T00:00:00Z", "finishedAt": "2024-01-01T01:00:00Z", "success": false, "durationInSeconds": 3600, "durationFormatted": "1 hours 0 min" } } You can use these fields in your webhook receiver to implement your own logic, for example: - Compare durationInSeconds to historical averages and alert if it’s unusually high. - Alert when multiple failed syncs occur in a row for the same connection (in addition to the built‑in “repeated failures” events). 3. Platform‑level safeguards against hanging jobs Airbyte has internal mechanisms that detect when a sync is “stuck” and will eventually fail it, which in turn can trigger your failure notifications: - Source heartbeats: If the source stops emitting RECORD or STATE messages for longer than heartbeat-max-seconds-between-messages (default 3 hours), the sync is failed with “The source is unresponsive.”[[Heartbeats](https://docs.airbyte.com/platform/understanding-airbyte/heartbeats#technical-details)] - Destination timeout: If a call to the destination exceeds destination-timeout-max-seconds (default 24 hours), the sync is failed with “The destination is unresponsive.”[[Heartbeats](https://docs.airbyte.com/platform/understanding-airbyte/heartbeats#technical-details)] Both are configurable in flags.yaml and, when they cause a failure, you can be notified via the same notification system. 4. Global job timeout (older versions) In older forum posts, support mentions SYNC_JOB_MAX_TIMEOUT_DAYS (minimum 1 day) to forcefully time out very long‑running jobs:[[Sync timeout env var](https://discuss.airbyte.io/t/709)] env SYNC_JOB_MAX_TIMEOUT_DAYS=3 The knowledge sources don’t document a more granular hours‑level timeout, only this days‑level setting and the heartbeat/timeout mechanisms above. --- So while there isn’t a built‑in “alert when this specific sync exceeds X minutes” toggle in the docs, you can: - Enable Failed syncs and repeated‑failure notifications (email or webhook). - Use the webhook payload to implement your own “slower than usual” or “appears stalled” logic in whatever monitoring/alerting system you use.kapa.ai
12/05/2025, 7:21 PMdurationInSeconds, or by detecting missing completions within an expected time window. [[Set up webhook](https://docs.airbyte.com/platform/cloud/managing-airbyte-cloud/manage-airbyte-cloud-notifications#set-up-webhook-notifications)] 2. Use heartbeat / timeout signals (Self‑Managed) For self‑managed deployments, Airbyte has internal heartbeat and timeout logic: - Source heartbeat: If no RECORD or STATE messages are seen for longer than heartbeat-max-seconds-between-messages (default 3 hours), Airbyte fails the sync with “The source is unresponsive.” [[Heartbeats](https://docs.airbyte.com/platform/understanding-airbyte/heartbeats#technical-details)] - Destination timeout: If a call to the destination exceeds destination-timeout-max-seconds (default 24 hours), Airbyte treats the destination as timed out and (by default) fails the sync with “The destination is unresponsive.” [[Heartbeats](https://docs.airbyte.com/platform/understanding-airbyte/heartbeats#technical-details)] Once these failures occur, your existing Failed sync webhook/email notifications will fire, which you can treat as alerts for “stalled” pipelines. [[Manage notifications](https://docs.airbyte.com/platform/cloud/managing-airbyte-cloud/manage-airbyte-cloud-notifications)] 3. Job‑level max runtime (Self‑Managed) There is also an environment variable SYNC_JOB_MAX_TIMEOUT_DAYS (minimum 1 day) that force‑terminates very long‑running jobs. It’s coarse‑grained (days, not hours), but can act as a safety net so jobs don’t run indefinitely. [[K8s timeout thread](https://discuss.airbyte.io/t/709); [Connector runtime thread](https://discuss.airbyte.io/t/1037)] 4. Downstream monitoring with webhooks Because webhook payloads include start/end times and success/failure, you can: - Trigger alerts if no Success or Failed webhook arrives for a connection within X minutes of its schedule. - Trigger alerts when durationInSeconds exceeds a threshold you define as “unusually long.” [[Set up webhook](https://docs.airbyte.com/platform/cloud/managing-airbyte-cloud/manage-airbyte-cloud-notifications#set-up-webhook-notifications)] If you need fine‑grained “this specific sync has exceeded N minutes” alerts, that logic must currently be implemented in your own monitoring system consuming Airbyte’s webhooks; the docs do not describe a native per‑connection “max runtime in minutes/hours” alerting feature beyond the mechanisms above.Juan Fabrega
03/06/2026, 10:43 PM