Skip to main content

Configure Sources of Change

Last updated on

Configure your CI/CD tools to send build and deployment data to the Deploy Change Investigator for incident correlation.

Overview​

The Deploy Change Investigator requires two types of webhooks from your CI/CD pipeline:

  1. Build webhooks - Send artifact versions and commit information when builds complete
  2. Deploy webhooks - Track when services are deployed to which environments

This section provides configuration guides for popular CI/CD tools and change tracking systems.

Before you begin​

Complete the Deploy Change Investigator setup:

  • Create build webhook integration in AI SRE. Go to Deploy Change Investigator to set up the webhook endpoints.
  • Copy the build and deploy webhook URLs from your integrations.
  • Configure your source control connector (GitHub or Bitbucket) for PR ingestion.

Available integration guides​

CI/CD tools​

  • Harness Pipelines: Native integration with Harness build and deployment pipelines.
  • Jenkins: Configure Jenkins pipelines to send build and deploy webhooks.
  • GitHub Actions: Add webhook steps to GitHub Actions workflows.
  • GitLab CI: Configure GitLab CI/CD pipelines with webhook notifications.
  • CircleCI: Send build and deploy data from CircleCI workflows.

Change tracking systems​

  • Jira: Track Jira issue deployments and releases.
  • Terraform: Send Terraform apply events as deployment data.

Webhook payload requirements​

Build webhook payload​

{
  "artifact": {
    "name": "registry.example.com/myapp",
    "version": "1.2.3"
  },
  "source": {
    "commitSha": "abc123...",
    "kind": "branch",
    "value": "main",
    "repository_url": "https://github.com/org/repo"
  },
  "service": {
    "name": "myapp",
    "version": "1.2.3"
  },
  "buildId": "unique-build-id"
}

Deploy webhook payload​

{
  "services": [
    {
      "service": "myapp",
      "version": "1.2.3"
    }
  ],
  "environments": ["production"],
  "changeId": "unique-deploy-id",
  "status": "SUCCESS",
  "deployedBy": "user@example.com",
  "deployTimestamp": "2025-01-01T12:00:00Z"
}

Critical requirement: The service name and version in deploy webhooks must match the corresponding fields from build webhooks.

Testing webhooks​

After configuration, verify webhooks are being received:

  1. Navigate to AI SRE → Integrations
  2. Click the three-dot menu (...) on your BUILD or DEPLOY integration
  3. Select Debug
  4. Trigger a build or deployment
  5. Verify the webhook appears with correct payload data

Next steps​