Azure パイプラインでトレースを設定する

Docs > Continuous Integration Visibility > Datadog の CI Pipeline Visibility > Azure パイプラインでトレースを設定する

Azure DevOps Server is not officially supported.

Overview

Azure Pipelines is a continuous integration and delivery service that supports any language, platform, or cloud.

Set up tracing on Azure Pipelines to gain real time insights into your CI/CD workflows, track pipeline performance, analyze inefficiencies, and manage your deployment operations.

Compatibility

Pipeline Visibility	Platform	Definition
Custom tags and measures at runtime	Custom tags and measures at runtime	Configure custom tags and measures at runtime.
Custom spans	Custom spans	Configure custom spans for your pipelines.

Configure the Datadog integration

The Datadog integration for Azure Pipelines works by using service hooks to send data to Datadog.

Install the Datadog CI Visibility extension from the Azure Marketplace. There are several extensions starting with Datadog, make sure that you are installing the Datadog CI Visibility extension.
For each project, go to Project settings > Service hooks in Azure DevOps and select the green plus (+) icon to create a subscription.
Create a new subscription to the Datadog CI Visibility service for each of the following webhook types:
- Run state changed
- Run stage state changed
- Run job state changed
- Run stage approval completed
- Run stage waiting for approval
Click Next to continue to the next step and set the following:
- Datadog Site:
- Datadog API Key: your Datadog API key.
Click Finish.

All 5 supported types of events are required and must be enabled individually. Not enabling one or more events results in an an incomplete installation, leading to unexpected behavior in Datadog.

複数プロジェクトの一括構成

If you want to enable the hooks for many or all your Azure projects, Datadog provides a script to help you do it through the Azure API.

スクリプトを実行するには、以下が必要です。

Azure DevOps のユーザー名
An Azure DevOps API Token
Azure DevOps の組織名

The script only needs python3 and the requests package. For more information, run:

./service_hooks.py --help

このスクリプトは環境変数 DD_API_KEY と DD_SITE、フラグパラメーター --dd-api-key と --dd-site をサポートします。

すべてのプロジェクトでフックを有効にする場合の例:

./service_hooks.py \
    --dd-api-key ******************** \
    --az-user "John Doe" \
    --az-token ********************** \
    --az-org datadoghq \
    --threads 4

指定したプロジェクトでフックを有効にする場合の例:

./service_hooks.py \
    --dd-api-key ******************** \
    --az-user "John Doe" \
    --az-token ********************** \
    --az-org datadoghq \
    projectName1 projectName2

ジョブログ収集を有効にする

Azure Log Collection is in private beta. To request access, fill out this form.

Note: Job log collection is not available for PCI-compliant organizations.

Datadog supports log collection for your Azure DevOps pipelines. To enable it:

Install a Datadog app registration on your Azure console. Follow the steps within the Azure integration.
Add the Datadog app registration to your Azure DevOps organization and to every project for which you want to enable Log Collection. You can do this by going to “Organization settings” in your DevOps console. You may select “Add to all projects” to configure all projects in bulk.

Note: Logs are billed separately from CI Visibility. Log retention, exclusion, and indexes are configured in Logs Settings. Logs for Azure jobs can be identified by the datadog.product:cipipeline and source:azurepipelines tags.