Skip to main content

GitHub Integration

Overview​

Connect GitHub to enable the Git AI Agent, which correlates code changes with infrastructure incidents during investigations and chat sessions.

What It Enables​

  • View recent commits and pull requests
  • Correlate deployments with incident timelines
  • Identify code or configuration changes that caused issues
  • Browse file contents and blame information

Setup​

1. Start Integration​

  1. In the OpsWorker portal, go to Integrations
  2. Find GitHub and click Connect

2. Authorize via OAuth​

  1. You'll be redirected to GitHub for OAuth authorization
  2. Select the GitHub organization or account to connect
  3. Choose which repositories to grant access to (all or selected)
  4. Authorize the OpsWorker application

3. Configure for Cluster​

  1. Return to the OpsWorker portal
  2. Associate the GitHub integration with your cluster(s)

Permissions​

OpsWorker requests read-only access to repositories:

PermissionPurpose
Read repository contentsView files, commits, branches
Read pull requestsView PRs and their changes
Read commit historyCorrelate changes with incidents

OpsWorker does not request write access to your repositories.

Use Cases​

  • Investigation enrichment: When a pod crashes after a deployment, the Git Agent identifies the relevant commit
  • Change correlation in chat: "What PRs were merged in the last 24 hours?"
  • Configuration drift: Compare running config with repository definitions

Next Steps​