GitHub

Overview

Capture GitHub commits in Datadog to:

• Track new features from code changes
• Identify when new code changes lead to system alerts or build failures
• Discuss code changes with your team in the Datadog Event Stream

Setup

Installation

GitHub

1. Navigate to the Settings page of your GitHub project.

2. Select the Webhooks entry in the left navigation menu.

3. Click on the the Add Webhook button.

4. Add this URL in the Payload URL field. Don’t forget to replace <DATADOG_API_KEY> with your Datadog API Key:

   https://app.datadoghq.com/intake/webhook/github?api_key=<DATADOG_API_KEY>
   

5. Set the Content Type to application/json.

6. In the Which events would you like to trigger this webhook? you can choose what you want to send to Datadog with the Let me select individual events. option. The Datadog-GitHub integration supports:

   • Push (new commits)
   • Create and delete (for tags)
   • Pull requests
   • Issues
   • Issues comment
   • Commit comment
   • Pull request review comment
   • Installation
   • Membership
   • Public
   • Security advisory
   • Team add

Datadog

1. Install the Datadog GitHub integration.

2. For each repository, add the branches you wish to monitor. If you want to add all repositories for a user or organization, use wildcards. For example, to gather all events related to the master branch of the DataDog/Documentation repository:

   If you wanted to gather all events related to all master branches from the DataDog organization:

   It is also possible to use wildcards on branches, for example dev-* includes all branches starting with dev-.

Data Collected

Once the integration is complete, the selected events display in your Datadog Event Stream. From the dashboard, type sources:github in the top-left search bar to see GitHub events overlaid on the graphs on that dashboard.

Troubleshooting

Need help? Contact Datadog support.