GitHub App Installation Guide

What type of data does the GitHub app ingest?

The GitHub app collects data from two sources:

  • GitHub webhooks that generate data for action runs and commits.

  • The Observe poller for GitHub that periodically collects metadata about issues, organizations, users, pull requests, releases, and repositories.

The following sections describe how to ingest data, install, and configure the collectors. For more about exploring this data, see GitHub.

Setup

Install the GitHub app for Observe using the App section under Workspace Setting.

GitHub app installation page

Figure 1 - GitHub app card

Webhook Configuration

On GitHub, set up a webhook linked to your GitHub organization. As new activity happens, the webhook pushes data to Observe. Observe ingests data from these GitHub sources:

  • Activity Dashboard

  • Action Run Dataset

  • Commit Dataset

To configure the webhook, navigate to your organization’s home page on GitHub and click Settings.

GitHub home page for an Organization, showing the tabs for Organization management.

Figure 2 - GitHub organization home page

If you don’t see the Settings tab, you may not have administrative permissions for your organization. Contact an organization administrator to confirm your permissions.

  1. On the Settings menu, click on Webhooks.

  2. Click Add webhook. You may need to authenticate to access the webhook configuration page.

  3. Configure the following settings:

    • Payload URL: https://${OBSERVE_TOKEN?}@${OBSERVE_CUSTOMER?}.collect.${OBSERVE_DOMAIN?}/v1/http/github

    • Content type: application/json

    • Select Enable SSL verification

    GitHub app webhook setup page on the GitHub website.

    Figure 3 - GitHub Webhook configuration page

    • Click Add webhook to save your configuration.

    For more about GitHub webhooks, see Creating webhooks in the GitHub documentation.

Configuring the GitHub Poller

Pollers periodically request data from the GitHub API, allowing ingestion of existing details without relying on a triggering event. The poller ingests data from these sources:

  • Administration Dashboard

  • Issues Dataset

  • Organization Dataset

  • Pull Request Dataset

  • Release Dataset

  • Repository Dataset

  • User Dataset

In Observe, configure the GitHub poller to collect and ingest data:

  1. In the GitHub app, go to the Connections tab.

  2. Under Data connection requirements, in the Onboard GitHub poller event section, click Create connection.

  3. In the Create poller dialog, configure the following settings:

    • For GitHub Org, enter the name of your GitHub organization.

    • For GitHub Token, enter a GitHub API token associated with your GitHub account.

    • For GitHub User, enter the userid for an account in your GitHub organization. Observe recommends configuring a unique user for ingestion, with read-only access to the desired teams and repositories.

GitHub poller configuration page on the Observe website.

Figure 4 - GitHub poller configuration page

You have now configured the GitHub app and sent your GitHub data to Observe.