Supported OS Linux Windows Mac OS



This integration collects and reports GitHub metrics to Datadog through different endpoints in the GitHub API. The following varieties of metrics are submitted:

  • Organization/Enterprise Stats
  • Repository Metrics
  • Self-hosted and Installed Runners
  • GitHub Workflow Monitoring


This integration provides an out-of-the-box dashboard called RapDev GitHub Dashboard. This dashboard populates as data is submitted to Datadog over time and includes environment variables to further narrow down a search on a specific repo or author.


sudo -u dd-agent datadog-agent integration install --third-party datadog-rapdev_github==1.0.0


"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" integration install --third-party datadog-rapdev_github==1.0.0

1. In GitHub, navigate to the [Developer Settings Page]( If prompted, login and navigate to **Settings** > **Developer Settings** > **Github Apps**. 

2. Click **New GitHub App** and set the following fields accordingly:
    - Set `GitHub App Name` to a name of your choice.
    - `Homepage URL` to ``.
    - Uncheck `Active` under `Webhook`.

3. Under the **Permissions** section, set the following permissions:
    - <b>Repository Permissions:</b> set `Actions`, `Issues`, `Metadata`, and `Pull Requests`, to `Read Only`.
    - <b>Organization Permissions:</b> set `Administration`, `Members`, and `Self-hosted Runners` to `Read Only`.

4. Finally, set `Where can this GitHub App be installed?` to `Any account` and click **Create GitHub App**. Once created, GitHub should redirect you to the App settings. Save the App ID in a secure place as this is used in the configuration file.

5. Scroll down to the `Private Keys` section and click **Generate a private key**. It should automatically save the `.pem` file. If you'd like, you can move this to somewhere more secure.

6. Click `Install App` on the left hand side and select `Install` for the organization you'd like to monitor. Ensure `All Repositories` is selected and select `Install`. Repeat this step for any additional organizations you'd like to monitor.

    This should redirect you to the App installation on your org. Within the web address bar, save the 8-digit number at the end of the URL to a secure location.

7. Find where the `conf.d/rapdev_github.d/conf.yaml.example` [configuration file]( is located, remove the `.example` from the file name, and open the file to set the following:
    - `user`: The name of the authenticated user.
    - `org`: The name of your organization or enterprise.
    - `github_mode`: Either `organization` or `enterprise`, depending on which you are on.
    - `key_path`: The path to your `.pem` file that was generated in Step 9.
    - `org_app_id`: The 8-digit ID that was on the end of the URL from Step 13.
    - `gh_app_id`: The 6-digit App ID generated in Step 8.
    - `repo_list`: A list of repositories on your organization or enterprise that the integration should look at. If this is left blank, it goes through all repos (<b>Note</b>: This may increase time between updates by approximately one minute for every 40 repos).

8. Once configured, [start the Datadog Agent]( and begin using the integration.

## Support
For support or feature requests, contact through the following channels:
- Support:
- Sales:
- Chat: [](
- Phone: 855-857-0222

Made with ❤️ in Boston
*This isn't the integration you're looking for? Missing a critical feature for your organization? Drop RapDev a 
[note](, and we'll build it!!*

This application is made available through the Marketplace and is supported by a Datadog Technology Partner. <a href="" target="_blank">Click Here</a> to purchase this application.