Configure Software Delivery
To start monitoring your pipelines with SolarWinds Observability SaaS, connect a CI/CD provider. This integration is agentless: nothing needs to be installed in your build infrastructure.
Before you begin
Before connecting your CI/CD provider, ensure you meet the following requirements:
GitHub permissions:
-
Installing the SolarWinds Observability GitHub App requires Organization Owner privileges or Repository Admin permissions for individual repositories. If you do not have administrative access, you can initiate the request in SolarWinds Observability SaaS for an owner to approve in GitHub. See Requesting a GitHub App from your organization owner.
-
The SolarWinds Observability GitHub App requires repository-level access only. It does not request account or organization administrative control:
-
Read and write: Actions, Contents, Issues, Pull requests, and Workflows.
-
Read only: Metadata, Security events, and Dependabot alerts.
-
Webhook events: workflow runs, workflow jobs, workflow dispatch, pull requests, pull request reviews and review comments, code scanning alerts, and Dependabot alerts.
-
Domain support: Repositories must be hosted on github.com. GitHub Enterprise Server is not supported.
Container image tracking: To correlate pipeline runs with Kubernetes deployments, container images must be built using Docker Buildx / BuildKit so that image digests are output to build logs.
Kubernetes monitoring: To see deployment annotations and pipeline links on the Events > Deployments page, the target Kubernetes cluster must be monitored by SolarWinds Observability SaaS.
Connect GitHub
To connect your GitHub account to SolarWinds Observability SaaS to start monitoring your pipelines, use the dedicated SolarWinds Observability GitHub Application. You can manage your existing GitHub integrations in SolarWinds Observability SaaS Settings.
-
In SolarWinds Observability SaaS, click Add Data at the top.
-
Click Software Delivery > GitHub > Connect to GitHub.
GitHub opens in a new browser tab.
-
In GitHub, select the organization or account you want to install the app into.
-
Select if you want to grant access to All repositories or Only selected repositories, and click Install & Authorize.
-
Return to the SolarWinds Observability SaaS browser tab.
The wizard monitors for the new connection (displaying Waiting for connection) and checks for up to three minutes:
-
When detected, the wizard lists the connected repositories and displays a message: New GitHub installation detected! Your repositories are now connected.
-
If not detected within three minutes, the wizard displays: We didn’t detect a new GitHub installation. If you finished installing the app, check Settings > GitHub > Integrations. Otherwise, click Connect to GitHub to try again.
-
Optional: Click Skip verification to close the wizard immediately. The connection completes in GitHub, and pipelines appear as soon as GitHub emits workflow events.
-
-
Click Close.
Past workflow runs are not imported. A pipeline entity is created when its workflow runs for the first time after the connection is established.
Connections and organizations
One-to-one mapping: Each GitHub organization or personal account can connect to exactly one SolarWinds Observability SaaS organization within a tier. The first SolarWinds Observability organization that claims the connection receives its data.
Multiple GitHub organizations: One SolarWinds Observability organization can collect data from multiple GitHub organizations. Repeat the connection procedure for each GitHub organization.
Manage GitHub connections
Existing GitHub connections are listed in SolarWinds Observability SaaS in Settings > GitHub > Integrations, with one entry per connected GitHub organization or account.
-
Pending connections: An entry marked Pending has no connected repositories yet (for example, an installation request awaiting approval from a GitHub organization owner). Pending entries do not have a Delete option.
-
View repositories: Expand an organization entry to view connected repositories, with direct links to GitHub.
-
Change repository access: Click Manage GitHub to adjust which repositories the app can access.
Remove GitHub connections
You can remove a GitHub connection in either of the following ways:
Uninstall the app in GitHub
-
In GitHub, navigate to Settings > GitHub Apps.
-
Locate the SolarWinds Observability app and click Uninstall.
SolarWinds Observability SaaS is notified immediately, removes the connection and its repositories, and stops receiving data. Repositories removed from the app's access in GitHub are removed the same way.
Delete the integration in SolarWinds Observability SaaS
-
In SolarWinds Observability SaaS, click Settings > GitHub > Integrations.
-
Open the entry menu and click Delete.
This removes the connection entry from SolarWinds Observability SaaS. You must still uninstall the app in GitHub. Otherwise, GitHub continues sending webhook events that are no longer processed.
Previously collected pipelines and run telemetry remain in SolarWinds Observability SaaS until they reach standard retention limits.