Share via

Permissões e pré-requisitos para acessar o Analytics no Azure DevOps

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Para trabalhar com o Analytics e criar relatórios, vários pré-requisitos devem ser atendidos conforme resumido neste artigo.

Por padrão, todos os membros do projeto recebem acesso aos dados do Analytics para os projetos dos quais são membros, incluindo membros adicionados ao grupo Leitores do projeto. Os usuários com acesso de stakeholders não têm acesso para exibir ou editar exibições do Analytics.

Habilitação de serviço e recurso

Em geral, o Analytics está sempre ativado e disponível para membros de uma organização ou coleção para exibir dados e criar relatório.

Serviço de análise

Para Azure DevOps Services, a Análise está sempre ativada. Você não pode desabilitá-lo ou pausar.

Para Azure DevOps Server 2020 e versões locais posteriores, o Analytics é instalado automaticamente com cada coleção de projetos que você criar.

Para Azure DevOps Server 2019, primeiro você deve instalar o Analytics em cada coleção de projetos que criar.

Você pode pausar e reiniciar o serviço. Quando pausado, nenhum novo dado é adicionado ao Analytics.

Para saber mais, confira Instalar ou habilitar o serviço de Análise.

Serviços do Azure DevOps Services

Para exercer qualquer serviço do Azure DevOps, ele deve ser habilitado. Nenhum dado pode ser capturado para um serviço que foi desabilitado. Os serviços podem ser habilitados ou desabilitados em um projeto por projeto.

Para verificar se todos os serviços estão habilitados, consulte Ativar ou desativar um serviço.

Exibições de Análise

As exibições de análise, um hub no portal da Web, fornecem uma maneira simplificada de especificar os critérios de filtro para um relatório do Power BI com base nos dados do Analytics. Para saber mais, confira O que é o Serviço de Análise?

Para acessar as exibições do Analytics, você deve habilitá-lo. O proprietário da organização ou membro do grupo Administradores de Coleção de Projetos pode habilitá-lo para todos na organização. Ou, cada membro do projeto pode habilitá-lo para si mesmo.

Para saber como, confira Gerenciar ou habilitar recursos.

Permissões

Você define permissões para o serviço no nível do projeto e para exibições compartilhadas do Analytics no nível do objeto.

A tabela a seguir resume as permissões disponíveis para serem definidas e as atribuições padrão feitas aos grupos de segurança do projeto.

Permissão Leitores Colaboradores Administradores do Projeto
Exibir Análise ✔️ ✔️ ✔️
Exibir uma exibição de Análise compartilhada ✔️ ✔️
Adicionar uma exibição de Análise privada ou compartilhada ✔️ ✔️
Editar e excluir exibições compartilhadas da Análise ✔️

Pré-requisitos de acompanhamento de dados

Para capturar dados significativos, as equipes de software devem executar ações significativas. As seções a seguir fornecem recomendações gerais com base no tipo de dados que você deseja relatar.

Observação

Os conjuntos de entidades Branch, Pipeline e Test têm suporte com o Analytics v3.0-preview e versões posteriores. Conjuntos de entidades de instantâneo para dar suporte a trabalhos de pipeline, solicitações do agente de tarefas e tamanho do pool de agentes de tarefas foram adicionados com a versão de versão prévia do Analytics v4.0 . Especifique a versão do Analytics que dá suporte ao conjunto de entidades de interesse.

Para entender quais propriedades e valores de lista enumeradas você pode filtrar ou agrupar dados, explore os metadados do Analytics para o tipo de entidade correspondente.

Azure Boards e acompanhamento de trabalho

Para obter uma revisão dos conjuntos de entidades disponíveis que você pode consultar, consulte Referência de metadados para Azure Boards Analytics.

