Permissões e pré-requisitos para acessar o Analytics no Azure DevOps
Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019
Para trabalhar com o Google 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 Google Analytics para os projetos dos quais são membros, incluindo membros adicionados ao grupo Leitores do projeto. Os usuários com acesso de partes interessadas não têm acesso para visualizar ou editar visualizações do Google Analytics.
Serviço e habilitação de 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 os Serviços de DevOps do Azure, o Analytics está sempre ativo. Não é possível desativá-lo ou pausá-lo.
Para o Azure DevOps Server 2020 e versões locais posteriores, o Analytics é instalado automaticamente com cada coleção de projetos criada.
Para o 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 novo dado é adicionado ao Google Analytics.
Para obter mais informações, consulte Instalar ou habilitar o serviço Analytics.
Serviços de DevOps do Azure
Para exercer qualquer serviço de DevOps do Azure, ele deve ser habilitado. Nenhum dado pode ser capturado para um serviço que foi desativado. Os serviços podem ser ativados ou desativados projeto a projeto.
Para verificar se todos os serviços estão ativados, consulte Ativar ou desativar um serviço.
Visualizações do Google Analytics
As vistas do Analytics, um hub no seu portal Web, fornecem uma forma 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 Serviço de Análise?
Para aceder às vistas do Google Analytics, tem de as ter ativadas. 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, consulte 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 Google 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 | Contribuidores | Administradores de projetos |
|---|---|---|---|
| Ver análise | ✔️ | ✔️ | ✔️ |
| Ver uma vista partilhada do Analytics | ✔️ | ✔️ | |
| Adicionar uma vista privada ou partilhada do Analytics | ✔️ | ✔️ | |
| Editar e excluir visualizações compartilhadas do Google Analytics | ✔️ |
Pré-requisitos de rastreamento 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.
Nota
Os conjuntos de entidades Branch, Pipeline e Test são suportados 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 tarefas e tamanho do pool de agentes de tarefas foram adicionados com a versão de visualização do Google Analytics v4.0. Certifique-se de especificar a versão do Google Analytics que suporta o 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 Google 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 o Azure Boards Analytics.
Para relatar o acompanhamento do trabalho, as equipes precisam executar várias tarefas para garantir que dados significativos estejam disponíveis. Analise as tarefas a seguir antes de definir suas consultas e relatórios do Google Analytics.
- Para relatar bugs ativos ou tendências de bugs, defina bugs e atualize o estado do bug à medida que ele é corrigido, verificado e, em seguida, fechado.
- Para relatar o trabalho da lista de pendências ou outros tipos de item de trabalho, certifique-se de definir esses itens de trabalho e atualizar seu Estado à medida que ele passa de novo para fechado. Considere quaisquer campos ou tags que você usará para filtrar ou agrupar dados em um relatório e certifique-se de que eles estejam bem definidos e consistentes.
- Para dar suporte a relatórios de rollup, verifique se existem links pai-filho entre itens da lista de pendências do produto e tarefas/bugs, ou links pai-filho entre recursos ou itens de trabalho da lista de pendências do 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 Sprint ou Release burndown, certifique-se de ter pensado em como deseja filtrar e agrupar dados em seu relatório. Os relatórios de burndown/burnup fazem referência ao conjunto de
WorkItemsSnapshotentidades. Os conjuntos de entidades de instantâneo são modelados como instantâneos 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 campos ou tags, 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 Caminho de Á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.
Nota
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 para 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 pacotes de teste e Criar casos de teste.
- Atualize o estado dos objetos de teste à medida que 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.
Gorjeta
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 reprovado se qualquer etapa de teste for marcada como reprovada ou não marcada.
- Para testes automatizados, cada teste é automaticamente marcado como aprovado ou reprovado.
- (Recomendado) Para dar suporte à filtragem e ao agrupamento em um relatório, atribua o Caminho de Área e o Caminho de Iteração a casos de teste, conjuntos de testes e planos de teste.
Pipelines
Para gerar relatórios sobre 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 o Azure Pipelines Analytics.
- Considere quais pipelines você deseja relatar e o intervalo de datas do relatório. Convém 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 Compilar e liberar tarefas-Test.
Se você está apenas começando, considere revisar este módulo do Learn, Executar testes de qualidade em seu pipeline de compilação usando o Azure Pipelines.