GitHub

1. In GitHub, navigate to the [Developer Settings Page](https://github.com/settings/apps). 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 `http://127.0.0.1`.
    - 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](https://docs.datadoghq.com/agent/guide/agent-configuration-files/?tab=agentv6v7#agent-configuration-directory) 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](https://docs.datadoghq.com/agent/guide/agent-commands/?tab=agentv6v7) and begin using the integration.

## Support
For support or feature requests, contact RapDev.io through the following channels:
- Support: support@rapdev.io
- Sales: sales@rapdev.io
- Chat: [rapdev.io](https://www.rapdev.io/#Get-in-touch)
- 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](mailto:support@rapdev.io), and we'll build it!!*

---
This application is made available through the Marketplace and is supported by a Datadog Technology Partner. <a href="https://app.datadoghq.com/marketplace/app/rapdev-github" target="_blank">Click Here</a> to purchase this application.