Сводка результатов конвейера для всех примеров отчетов конвейеров

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Сведения, приведенные в этой статье, можно использовать для запроса метрик конвейера, таких как скорость передачи, количество сбоев, длительность и т. д. для всех конвейеров и создание единого отчета. Дополнительные запросы предоставляются для получения других метрик, таких как длительность конвейера и количество сбоев для всех конвейеров проекта.

На следующем рисунке показана сводка результатов для всех конвейеров, определенных для проекта с сентября 2022 года.

Снимок экрана: сводный отчет о результатах всех конвейеров.

Как показано на следующем рисунке, можно выбрать любой конвейер из раскрывающегося меню "Имя конвейера", а отчет изменится на сводку результатов выбранного конвейера.

Снимок экрана: отчет, в котором показана сводка результатов только для выбранного конвейера.

Внимание

Интеграция Power BI и доступ к веб-каналуOData службы Аналитики общедоступны для Azure DevOps Services и Azure DevOps Server 2020 и более поздних версий. Примеры запросов, указанные в этой статье, допустимы только для Azure DevOps Server 2020 и более поздних версий, и зависят от версии 3.0-preview или более поздней версии. Мы рекомендуем вам использовать эти запросы и предоставлять нам отзывы.

Необходимые компоненты

  • Чтобы просмотреть данные аналитики и запросить службу, необходимо быть членом проекта с базовым доступом или большим доступом. По умолчанию все члены проекта предоставляют разрешения для запроса аналитики и определения представлений Аналитики.
  • Дополнительные сведения о других предварительных требованиях для включения служб и функций и общих действий по отслеживанию данных см. в статье "Разрешения и предварительные требования для доступа к аналитике".

Примечание.

В этой статье предполагается, что вы прочитали обзор примеров отчетов с помощью запросов OData и имеют базовое представление о Power BI.

Примеры запросов

Вы можете использовать следующие запросы набора сущностей для создания различных, но аналогичных отчетов о результатах PipelineRuns конвейера.

Примечание.

Сведения о доступных свойствах для фильтрации или отчета см . в справочнике по метаданным для Azure Pipelines. Вы можете отфильтровать запросы или возвращать свойства с помощью любого из Property значенийEntityType, доступных в разделе EntitySetили NavigationPropertyBinding Path значениях. Каждое EntitySet соответствует .EntityType Чтобы узнать больше о типе данных каждого значения, просмотрите метаданные, предоставленные для соответствующего EntityTypeзначения.

Запрос Power BI, указанный ниже, можно вставить непосредственно в окно получения пустого запроса.> Дополнительные сведения см. в обзоре примеров отчетов с помощью запросов OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
               &"$apply=filter( "
	       &"CompletedDate ge {startdate} "
	       &")"
                &"/groupby( "
        &"(Pipeline/PipelineName), "
        &"aggregate( "
            &"$count as TotalCount, "
                &"SucceededCount with sum as SucceededCount, "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount, "
                &"CanceledCount with sum as CanceledCount "
            &")) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Строки подстановки и разбивка запросов

Замените следующие строки значениями. Не включайте скобки в подстановку {} . Например, если вашей организации присвоено имя Fabrikam, замените {organization} на Fabrikam, а не {Fabrikam}.

  • {organization} — Название организации
  • {project} — Имя проекта группы
  • {startdate} — Дата начала отчета. Формат: ГГГГ-ММ-ДДЗ. Пример: 2022-09-01Z представляет 1 сентября 2022 г. Не заключайте в кавычки или скобки и используйте две цифры как для месяца, так и для даты.

Разбивка запросов

В следующей таблице описана каждая часть запроса.

Часть запроса

Description

$apply=filter(

Предложение Start filter() .

CompletedDate ge {startdate}

Возвращаемый конвейер выполняется для даты больше указанной даты.

)

Закрыть filter() предложение.

/groupby(

Предложение Start groupby() /

(Pipeline/PipelineName),

Группировать результаты данных по имени конвейера.

aggregate(

Предложение start aggregate для каждого конвейера.

$count as TotalCount,

Подсчитывать общее число запусков в качестве TotalCount.

SucceededCount with sum as SucceededCount.

Подсчитывать число успешных запусков в качестве SucceededCount.

FailedCount with sum as FailedCount,

Подсчитывать количество неудачных запусков в качестве FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount,

Подсчитывать число частично успешных запусков в качестве PartiallySucceededCount.

CanceledCount with sum as CanceledCount

Подсчитывать число отмененных запусков как CanceledCount.

))

Закройте aggregate() и groupby() предложения.

(Необязательно) Переименование запроса

Вы можете переименовать метку запроса по умолчанию, query1, в что-то более понятное. Просто введите новое имя из области Параметры запроса.

Снимок экрана: параметры меню запроса Power BI, переименование запроса.

Развертывание столбца конвейера в Редактор Power Query

Перед созданием отчета разверните Pipeline столбец, который возвращает записи, которые могут содержать одно или несколько полей.

  1. Закройте Расширенный редактор.

  2. В Редактор Power Query нажмите Pipeline кнопку "Развернуть столбец", убедитесь, что PipelineName выбрано, а затем нажмите кнопку "ОК".

    Снимок экрана: меню развертывания столбца Pipelines.

    Теперь таблица содержит развернутую сущность Pipeline.PipelineName.

    Снимок экрана: столбец Pipeline.PipelineName.

Изменение типа данных столбца

В Редактор Power Query выберите TotalCount столбец, а затем в меню "Преобразование" выберите типданных и выберите Кто le Number. Дополнительные сведения об изменении типа данных см. в статье "Преобразование аналитических данных" для создания отчетов Power BI, преобразования типа данных столбца.

(Необязательно) Переименование полей столбцов

Можно переименовать поля столбцов. Например, можно переименовать столбец Pipeline.PipelineName в Pipeline Name,или TotalCount в Total Count. Сведения о том, как это сделать, см. в разделе "Переименовать поля столбцов".

Закройте запрос и примените изменения

Завершив все преобразования данных, нажмите кнопку "Закрыть" и "Применить " из меню "Главная ", чтобы сохранить запрос и вернуться на вкладку "Отчет " в Power BI.

Снимок экрана: параметр Редактор Power Query Закрыть и применить.

Создание отчета диаграммы с накоплением

  1. В Power BI в разделе "Визуализации" выберите отчет "Диаграмма с накоплением".

    Снимок экрана: выбор полей визуализации для всех отчетов о выполнении конвейера.

  2. Добавьте Pipeline.PipelineName или переименованный столбец Pipeline Name в Ось.

  3. Добавьте следующие поля в указанный порядок значений и щелкните правой кнопкой мыши каждое поле и убедитесь, что выбрана сумма .

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount.

  4. Чтобы добавить срез в отчет, отключите отчет и выберите срез в области "Визуализации ".

    • Добавьте Pipeline.PipelineName или переименуйте столбец Pipeline Name в Поле.
      Снимок экрана: область

    • Чтобы изменить срез из списка в раскрывающемся меню, выберите значок "Формат визуальной кисти" на панели "Визуализации " и выберите пункт раскрывающегося списка вместо списка.

      Снимок экрана: область визуализаций, срез, параметры параметров, выбранный раскрывающийся список.

Отчет отображается следующим образом.

Снимок экрана: пример сводного отчета о результатах всех конвейеров.