Para relatar o acompanhamento de trabalho, as equipes precisam executar várias tarefas para garantir que dados significativos estão disponíveis. Examine as tarefas a seguir antes de definir suas consultas e relatórios do Analytics.

  • Para relatar bugs ativos ou tendências de bugs, defina bugs e atualize o Estado do bug conforme ele é corrigido, verificado e fechado.
  • Para relatar o trabalho de lista de pendências ou outros tipos de item de trabalho, defina esses itens de trabalho e atualize seu Estado conforme ele passa de novo para fechado. Considere quaisquer campos ou marcas que você usará para filtrar ou agrupar dados em um relatório e verifique se isso é bem definido e consistente.
  • Para dar suporte a relatórios de rollup, verifique se existem links pai-filho entre itens de lista de pendências do produto e tarefas/bugs ou vínculos pai-filho entre recursos ou itens de trabalho de lista de pendências de portfólio e seus itens filho. Para saber mais, confira Organizar sua lista de pendências e mapear itens de trabalho filho para os pais.
  • Para criar relatórios de burndown ou burnup, como burndown de Sprint ou Burndown de versão, verifique se você pensou em como deseja filtrar e agrupar dados em seu relatório. Relatórios de burndown/burnup fazem referência ao WorkItemsSnapshot conjunto de entidades. Os conjuntos de entidades de instantâneo são modelados como instantâneos diários. Os dados são agregados com base em atribuições feitas a partir da data em que são atribuídos. O que isso significa é que, para filtrar um relatório de burndown/burnup com base em atribuições de campo ou marca, você deve atribuir os campos ou marcas antes do período em que deseja relatar. Caso contrário, os campos/marcas não são registrados pelo relatório até a data em que são aplicados.
  • Para dar suporte ao acompanhamento de requisitos, defina casos de teste e crie um link Testado por de cada caso de teste para uma história de usuário, item de lista de pendências do produto ou requisito. Defina casos de teste e vincule casos de teste aos PBIs pai usando o link Testado Por. Consulte Criar seus testes.
  • (Recomendado) Para dar suporte à filtragem e ao agrupamento em um relatório, atribua Caminho da Área e Caminho de Iteração a todos os itens de trabalho. Para obter informações sobre como definir caminhos de iteração e área, consulte Definir caminhos de área e atribuir a uma equipe ou Definir caminhos de iteração (sprints) e configurar iterações de equipe.

Observação

Todos os campos personalizados adicionados a um tipo de item de trabalho estão disponíveis para uso em relatórios. Campos personalizados são rotulados com Custom_DisplayNameOfField, em que todos os espaços foram removidos do nome de exibição.

Planos de teste

Para examinar o progresso do plano de teste e a preparação do caso de teste, as equipes precisam executar as atividades a seguir.

  • Defina casos de teste, planos de teste e conjuntos de testes e especifique seu estado atual. Para saber mais, confira Criar planos de teste e conjuntos de testes e Criar casos de teste.
  • Atualize o Estado dos objetos de teste à medida que avançam de Design para Pronto para Fechado.
  • Para testes manuais, marque os resultados de cada etapa de validação no caso de teste como aprovado ou com falha.

    Dica

    Os testadores devem marcar uma etapa de teste com um status se for uma etapa de teste de validação. O resultado geral de um teste reflete o status de todas as etapas de teste que foram marcadas. Portanto, o teste terá uma status de falha se qualquer etapa de teste estiver marcada como com falha ou não marcada.

  • Para testes automatizados, cada teste é marcado automaticamente como aprovado ou com falha.
  • (Recomendado) Para dar suporte à filtragem e ao agrupamento em um relatório, atribua Caminho da Área e Caminho de Iteração a casos de teste, conjuntos de testes e planos de teste.

Pipelines

Para relatar pipelines, as equipes precisam definir pipelines usando YAML e executar pipelines regularmente. Para saber mais, confira Principais conceitos para novos usuários do Azure Pipelines.

Além disso, considere as seguintes ações:

  • Considere quais dados você deseja relatar e escolha o conjunto de entidades correto. Para obter uma revisão dos conjuntos de entidades disponíveis para consulta, consulte Referência de metadados para o Azure Pipelines Analytics.
  • Considere em quais pipelines você deseja relatar e o intervalo de datas do relatório. Você desejará filtrar seus dados para atender às práticas recomendadas de consulta e minimizar quaisquer problemas de desempenho.

Pipelines e teste

Para relatar os resultados de pipelines e testes, adicione tarefas de teste à definição de pipeline. Para saber mais, confira Tarefas de build e lançamento– Teste.

Se você estiver apenas começando, considere revisar este módulo do Learn, Executar testes de qualidade em seu pipeline de build usando o Azure Pipelines.