https://github.com/datadog/ci-visibility-azure-pipelines
Quickly connect your Azure Pipelines to Datadog to gain comprehensive visibility into the performance of your pipelines, stages, and jobs
https://github.com/datadog/ci-visibility-azure-pipelines
azure azure-devops azure-pipelines ci-visibility datadog
Last synced: about 11 hours ago
JSON representation
Quickly connect your Azure Pipelines to Datadog to gain comprehensive visibility into the performance of your pipelines, stages, and jobs
- Host: GitHub
- URL: https://github.com/datadog/ci-visibility-azure-pipelines
- Owner: DataDog
- License: apache-2.0
- Created: 2023-04-19T15:25:13.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-03T10:33:16.000Z (about 2 months ago)
- Last Synced: 2025-04-18T12:17:44.491Z (6 days ago)
- Topics: azure, azure-devops, azure-pipelines, ci-visibility, datadog
- Language: Python
- Homepage: https://www.datadoghq.com/product/ci-cd-monitoring/
- Size: 1.48 MB
- Stars: 3
- Watchers: 258
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Datadog CI Visibility Azure Pipelines Extension
[](https://opensource.org/licenses/Apache-2.0)
## Overview
With this extension for [Datadog CI Visibility](https://www.datadoghq.com/product/ci-cd-monitoring/#pipeline-visibility), you can more quickly connect your Azure Pipelines to Datadog to gain comprehensive visibility into the performance of your pipelines, stages, and jobs.
## How it works
**What you'll need from Datadog**
- API Key: Your Datadog API key. This key is created by your [Datadog organization](https://docs.datadoghq.com/account_management/api-app-keys/).
- Datadog site: Which [Datadog site](https://docs.datadoghq.com/getting_started/site/) to connect and send data to.
**Setting up the integration**
Install this Datadog CI Visibility for Azure Pipelines extension in your Azure organization. This will install a [webhook consumer](https://learn.microsoft.com/en-us/azure/devops/extend/develop/add-service-hook?view=azure-devops).
After the extension is installed, you can use it from the [Service hooks](https://learn.microsoft.com/en-us/azure/devops/service-hooks/overview?view=azure-devops) section within your Project Settings in Azure Pipelines.
**All 3 supported types of events are required** and must be enabled individually. If one or more events are not enabled, the installation will be incomplete and lead to unexpected behavior in Datadog. The events are:
- run state changed
- run stage state changed
- run job state changed
## Enabling multiple projects in bulk
If you want to enable the hooks for many or all your Azure projects we provide a [script](https://raw.githubusercontent.com/DataDog/ci-visibility-azure-pipelines/main/service_hooks.py) to help you do it through the Azure API. For this you'll need:
- Azure DevOps username
- Azure DevOps [API Token](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=Windows#create-a-pat)
- Azure DevOps organization name
The script only needs python3 and the requests package. For more info:
```
service_hooks.py --help
```
Example to enable for all the projects:
```
./service_hooks.py \
--dd-api-key ******************** \
--az-user "John Doe" \
--az-token ********************** \
--az-org datadoghq \
--threads 4
```
Example to enable only in a couple of projects:
```
./service_hooks.py \
--dd-api-key ******************** \
--az-user "John Doe" \
--az-token ********************** \
--az-org datadoghq \
projectName1 projectName2
```
## Other resources
- [Datadog documentation](https://docs.datadoghq.com/continuous_integration/pipelines/azure/)
- [What is Datadog CI Visibility?](https://www.datadoghq.com/blog/datadog-ci-visibility/)
- [Extension in the Azure Marketplace](https://marketplace.visualstudio.com/items?itemName=Datadog.ci-visibility)