Resolver erros associados a uma vista do Analytics

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Uma Vista do Analytics fornece uma forma simplificada de especificar os critérios de filtro para um relatório do Power BI baseado nos dados do Analytics. O Analytics fornece a plataforma de relatórios para o Azure DevOps. Geres as visualizações de Analytics no portal web do Azure DevOps e depois acedes a elas com o Power BI Data Connector.

Este artigo fornece orientações para resolver problemas comuns nas visualizações do Analytics, incluindo avisos de tamanho, erros de verificação e problemas de conexão ao Power BI.

Pré-requisitos

Corrigir avisos de tamanho

Aviso: esta vista pode conter demasiados dados

Este aviso aparece quando o Power BI determina que não pode carregar todos os dados contidos na vista. Isto geralmente ocorre quando não especificou filtros suficientes na vista ou especificou o carregamento de todo o histórico com uma granularidade diária.

Passos de resolução:

1. Adicionar filtros mais específicos: Aplicar filtros adicionais para itens de trabalho para reduzir o âmbito dos dados:

   • Filtrar por tipos específicos de itens de trabalho (Bug, História de Utilizador, Tarefa)
   • Limite a áreas ou iterações específicas
   • Aplicar filtros de estado (Ativo, Resolvido, Fechado)
   • Definir filtros de intervalo de datas para datas de criação ou modificação

2. Ajustar as definições do histórico: Modificar o histórico ou a granularidade para ajustar o escopo dos resultados da visualização.

   • Mudança de "Todo o histórico" para um intervalo de tempo específico (últimos 30, 60 ou 90 dias)
   • Aumentar a granularidade de um nível diário para semanal ou mensal
   • Use "Apenas atual" se não precisar de dados históricos de tendências

3. Verifique antes de guardar: Verifique sempre a sua vista antes de guardar para garantir que carrega com sucesso no Power BI.

Resolver erros de verificação

Erro: o campo 'FieldName' já existe

Este erro indica que um dos campos personalizados do seu projeto tem o mesmo nome que um campo de Análise.

Resolução: Renomeia o teu campo personalizado para evitar conflitos de nomes. Contacte o administrador do seu projeto se não tiver permissões para modificar campos personalizados.

Erro: o campo já não existe

Este erro significa que um dos seus filtros de itens de trabalho ou campos de visualização faz referência a um campo que foi removido do processo do seu projeto.

Passos de resolução:

1. Edita a tua exibição no Azure DevOps.
2. Vai ao separador Itens de Trabalho ou Campos .
3. Remova o filtro ou campo que faz referência ao campo eliminado.
4. Verifica e guarda a visualização.

Erro: Critérios de filtro inválidos

Este erro ocorre quando os valores do filtro já não existem no seu projeto (por exemplo, áreas eliminadas, iterações ou estados dos itens de trabalho).

Resolução: Revise e atualize os critérios do filtro para usar valores atuais e válidos para o seu projeto.

Resolver erros de ligação ao Power BI

A visualização analítica não existe ou não tens permissão para a visualizar

Este erro ocorre quando tenta atualizar uma vista no Power BI que já não está disponível no Azure DevOps.

Causas comuns:

• A visualização foi renomeada ou eliminada
• As suas permissões para aceder à visualização foram removidas
• A opinião foi alterada de Partilhado para Privado
• O acesso à organização ou ao projeto foi revogado

Passos de resolução:

1. Verificar acesso à visualização: Inicie sessão no Azure DevOps e confirme que pode aceder à visualização.
2. Verifique permissões: Certifique-se de que tem permissão para usar a visualização.
3. Verificar permissões de Analytics: Confirme que tem permissão de Visualizar Analytics para o projeto.
4. Atualizar Power BI: Se a vista foi renomeada, atualize a ligação no Power BI para usar o novo nome.
5. Remover tabela quebrada: Se a vista já não existir mais, apague a tabela no seu relatório Power BI.

O campo já existe no registo

Este erro indica que um campo personalizado tem o mesmo nome de exibição de um dos campos reservados do Azure DevOps, criando uma colisão no Power BI.

