Getting Started with CI Visibility

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Overview

CI Visibility, or CI Pipeline Visibility, allows you to monitor the health of your CI pipelines and visualize the performance of your pipeline executions as traces, where spans represent the different levels of the pipeline.

A list view of your CI pipelines in Datadog CI Visibility

You can forward CI job logs and automatically correlate them with your pipelines in CI Visibility. Depending on the providers you are using, you can either enable job log collection on the Settings page in CI Visibility or in your provider’s settings to integrate with Datadog.

You can also use the datadog-ci CLI to trace commands in your pipelines, as well as the custom tags and measures commands to add user-defined text and numerical tags in your pipeline traces.

CI Visibility provides DevOps and platform engineering organizations with comprehensive monitoring, analytics, and the ability to pinpoint and resolve bottlenecks, optimize resource allocation, and decrease CI costs.

By integrating performance metrics, logs, and alerts, organizations can improve development speed, increase the reliability of their pipelines, and make data-informed decisions across cloud and self-hosted environments.

Set up your CI provider

CI Visibility tracks the performance and results of your CI pipelines, and displays results after the pipeline finishes.

To start sending pipeline metrics, see the documentation for one of the following CI providers that Datadog supports below.

aws codepipeline
azure devops extension
buildkite

circleci orb
codefresh
github actions

gitlab
jenkins
teamcity


If your CI provider is not supported, you can programmatically send your pipeline events to Datadog. See the Send pipeline events to Datadog section.

Depending on the CI provider(s) of choice, CI Visibility may not support all of the levels in your pipeline (stage, job, step, or command). For more information about how CI Visibility defines a CI pipeline, see the Terminology section.

Use CI pipeline data

Access your pipelines’ metrics (such as queue times, durations, percentiles, and statuses) to start identifying important trends and patterns using the data collected across your CI providers.

An out-of-the-box dashboard with widgets displaying data collected from your pipelines, jobs, and stages in CI Visibility

You can create dashboards to visualize at which points failures are happening in your pipelines, or use an out-of-the-box dashboard containing widgets populated with data collected in CI Visibility to visualize the health and performance of your CI pipelines, stages, and jobs.

Search and manage your CI pipelines

The CI Pipeline List page provides a comprehensive view of the performance and reliability of your CI pipelines, for the default branch. Access aggregated statistics, trends, and information about your pipelines to identify and resolve issues like failures and regressions.

To enhance troubleshooting and streamline your pipeline management processes, click on a pipeline to access insights, review execution histories, and pivot to logs and related telemetry data. For more information, see Search and Manage CI Pipelines.

Examine results in the CI Visibility Explorer

The CI Visibility Explorer allows you to create visualizations and filter pipeline spans using the data collected from your CI providers. Each pipeline execution is reported as a trace, which includes stage and job information.

Navigate to Software Delivery > CI Visibility > Executions and select Pipeline to start filtering your pipeline span results.

Pipeline execution results in the CI Visibility Explorer filtered on the Shopist repository

Navigate to Software Delivery > CI Visibility > Executions and select Stage to start filtering your stage span results.

Stage results in the CI Visibility Explorer filtered on the Shopist repository

Navigate to Software Delivery > CI Visibility > Executions and select Job to start filtering your job span results.

Job results in the CI Visibility Explorer filtered on the Shopist repository

Navigate to Software Delivery > CI Visibility > Executions and select Step to start filtering your step span results.

Step results in the CI Visibility Explorer filtered on the Shopist repository

Use facets to customize the search query and identify changes in time spent on each level of your pipeline.

Once you click into a pipeline, you can access individual pipeline executions listed in the Pipeline Executions section. When you click on a pipeline execution, you can see a flame graph or a list of spans in the Trace tab.

Pipeline execution results visualized as a flame graph for the Staging Build and Test pipeline

You can identify bottlenecks in your pipeline and examine individual nodes ranked from the largest to smallest percentage of execution time.

After you have set up Test Visibility, you can access information about tests that were run in your CI pipelines, including the test status (Failed, New Flaky, Passed, or Skipped), on the Test Runs tab in a pipeline execution’s side panel. For more information, see the Flaky Test Management documentation.

You can access pipeline or job logs across cloud and self-hosted runners and see information about your runners on the Logs tab in a pipeline execution’s side panel.

If you are using supported providers, you can correlate infrastructure metrics with your GitLab jobs and access the GitLab job’s host, system, host tags, and host metrics information. For more information, see Correlate Infrastructure Metrics with GitLab Jobs in Datadog.

Send pipeline events to Datadog

For other pipeline providers and custom pipelines, you can programmatically send pipeline events to Datadog using the CI Visibility Pipelines API. For more information, see Pipeline Data Model and Execution Types.

Provide the following Git information (the repository URL, commit SHA, and the author email) of the commit that triggered the pipeline execution in the request.

Create a CI pipeline monitor

Alert relevant teams in your organization about pipeline health and performance regressions when failures occur or duration thresholds are exceeded in your CI pipelines with CI monitors.

A CI pipeline monitor configured to trigger an alert when the average duration for the Test and Deploy Cart pipeline exceeds five minutes in the past day

To set up a monitor that alerts on your CI pipeline when the average duration in the past day exceeds a five minute threshold:

  1. Navigate to Monitors > New Monitor and select CI.
  2. Select a common monitor type for CI pipelines to get started, for example: Long Running Pipeline to trigger alerts when a pipeline has been running for too long or Failed Job to trigger alerts for job failures, or customize your own search query. In this example, enter @ci.pipeline.name:test_and_deploy_cart and select the Avg of Duration (@duration).
  3. In the Evaluate the query over the section, select last 1 day.
  4. Set the alert conditions to trigger when the evaluated value is above the threshold, and specify values for the alert or warning thresholds, such as Alert threshold > 300000000000.
  5. In the Configure notifications and automations section, configure your monitor’s notification settings.
  6. Set permissions for the monitor.
  7. Click Create.

Further Reading