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

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

Скопируйте и вставьте следующий запрос 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

Запрос OData

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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?%20
$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
))

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

Замените следующие строки значениями. Не включайте скобки в подстановку {} . Например, если вашей организации присвоено имя 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 Query

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

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

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

   

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

   

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

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

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

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

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

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

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

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

   

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

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

   • SucceededCount
   • FailedCount
   • CanceledCount
   • PartiallySucceededCount.

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

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

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

     

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

Связанные статьи

• Создание запросов OData для аналитики
• Справочник по метаданным для Azure Pipelines
• Примеры отчетов и краткий справочный индекс