Resolution:

1. Editar a visualização no Azure DevOps.
2. Vai ao separador Campos.
3. Remova o campo duplicado da lista de campos.
4. Guarda a visualização e recarrega no Power BI.

O resultado da consulta excede o tamanho máximo

Este erro ocorre quando a sua visualização devolve mais de 250.000 registos, excedendo os limites de carregamento do Power BI.

Passos de resolução:

1. Adicionar filtros de tempo: Limite o intervalo de datas (últimos 30-90 dias em vez de todo o histórico).
2. Filtrar itens de trabalho: Aplique filtros de tipo de item, área ou iteração mais específicos.
3. Aumentar a granularidade: Mudança de dados diários para semanais ou mensais.
4. Vistas divididas: Crie múltiplas vistas mais pequenas em vez de uma vista grande.

Autenticação e erros de acesso

Mensagens de erro:

• "O utilizador não está autorizado"
• "O acesso ao recurso é proibido"
• "O projeto não existe ou não tens permissões"

Passos de resolução:

1. Verifique o acesso ao projeto: Verifique se é membro do projeto Azure DevOps.
2. Validar permissões de Analytics: Certifique-se de que tem acesso ao Analytics.
3. Rever credenciais: Limpar as credenciais do Power BI e efetuar login novamente.
4. Contacte o administrador: Trabalhe com o administrador do seu projeto para resolver questões de permissões.

Use IA para resolver problemas com visualizações analíticas

O seguinte exemplo de prompt para o Copilot Chat ajuda-o a resolver problemas com a vista do Analytics e a integração com o Power BI. Copie e cole este prompt no Copilot Chat, substituindo os espaços reservados pela sua informação específica.

Para obter a melhor assistência em IA, inclua detalhes específicos como o nome da sua visualização de Analytics, a versão do Power BI Desktop, nomes dos campos e configurações de filtros que possam estar relacionadas com o problema.

I'm getting this Azure DevOps Analytics view error: [PASTE YOUR ERROR MESSAGE HERE]

Analytics view details:
- View name: [YOUR VIEW NAME]
- Organization: [YOUR ORGANIZATION NAME]
- Project: [YOUR PROJECT NAME]
- Power BI Desktop version: [YOUR VERSION]
- Specific fields or filters involved: [LIST RELEVANT FIELDS/FILTERS]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the Analytics view problem
2. Fix the view configuration or Power BI connection issue
3. Verify the Analytics view loads correctly in Power BI

Context: This is for an Analytics view in Azure DevOps that I'm trying to connect to Power BI. The error might be related to view verification, field conflicts, data size limits, or Power BI refresh issues.

O copiloto é alimentado por IA, por isso surpresas e erros são possíveis. Para obter mais informações, consulte Perguntas frequentes sobre o uso geral do Copilot.

Resolução de problemas avançados

Otimização do desempenho

Se a sua vista do Analytics é carregada lentamente ou é expirada:

1. Minimize a seleção de campos: Inclua apenas os campos que realmente precisa no seu relatório.
2. Use a granularidade adequada: Os dados mensais ou semanais carregam mais rápido do que os diários.
3. Aplique filtros eficazes: Filtre cedo no pipeline de dados em vez de no Power BI.
4. Considere a atualização incremental: Configure a atualização incremental no Power BI para grandes conjuntos de dados.

Problemas de atualização de dados

Para problemas de atualização automática:

1. Verificar credenciais: Garantir que as credenciais armazenadas no serviço Power BI são válidas.
2. Verificar permissões de visualização: Confirme que a conta de serviço tem acesso à vista de Analytics.
3. Monitorizar a conectividade do gateway: Verificar a conectividade do gateway local, se for o caso.
4. Verifique o histórico de atualizações: Verifique os registos de atualização do Power BI para detalhes específicos de erro.

Artigos relacionados

• Criar uma vista do Google Analytics
• Gerenciar visualizações do Google Analytics
• Ligue ao Power BI Data Connector
• Dados disponíveis do Google Analytics
• Conceder permissões para acessar o Google Analytics
• Visão geral da integração do Power BI