---
title: Automatic Job Retries
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: >-
  Docs > Continuous Integration Visibility > CI Pipeline Visibility in Datadog >
  Automatic Job Retries
---

# Automatic Job Retries

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Automatic job retries save developer time by re-running failures that are likely transient, such as network timeouts, infrastructure failures, or flaky tests. Genuine code defects are not retried. Datadog runs each failed job through an AI-powered error classifier. When the failure is identified as retriable, Datadog triggers a retry through the CI provider's API without manual intervention.

Automatic retries reduce the number of pipelines that developers re-run by hand, shorten feedback loops, and keep pipeline success metrics focused on non-transient failures.

{% alert level="info" %}
Automatic job retries are available for [GitHub Actions](https://docs.datadoghq.com/continuous_integration/pipelines/github.md) and [GitLab](https://docs.datadoghq.com/continuous_integration/pipelines/gitlab.md).
{% /alert %}

## How automatic job retries work{% #how-automatic-job-retries-work %}

When a job in your CI pipeline fails:

1. Datadog's AI error classifier inspects the job's logs and error context to determine whether the failure is transient.
   - This is the same AI error classifier used by [CI jobs failure analysis](https://docs.datadoghq.com/continuous_integration/guides/use_ci_jobs_failure_analysis.md), which reads indexed job logs to decide whether a failure is transient.
1. If the failure is classified as retriable, Datadog requests a retry through the provider's API.
1. Datadog retries each failing job up to a maximum number of attempts (set by Datadog) to prevent infinite retry loops. Retries are counted per job per commit—if the same job fails again on a new commit, the counter resets.
1. Datadog records the retry outcome on the original pipeline in CI Visibility.

## Prerequisites{% #prerequisites %}

To use automatic job retries:

- CI Visibility must be enabled for your [GitHub Actions](https://docs.datadoghq.com/continuous_integration/pipelines/github.md) or [GitLab](https://docs.datadoghq.com/continuous_integration/pipelines/gitlab.md) integration.
- The [Datadog Source Code Integration](https://docs.datadoghq.com/integrations/guide/source-code-integration.md) must be configured for the repositories where you'd like to use automatic retries.
- Datadog must have indexed CI job logs for the repositories where you'd like to use automatic retries (see [Collect job logs for GitHub Actions](https://docs.datadoghq.com/continuous_integration/pipelines/github.md#collect-job-logs) or [Collect job logs for GitLab](https://docs.datadoghq.com/continuous_integration/pipelines/gitlab.md#collect-job-logs)).
- To enable this feature, you must have the **CI Provider Settings Write** permission in Datadog.

## Enable automatic job retries{% #enable-automatic-job-retries %}

After the prerequisites are met, enable automatic job retries from the CI Visibility repository settings:

1. In Datadog, navigate to **CI Visibility** > **Settings** > [**Repositories**](https://app.datadoghq.com/ci/settings/visibility/repositories).
1. For each repository you'd like to enable automatic job retries for, set the **Auto Job Retries** toggle on. To enable it for all repositories at once, use the **Enable Auto Job Retries for ALL repositories** global toggle.

## Provider-specific behavior{% #provider-specific-behavior %}

{% tab title="GitHub Actions" %}
### GitHub Actions automatic job retries{% #github-actions-automatic-job-retries %}

GitHub Actions imposes two provider-level limitations that shape how retries work:

- **Retries happen after the workflow finishes.** The GitHub API does not allow retrying an individual job while the rest of the workflow is still running. Datadog waits for the workflow to reach a final state before issuing retries.
- **All failed jobs are retried together, even those classified as non-retriable.** The GitHub API does not support retrying a single job when other jobs in the workflow have also failed. Datadog reruns every failed job in the workflow through a single GitHub API call. This may increase your GitHub Actions compute usage.

### Protected branches{% #protected-branches %}

The Datadog GitHub App's default permissions do not allow retries on protected branches. To enable automatic retries on a protected branch (for example, your default branch), grant the app org-wide Maintainer-level access. Review your organization's policies before expanding permissions.
{% /tab %}

{% tab title="GitLab" %}
### GitLab automatic job retries{% #gitlab-automatic-job-retries %}

As soon as a job fails in GitLab, Datadog re-runs that specific job (if it is classified as retriable). Other failed jobs (that aren't classified as retriable) and passing jobs aren't affected. There is no additional CI cost beyond the retried job(s).

Automatic job retries works for both SaaS (GitLab.com) and self-hosted GitLab instances.
{% /tab %}

## When is a failed job not retried?{% #when-is-a-failed-job-not-retried %}

A failed job is not retried when:

- The AI classifier categorizes the failure as non-retriable (for example, compilation errors or asserted test failures).
- The job has already been retried manually or by provider-native retry rules.

**Note:** On GitHub Actions, non-retriable failed jobs may still be re-run if another job in the same workflow is classified as retriable. Datadog issues a single "rerun failed jobs" GitHub API call, which re-runs every failed job in the workflow—including non-retriable ones.

## Further reading{% #further-reading %}

- [Explore Pipeline Execution Results and Performance](https://docs.datadoghq.com/continuous_integration/pipelines.md)
- [Set up CI Visibility for GitHub Actions](https://docs.datadoghq.com/continuous_integration/pipelines/github.md)
- [Set up CI Visibility for GitLab](https://docs.datadoghq.com/continuous_integration/pipelines/gitlab.md)
- [Troubleshooting CI Visibility](https://docs.datadoghq.com/continuous_integration/troubleshooting.md)