Skip to main content

Runbook Integrations Overview

Last updated on

Harness AI SRE runbooks can integrate with third-party tools to automate incident response workflows.

Most integrations on this page provide automation: they let a runbook act on an external tool during a response. The exception is xMatters, which is on-call schedule sync only and runs no runbook actions. Several of these tools also ingest data elsewhere in AI SRE. Go to Set Up Integration Management to review the full capability matrix.

Available integrations​

Collaboration tools​

  • Slack: Send messages, create channels, manage incident communication
  • Microsoft Teams: Post messages, create teams, coordinate response
  • Google Chat: Send messages to spaces and threads
  • Zoom: Create meetings, generate conference bridges

Incident management & on-call​

  • PagerDuty: Create incidents, trigger escalations, manage on-call
  • OpsGenie: Create alerts, page teams, acknowledge incidents
  • xMatters: On-call synchronization only (no runbook actions)

Ticketing & documentation​

  • Jira: Create issues, add comments, track incident work
  • ServiceNow: Create incidents, update records, manage ITSM workflows
  • Confluence: Create pages, update documentation, maintain knowledge base

Source control​

  • GitHub: Create branches, pull requests, issues
  • Harness Pipelines: Trigger deployment pipelines, execute automation

These connectors ensure that actions performed by your runbooks are properly attributed to specific service accounts.

note

Project-level connectors provide better accountability and access control compared to organization-level connectors.

Why project connectors?​

When executing runbook actions that interact with external tools (Zoom, GitHub, Jira), Harness AI SRE needs to authenticate as a specific user or service account. Project connectors ensure:

  • Actions are performed using dedicated service accounts
  • Activities can be properly tracked and audited
  • Access permissions are scoped to project needs
  • Integration credentials are managed at the project level

Accessing project connectors​

To configure project connectors:

  1. Sign in to your Harness account
  2. Go to your project
  3. Go to Project Settings, then Third-Party Integrations (AI SRE)
  4. Select the integration type you want to configure

Configuring project connectors​

Best practices​

When setting up project connectors:

  1. Create dedicated service accounts for runbook actions
  2. Use project-specific service accounts rather than shared accounts
  3. Document the purpose and ownership of each connector

Selecting or creating connectors​

In Project Settings, then Third-Party Integrations (AI SRE), you can either:

  • Select an existing connector from the list if one is already configured with appropriate permissions
  • Create a new connector if you need a dedicated service account for your project's runbook actions

Creating new connectors​

Only follow these steps if you need to create a new connector. If an appropriate connector already exists, you can select it from the list.

Zoom connector​

If you need a new Zoom connector:

  1. Click Add Zoom Connector
  2. Configure:
    • Name: A descriptive name for the service account's purpose
    • Authentication: OAuth (recommended)
    • Service Account: Dedicated Zoom account for runbook actions
  3. Test the connection
  4. Save the configuration

GitHub connector​

If you need a new GitHub connector:

  1. Click Add GitHub Connector
  2. Configure:
    • Name: A descriptive name for the service account's purpose
    • Authentication: GitHub App or OAuth
    • Repository Access: Only repositories needed for runbook actions
  3. Test the connection
  4. Save the configuration

Jira connector​

If you need a new Jira connector:

  1. Click Add Jira Connector
  2. Configure:
    • Name: A descriptive name for the service account's purpose
    • Authentication: API Token (recommended)
    • Project Access: Only projects needed for runbook actions
  3. Test the connection
  4. Save the configuration

Using project connectors in runbooks​

When creating runbook actions:

  1. Add an integration action (Create Jira Issue, Schedule Zoom Meeting, etc.)
  2. The project connector you configured will be automatically used
  3. The action will be performed using the service account associated with the connector
tip

Always test runbook actions in a non-production environment to verify proper authentication and permissions.

Next steps​