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

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 têm acesso aos dados do Analytics para os projetos dos quais são membros, incluindo os membros adicionados ao grupo Leitores do projeto. Os usuários com acesso ao Stakeholder não têm acesso para exibir ou editar exibições do Analytics.

Habilitação de serviços e recursos

Em geral, o Analytics está sempre ativo e disponível para os membros de uma organização ou coleção para visualizar dados e criar relatórios.

Serviço de análise

Para Azure DevOps Services, a Análise está sempre ativa. Você não pode desativá-lo ou pausá-lo.

Para Azure DevOps Server 2020 e versões locais posteriores, a Análise é instalada automaticamente com cada coleção de projetos que você cria.

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

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

Para obter mais informações, consulte Instalar ou habilitar o serviço Analytics.

Serviços do Azure DevOps Services

Para exercer qualquer serviço do Azure DevOps, ele deve estar habilitado. Nenhum dado pode ser capturado para um serviço que foi desabilitado. Os serviços podem ser ativados ou desativados projeto a 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 do Analytics, um hub em seu 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 obter mais informações, consulte O que é o Analytics Service?

Para acessar as exibições do Analytics, você deve ativá-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 por 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 visualização compartilhada do Google Analytics ✔️ ✔️
Adicionar uma vista privada ou partilhada do Analytics ✔️ ✔️
Editar e excluir vistas compartilhadas do Google Analytics ✔️

Pré-requisitos de rastreamento de dados

Para capturar dados significativos, as equipes de software devem realizar 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 de ramificação, pipeline e teste são compatíveis 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 de agente de tarefa e tamanho do pool de agente de tarefa foram adicionados com a versão de visualização do Analytics v4.0. Certifique-se de especificar a versão do Analytics que dá suporte ao conjunto de entidades de interesse.

Para entender por quais propriedades e valores de lista enumerados 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 rastreamento do trabalho, as equipes precisam executar várias tarefas para garantir que dados significativos estejam disponíveis. Revise 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 à medida que 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 à medida que ele se move de novo para fechado. Considere os campos ou tags que você usará para filtrar ou agrupar dados em um relatório e certifique-se de que estejam bem definidos e consistentes.
  • Para dar suporte a relatórios cumulativos, verifique se existem links pai-filho entre itens de lista de pendências do produto e tarefas/bugs ou se existem links pai-filho entre recursos ou itens de trabalho de lista de pendências de portfólio e seus itens filho. Para obter mais informações, consulte 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. Os relatórios de burndown/burnup fazem referência ao conjunto de WorkItemsSnapshot entidades. Os conjuntos de entidades de snapshot são modelados como snapshots diários. Os dados são agregados com base nas atribuições feitas a partir da data em que são atribuídos. Isso significa que, para filtrar um relatório de burndown/burnup com base em atribuições de campo ou tag, você deve atribuir os campos ou tags antes do período sobre o qual deseja relatar. Caso contrário, os campos/tags não serão registrados pelo relatório até a data em que forem aplicados.
  • Para dar suporte ao rastreamento 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 a seus PBIs pai usando o link Testado por. Consulte Criar seus testes.
  • (Recomendado) Para dar suporte à filtragem e ao agrupamento em um relatório, atribua o Caminho da Área e o Caminho da 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. Os campos personalizados são rotulados com Custom_DisplayNameOfField, onde todos os espaços foram removidos do nome de exibição.

Planos de teste

Para revisar o progresso do plano de teste e a prontidão do caso de teste, as equipes precisam executar as seguintes atividades.

  • Defina casos de teste, planos de teste e conjuntos de testes e especifique seu estado atual. Para obter mais informações, consulte Criar planos de teste e conjuntos de testes e Criar casos de teste.
  • Atualize o Estado dos objetos de teste à medida que eles progridem de Design para Pronto para Fechado.
  • Para testes manuais, marque os resultados de cada etapa de validação no caso de teste como aprovados ou reprovados.

    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á um status de falha se qualquer etapa de teste for marcada como reprovada ou não marcada.

  • Para testes automatizados, cada teste é marcado automaticamente como aprovado ou reprovado.
  • (Recomendado) Para dar suporte à filtragem e ao agrupamento em um relatório, atribua Caminho de Á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 obter mais informações, consulte 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 Análise do Azure Pipelines.
  • Considere quais pipelines você deseja relatar e o intervalo de datas do seu 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 pipelines e resultados de testes, certifique-se de adicionar tarefas de teste à definição de pipeline. Para obter mais informações, consulte Tarefas de build e versão-Teste.

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