Поделиться через

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

  • Статья

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 или NavigationPropertyBinding Path с использованием значений EntitySet. Каждое 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(

Начало filter() предложения.

CompletedDate ge {startdate}

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

)

Закрыть filter() клаузулу.

/groupby(

Начать 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, переименование запроса.

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

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

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

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

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

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

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

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

В редакторе Power Query выберите TotalCount столбец, затем выберите Тип данных в меню Преобразование и выберите Целое число. Дополнительные сведения об изменении типа данных см. в разделе Преобразование данных аналитики для создания отчетов 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 в Поле.
      Снимок экрана области

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

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

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

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