Resolver erros associados a uma exibição do Analytics

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Uma exibição de Analytics fornece uma maneira simplificada de especificar os critérios de filtro para um relatório do Power BI com base em dados do Analytics. O Analytics fornece a plataforma de relatórios para o Azure DevOps. Você gerencia as exibições do Analytics no portal da Web para o Azure DevOps e, em seguida, acessa-as com o Conector de Dados do Power BI.

Este artigo fornece diretrizes de solução de problemas comuns com exibições do Analytics, incluindo avisos de tamanho, erros de verificação e problemas de conexão do Power BI.

Pré-requisitos

Resolver avisos de tamanho

Aviso: esta visualização pode conter muitos dados

Esse aviso aparece quando o Power BI determina que não pode carregar todos os dados contidos na exibição. Normalmente, ocorre quando você não especificou filtros suficientes na exibição ou especificou o carregamento de todo o histórico com uma granularidade diária.

Etapas da resolução:

1. Adicione filtros mais específicos: aplique filtros de item de trabalho adicionais para reduzir o escopo de dados:

   • Filtrar por tipos de item de trabalho específicos (Bug, História do Usuário, Tarefa)
   • Limite para á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 configurações de histórico: modifique o histórico ou a granularidade para definir o escopo dos resultados da exibição:

   • Altere de "Todo o histórico" para um intervalo de tempo específico (últimos 30, 60 ou 90 dias)
   • Aumentar a granularidade de uma base diária para semanal ou mensal
   • Use "Somente atual" se você não precisar de dados de tendência histórico

3. Verifique antes de salvar: sempre verifique sua exibição antes de salvar para garantir que ela seja carregada com êxito no Power BI.

Resolver erros de verificação

Erro: o campo 'FieldName' já existe

Esse erro indica que um dos campos personalizados do projeto tem o mesmo nome que um campo análise.

Resolução: Renomeie seu campo personalizado para evitar o conflito de nomenclatura. Entre em contato com o administrador do projeto se você não tiver permissões para modificar campos personalizados.

Erro: o campo não existe mais

Esse erro significa que um dos seus campos de exibição ou filtros de item de trabalho faz referência a um campo que foi removido do processo de projeto.

Etapas da resolução:

1. Edite sua exibição no Azure DevOps.
2. Vá para a guia Itens de Trabalho ou Campos.
3. Remova o filtro ou o campo que faz referência ao campo excluído.
4. Verifique e salve a visualização.

Erro: critérios de filtro inválidos

Esse erro ocorre quando valores de filtro não existem mais em seu projeto (por exemplo, áreas excluídas, iterações ou estados de item de trabalho).

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

Resolver erros de conexão do Power BI

A visão de análise não existe ou você não tem permissão para visualizá-la

Esse erro ocorre quando você tenta atualizar um modo de exibição no Power BI que não está mais disponível no Azure DevOps.

Causas comuns:

• A exibição foi renomeada ou excluída
• Suas permissões para acessar a exibição foram removidas
• O modo de exibição foi alterado de Compartilhado para Privado
• O acesso a organização ou projeto foi revogado

Etapas da resolução:

1. Verifique o acesso à exibição: faça logon no Azure DevOps e confirme se você pode acessar a exibição.
2. Verificar permissões: verifique se você tem permissão para usar o modo de exibição.
3. Verificar permissões de análise: confirme se você tem permissão Ver análises para o projeto.
4. Atualizar o Power BI: se a exibição foi renomeada, atualize a conexão no Power BI para usar o novo nome.
5. Remova a tabela quebrada: se a visão não existir mais, exclua a tabela do seu relatório no Power BI.

O campo já existe no registro

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

Resolução :

1. Edite a exibição no Azure DevOps.
2. Acesse a aba Campos.
3. Remova o campo duplicado da lista de campos.
4. Salve o modo de exibição e atualize no Power BI.

O resultado da consulta excede o tamanho máximo

Esse erro ocorre quando sua exibição retorna mais de 250.000 registros, excedendo os limites de carregamento do Power BI.

Etapas da resolução:

1. Adicionar filtros de tempo: limite o intervalo de datas (últimos 30 a 90 dias em vez de todo o histórico).
2. Filtrar itens de trabalho: aplique filtros de tipo de item de trabalho, área ou iteração mais específicos.
3. Aumentar a granularidade: alterar de pontos de dados diários para semanais ou mensais.
4. Exibições divididas: crie várias exibições menores em vez de uma exibição grande.

Erros de autenticação e acesso

Mensagens de erro:

• "O usuário não está autorizado"
• "O acesso ao recurso é proibido"
• "O Project não existe ou você não tem permissões"

Etapas da resolução:

1. Verifique o acesso ao projeto: verifique se você é membro do projeto do Azure DevOps.
2. Validar permissões de Análise: verifique se você tem acesso ao Analytics.
3. Examine as credenciais: desmarque as credenciais do Power BI e entre novamente.
4. Contate o administrador: trabalhe com o administrador do projeto para resolver problemas de permissão.

Usar a IA para solucionar problemas de exibição de análise

O prompt de exemplo a seguir para o Copilot Chat ajuda você a solucionar problemas de exibição do Analytics e de integração do Power BI. Copie e cole esse prompt no Copilot Chat, substituindo os marcadores com as suas informações específicas.

Para obter a melhor assistência de IA, inclua detalhes específicos, como o nome de exibição do Analytics, a versão do Power BI Desktop, os nomes de campo e as configurações de filtro que podem estar relacionadas ao 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.

Copilot é alimentado pela IA, portanto, surpresas e erros são possíveis. Para obter mais informações, consulte perguntas frequentessobre uso geral do Copilot.

Solução de problemas avançada

Otimização de desempenho

Se a vista do Analytics carregar lentamente ou expirar:

1. Minimizar a seleção de campo: inclua apenas os campos de que você realmente precisa em seu relatório.
2. Use a granularidade apropriada: os dados mensais ou semanais são carregados mais rápido do que diariamente.
3. Aplicar filtros efetivos: Filtre no início do 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: verifique se as credenciais armazenadas no serviço do Power BI são válidas.
2. Verificar permissões de exibição: confirme se a conta de serviço tem acesso à vista do Analytics.
3. Monitorar a conectividade do gateway: verifique a conectividade do gateway local, se aplicável.
4. Examinar o histórico de atualizações: verifique os logs de atualização do Power BI para obter detalhes de erro específicos.

Artigos relacionados

• Criar uma exibição do Analytics
• Gerenciar exibições do Analytics
• Conectar-se ao Conector de Dados do Power BI
• Dados disponíveis no Analytics
• Conceder permissões para acessar o Analytics
• Visão geral da integração do Power BI