Modelo de dados para o Analytics
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
O modelo de dados do Analytics para DevOps do Azure consiste em conjuntos de entidades, cujos membros (entidades) contêm propriedades que podem ser filtradas, agregadas e resumidas. Além disso, eles contêm propriedades de navegação que relacionam entidades entre si, fornecendo acesso a outras propriedades para seleção, filtragem e agrupamento.
Nota
O serviço Analytics é automaticamente ativado e suportado na produção para todos os Azure DevOps Services. A integração do Power BI e o acesso ao feed OData do serviço Analytics estão geralmente disponíveis. Recomendamos a sua utilização e solicitamos que nos envie os seus comentários.
Os dados disponíveis dependem da versão. A última versão suportada é v2.0, e a versão de pré-visualização mais recente é v4.0-preview. Para obter mais informações, consulte o artigo Controlo de Versões da API OData.
Nota
O serviço Analytics é instalado automaticamente e suportado na produção para todas as novas coleções de projetos para o Azure DevOps Server 2020 e versões posteriores. A integração do Power BI e o acesso ao feed OData do serviço Analytics estão geralmente disponíveis. Recomendamos a sua utilização e solicitamos que nos envie os seus comentários. Se tiver atualizado a partir do Azure DevOps Server 2019, poderá instalar o serviço Analytics durante a atualização.
Os dados disponíveis dependem da versão. A última versão suportada é v2.0, e a versão de pré-visualização mais recente é v4.0-preview. Para obter mais informações, consulte o artigo Controlo de Versões da API OData.
Nota
O serviço Analytics está em pré-visualização para o Azure DevOps Server 2019. Pode ativá-lo ou instalá-lo para uma coleção de projetos. A integração do Power BI e o acesso ao feed OData do serviço Analytics estão em pré-visualização. Recomendamos a sua utilização e solicitamos que nos envie os seus comentários.
Os dados disponíveis dependem da versão. A última versão suportada é v2.0, e a versão de pré-visualização mais recente é v4.0-preview. Para obter mais informações, consulte o artigo Controlo de Versões da API OData.
Namespaces de esquema
O modelo de dados do Google Analytics é baseado em dois namespaces de esquema:
Microsoft.VisualStudio.Services.Analytics.ModelMicrosoft.VisualStudio.Services.Analytics.
Conjuntos de entidades e tipos de entidades
Os tipos de entidade são nomeados tipos estruturados com uma chave. Eles definem as propriedades nomeadas e as relações de cada entidade. A chave de um EntityType é formada a partir de um subconjunto das propriedades primitivas, por exemplo — WorkItemId, PipelineId, ReleasePipelineId — e mais do tipo de entidade.
Os conjuntos de entidades são denominados coleções de entidades. Por exemplo, WorkItems é um conjunto de entidades que contém WorkItem entidades. A chave de uma entidade identifica exclusivamente a entidade dentro de um conjunto de entidades. Se vários conjuntos de entidades usarem o mesmo tipo de entidade, a mesma combinação de valores de chave poderá aparecer em mais de um conjunto de entidades e identificará entidades diferentes, uma por conjunto de entidades onde essa combinação de chaves aparece. Cada uma dessas entidades tem um ID de entidade diferente. Os conjuntos de entidades fornecem pontos de entrada no modelo de dados.
Os conjuntos de entidades são descritos em metadados OData e variam de acordo com o projeto. Você pode explorar a lista completa de conjuntos de entidades, tipos de entidade e propriedades solicitando os metadados OData para seu projeto. Para saber como, consulte Construir consultas OData para o Analytics.
Entidades compostas
As entidades compostas suportam cenários específicos. Eles são compostos por entidades mais simples, muitas vezes exigem mais recursos de computação para gerar e podem retornar conjuntos de resultados maiores. Para obter o melhor desempenho e evitar limitações desnecessárias, certifique-se de consultar a entidade correta para o seu cenário.
Por exemplo, WorkItemSnapshot combina WorkItemRevisions e Dates de tal forma que cada data tem uma revisão para cada item de trabalho. Essa representação oferece suporte a consultas OData que se concentram em dados de tendência para um conjunto filtrado de itens de trabalho. No entanto, você não deve usar essa entidade composta para consultar o estado atual dos itens de trabalho. Em vez disso, você deve usar o WorkItems conjunto de entidades para gerar uma consulta de execução mais rápida.
Da mesma forma, algumas entidades podem conter todos os valores históricos, enquanto outras podem conter apenas valores atuais. WorkItemRevisions Contém todo o histórico de itens de trabalho, que você não deve usar em cenários onde os valores atuais são de interesse.
Relações
Para gerar resultados de consulta mais complexos, você pode combinar entidades usando relações. Você pode empregar relacionamentos para expandir, filtrar ou resumir dados.
Algumas propriedades de navegação resultam em uma única entidade, enquanto outras resultam em uma coleção de entidades. O diagrama a seguir mostra entidades selecionadas e suas propriedades de navegação. Para maior clareza, algumas entidades e relações compostas foram omitidas.
Chaves de relacionamento
As relações de entidade também são representadas como chaves estrangeiras para que ferramentas externas possam unir entidades. Essas propriedades têm o sufixo "SK" e são tipos de dados inteiros ou GUID. As propriedades de data têm propriedades de chave de data inteira correspondentes com o seguinte formato: AAAAMMDD.
Tipos de entidades de controle de trabalho e conjuntos de entidades
Os seguintes tipos de entidade e conjuntos de entidades são suportados com as versões de API indicadas. Para obter uma referência completa, consulte Referência de metadados de acompanhamento de trabalho para o Azure Boards Analytics.
EntityType/EntitySet |
Description | v1.0 | v2.0 | v3.0 - pré-visualização | Pré-visualização da v4.0 |
|---|---|---|---|---|---|
| Área/ Áreas |
O item de trabalho Caminhos de área, com propriedades para agrupamento e filtragem por hierarquia de área. | ✔️ | ✔️ | ✔️ | ✔️ |
| Iteração/ Iterações |
O item de trabalho Caminhos de Iteração, com propriedades para agrupamento e filtragem por hierarquia de iteração. | ✔️ | ✔️ | ✔️ | ✔️ |
| BoardLocation/ BoardLocations |
A localização das células do tabuleiro, conforme identificado por coluna de prancha, raia e divisão, inclui configurações históricas do tabuleiro. Para obter uma descrição de cada campo do painel, consulte Fluxo de trabalho e campos do quadro. | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate/ Datas |
As datas usadas para filtrar e agrupar outras entidades usando relações. | ✔️ | ✔️ | ✔️ | ✔️ |
| Projeto/ Projetos |
Todos os projetos definidos para uma organização (nuvem) ou coleção de projetos (local). | ✔️ | ✔️ | ✔️ | ✔️ |
| Processo/ Processos |
Informações da lista de pendências usadas para expandir ou filtrar itens de trabalho e tipos de itens de trabalho. Para obter um exemplo que usa Processos para filtrar um relatório, consulte Relatório de exemplo de controle de requisitos. | ✔️ | ✔️ | ✔️ | |
| Tag/ Etiquetas |
Todas as tags de item de trabalho para cada projeto. Para obter um exemplo que usa Tags para filtrar um relatório, consulte Relatório de exemplo de burndown de versão. | ✔️ | ✔️ | ✔️ | ✔️ |
| Equipa/ Equipas |
Todas as equipas definidas para o projeto. Para obter um exemplo que usa o Teams para filtrar um relatório, consulte Adicionar uma segmentação de dados de equipe a um relatório do Power BI. | ✔️ | ✔️ | ✔️ | ✔️ |
| Utilizador/ Utilizadores |
Informações do usuário que são usadas para expandir ou filtrar várias propriedades de item de trabalho, por exemplo , Atribuído a, Criado por. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemBoardSnapshot/ WorkItemBoardSnapshot |
(Composto) O estado de cada item de trabalho em cada data do calendário, incluindo a localização do quadro, usado para gerar relatórios de tendências. Para obter um relatório de exemplo, consulte Relatório de exemplo de diagrama de fluxo cumulativo (CFD). | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink/ WorkItemLinks |
Os links entre itens de trabalho, por exemplo, Filho, Pai e Relacionado. Inclui apenas a última revisão de links, sem histórico. Os hiperlinks não estão incluídos. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemRevision/ WorkItemRevisions |
Todas as revisões de itens de trabalho históricos, incluindo a revisão atual. Não inclui itens de trabalho excluídos. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemSnapshot/ WorkItemSnapshot |
(Composto) O estado de cada item de trabalho em cada data do calendário, usado para dar suporte a relatórios de tendências. Para obter um relatório de exemplo, consulte Relatório de exemplo de tendências de bugs. | ✔️ | ✔️ | ✔️ | ✔️ |
| Item de trabalho/ Itens de Trabalho |
O estado atual dos itens de trabalho. Usado para dar suporte a relatórios de status. Para obter um relatório de exemplo, consulte Acumular valores de item de trabalho filho para relatório de exemplo pai. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemTypeField/ WorkItemTypeFields |
As propriedades do item de trabalho para cada tipo e processo de item de trabalho. Usado para dar suporte à construção de relatórios. | ✔️ | ✔️ | ✔️ | ✔️ |
Tipos de entidades de pipelines e conjuntos de entidades
Os seguintes tipos de entidades e conjuntos de entidades são suportados com a versão v3.0-preview ou v4.0-preview do Analytics. Para obter uma referência completa, consulte Referência de metadados de pipeline .
| EntityType/EntitySet | Description | v3.0 - pré-visualização | Pré-visualização da v4.0 |
|---|---|---|---|
| Ramo/ Sucursais |
Informações básicas sobre ramificações usadas em testes ou pipelines. Para obter um relatório de exemplo, consulte Relatório de exemplo de status de progresso. | ✔️ | ✔️ |
| ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot |
(Composto) Suporta a compreensão do consumo de pipeline paralelo. Para obter mais informações sobre testes de pipeline paralelo, consulte Executar testes em paralelo usando a tarefa de teste do Visual Studio. | ✔️ | |
| Gasoduto/ Pipelines |
Propriedades de um pipeline. | ✔️ | ✔️ |
| PipelineJob/ PipelineJobs |
Resultados de execução individuais para um teste específico associado a um TestRun | ✔️ | ✔️ |
| PipelineRun/ PipelineRuns |
Informações de execução para pipelines. Para obter um relatório de exemplo, consulte Relatório de exemplo de tendência de taxa de aprovação de pipeline. | ✔️ | ✔️ |
| PipelineRunActivityResult/ PipelineRunActivityResults |
Log mesclado de todos os estágios, etapas, trabalhos e tarefas dentro de uma execução de pipeline específica. Para obter um relatório de exemplo, consulte Relatório de exemplo de duração da tarefa de pipeline. | ✔️ | ✔️ |
| PipelineTask/ PipelineTasks |
Propriedades para tarefas que são usadas dentro de um pipeline. | ✔️ | ✔️ |
| TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots |
(Composto) Suporta a compreensão do tamanho do pool, trabalhos de pipeline e simultaneidade. O gráfico Histórico para pools de agentes ilustra como esse conjunto de entidades pode ser usado. | ✔️ | |
| TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots |
(Composto) | ✔️ |
Tipos de entidade de teste e conjuntos de entidades
Os seguintes tipos de entidades e conjuntos de entidades são suportados com a versão v3.0-preview ou v4.0-preview do Analytics. Para obter uma referência completa, consulte Referência de metadados de teste.
EntityType/EntitySet |
Description | v3.0 - pré-visualização | Pré-visualização da v4.0 |
|---|---|---|---|
| TestConfiguration/ TestConfigurations |
Informações de configuração do plano de teste. Para obter detalhes sobre como configurar testes, consulte Testar configurações diferentes | ✔️ | ✔️ |
| TestResult/ Resultados dos Testes |
Resultados de execução individual para um teste específico associado a um TestRun. | ✔️ | ✔️ |
| TestResultsDiário/ TestResultsDiário |
Um instantâneo diário agregado de execuções TestResult, agrupado por Test (não TestRun). Para obter um relatório de exemplo, consulte Relatório de exemplo de tendência de resumo de teste. | ✔️ | ✔️ |
| TestRun/ TestRuns |
Informações de execução para testes executados sob um pipeline com TestResult agregado. | ✔️ | ✔️ |
| Teste/ Testes |
Propriedades para um caso de teste, como nome do teste e proprietário do teste. Para obter detalhes sobre como definir casos de teste, consulte Criar casos de teste manuais. | ✔️ | ✔️ |
| Ponto de teste/ Pontos de Teste |
Informações de execução para pontos de teste. Um ponto de teste é uma combinação exclusiva de caso de teste, conjunto de testes, configuração e testador. Para obter um relatório de exemplo, consulte Relatório de exemplo de status de progresso. | ✔️ | ✔️ |
| TestPointHistorySnapshot/ TestPointHistorySnapshots |
(Composto) Resultados de execução individual para um teste específico associado a um TestRun. Para obter um relatório de exemplo, consulte Relatório de exemplo de tendência de execução de teste manual | ✔️ | ✔️ |
| TestSuite/ TestSuites |
Informações sobre conjuntos de testes. Para obter detalhes sobre como definir conjuntos de testes, consulte Criar planos de teste e conjuntos de testes. | ✔️ | ✔️ |