Compartilhar via


Conectar o Analytics ao Conector de Dados do Power BI

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

Saiba como estabelecer uma conexão perfeita entre o Power BI e o Azure DevOps usando o Conector de Dados do Power BI. Essa integração permite extrair insights valiosos de seus dados do Azure DevOps e criar relatórios e dashboards atraentes no Power BI usando exibições do Analytics.

Importante

As exibições de análise só dão suporte a dados do Azure Boards (itens de trabalho). As exibições de Analytics não dão suporte a outros tipos de dados, como pipelines. As exibições fornecem uma lista simples de itens de trabalho e não dão suporte a hierarquias de item de trabalho. Neste ponto, não há planos para atualizar o conector para dar suporte a outros tipos de dados. Para obter informações sobre outras abordagens, consulte Sobre a integração do Power BI.

O Conector de Dados do Power BI fornece uma conexão direta com o Azure DevOps Analytics, permitindo que você execute as seguintes tarefas:

  • Importar exibições do Analytics para o Power BI Desktop
  • Criar relatórios personalizados com dados do Azure DevOps em tempo real
  • Criar painéis interativos para os stakeholders
  • Acompanhar as métricas do projeto e o desempenho da equipe
  • Visualizar tendências de item de trabalho e progresso de sprint

Pré-requisitos

Verifique se você atende aos seguintes requisitos antes de conectar o Power BI ao Azure DevOps Analytics:

Categoria Requisitos
Níveis de acesso - Membro do projeto
- Pelo menos no nível de acesso básico
Permissões - Permissões de análise
- A associação ao grupo de colaboradores fornece permissões necessárias
Ferramentas - Quadros do Azure habilitados
- Power BI Desktop (versão mais recente recomendada)
Preparação – Noções básicas sobre conceitos de Análise
- Exibição de análise criada para suas necessidades de relatório
- Familiaridade com os conceitos básicos do Power BI
Categoria Requisitos
Níveis de acesso - Membro do projeto
- Pelo menos no nível de acesso básico
Permissões - Permissões de análise
- A associação ao grupo de colaboradores fornece permissões necessárias
Ferramentas - Análise instalada e habilitada
- Quadros do Azure habilitados
- Power BI Desktop (versão mais recente recomendada)
Preparação – Noções básicas sobre conceitos de Análise
- Exibição de análise criada para suas necessidades de relatório
- Familiaridade com os conceitos básicos do Power BI

Importante

O Azure DevOps não dá suporte à autenticação de Credenciais Alternativas. Se você ainda estiver usando credenciais alternativas, recomendamos que você mude para um método de autenticação mais seguro.

Criar um novo relatório e conectar-se ao Azure DevOps

Siga estas etapas para criar um novo relatório do Power BI e estabelecer uma conexão com seus dados do Azure DevOps Analytics:

  1. Abra o Power BI Desktop e crie um novo relatório:

    • Iniciar o Power BI Desktop em seu computador
    • Se a tela de inicialização for exibida, selecione Obter dados
    • Se você já estiver no Power BI Desktop, selecione Home>Get Data na faixa de opções

    Captura de tela do Power BI Desktop com a opção Obter dados realçada na tela de inicialização e na faixa de opções Página Inicial.

  2. Localize o conector do Azure DevOps:

    • Na caixa de diálogo Obter Dados , selecione Serviços Online
    • Procure sua instância do Azure DevOps
    • Selecione o conector apropriado e selecione Conectar

    Se você não vir o conector do Azure DevOps na categoria Serviços Online:

    • Verifique se você tem a versão mais recente do Power BI Desktop instalada
    • Pesquisar "Azure DevOps" na caixa de pesquisa na parte superior da caixa de diálogo Obter Dados
    • Procure na outra categoria se não estiver nos Serviços Online

    Captura de tela da caixa de diálogo Obter Dados do Power BI com os Serviços Online selecionados e o conector do Azure DevOps (somente Placas) realçado.

Conectar-se a uma exibição de Análise

Siga estas etapas para conectar a uma visão do Analytics:

  1. Abra o Power BI Desktop.

  2. Entre no serviço. O acesso pela primeira vez exige que você entre e autentique suas credenciais. O Power BI Desktop salva suas credenciais, portanto, você só precisa entrar uma vez.

    Observação

    O Azure DevOps não dá suporte a cenários entre locatários que usam OAuth (Autorização Aberta). Em vez disso, use entidades de serviço e identidades gerenciadas.

  3. Selecione Conectar.

    Captura de tela que mostra a janela de diálogo de Conexão do Power BI, com uma mensagem sobre estar logado e o botão Conectar realçado.

  4. Selecione Obter Dados>Serviços Online e, em seguida, selecione Azure DevOps (somente Quadros) para serviços de nuvem ou Azure DevOps Server (somente Quadros) para um servidor local. Selecione Conectar. As visualizações de análise dão suporte a consultas apenas para itens de trabalho e casos de teste.

    Captura de tela do Power BI com Obter dados, Serviços Online e os serviços do Azure DevOps realçados.

  5. Especifique os parâmetros básicos para se conectar aos seus dados.

    Captura de tela da caixa de diálogo Azure DevOps (somente Boards). Os campos de projeto Organização e Equipe estão realçados.

    Captura de tela da caixa de diálogo do Servidor do Azure DevOps (apenas Boards). Os campos URL de Coleção e Projeto de Equipe, assim como o botão OK, estão destacados.

    • URL da coleção: insira a URL em que a instância do Servidor do Azure DevOps está hospedada. Um exemplo de URL é https://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
    • Projeto de equipe: insira apenas o nome do projeto. Por exemplo, digite Fabrikam-Fiber caso a URL da instância do Azure DevOps Server seja https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber.

    Importante

    Não confunda o nome da equipe com o nome do projeto, o que é um erro comum. Por exemplo, se a URL usada for https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git for o nome do projeto e Dispositivo for o nome da equipe.

    Depois de entrar com êxito, o Power BI verifica se suas credenciais têm as permissões necessárias para acessar o projeto especificado. Para obter soluções para problemas comuns, consulte Solução de problemas.

Selecione a exibição Análise

Siga estas etapas para selecionar o modo de exibição de análise:

  1. Expanda Exibições Compartilhadas. O Conector de Dados apresenta uma lista de visualizações de análise disponíveis. Cada exibição representa um conjunto de dados que você pode efetuar pull no Power BI. Você também pode criar exibições personalizadas do Analytics.

    A imagem a seguir mostra as exibições padrão do Analytics. Sua lista de exibições pode ser diferente com base no modelo de processo usado para criar seu projeto. Todas as exibições listadas, exceto as exibições acrescentadas ao Today, fornecem dados de tendência históricos.

    Captura de tela da caixa de diálogo Navegador. A pasta Exibições Compartilhadas é realçada e expandida, com várias exibições padrão visíveis.

  2. Selecione os Itens de Trabalho – Exibição dos últimos 30 dias e aguarde até que a visualização seja carregada. Essa exibição usa um filtro para mostrar os últimos 30 dias de histórico para todos os itens de trabalho no projeto.

    Observação

    Se você verificar a visualização ao criá-la, ela deverá ser carregada. Se a exibição não for carregada, é mais provável que o conjunto de dados seja muito grande. Retorne à página de visualizações do Analytics no portal da web e abra a visualização para edição. Ajuste os filtros para diminuir o tamanho do conjunto de dados.

    Captura de tela da caixa de diálogo Navegador. O modo de exibição Itens de Trabalho – Últimos 30 dias está selecionado e realçado e sua visualização está visível.

    Observação

    • A visualização mostrada para qualquer exibição selecionada no navegador pode ser truncada dependendo do número de campos selecionados e do tamanho do conjunto de dados. Os dados são truncados apenas para a visualização e não afetam a atualização de dados completa.
    • As exibições de análise não aplicam filtros definidos usando o Power BI no servidor. Todos os filtros aplicados no Power BI limitam os dados mostrados aos usuários finais, mas não reduzem a quantidade de dados recuperados do Analytics. Se o filtro for destinado a reduzir o tamanho do conjunto de dados, aplique-o personalizando a exibição.
  3. Marque a caixa de seleção ao lado do modo de exibição Histórias – Últimos 30 dias e selecione Carregar. Aguarde o carregamento dos dados. Monitore seu progresso por meio das mensagens de status exibidas sob o nome da tabela. Para obter soluções para problemas comuns, consulte Solução de problemas.

    Captura de tela da janela do modo de exibição Histórias – Últimos 30 Dias. Um anel de progresso parcial e uma mensagem de Avaliação estão visíveis.

  4. Examine o modelo de dados. Enquanto o modelo é carregado, examine o esquema do conjunto de dados para o Conector de Dados do Power BI.

Criar relatórios e dashboards

Depois de carregar com êxito seus dados do Analytics, você pode criar vários relatórios e visualizações:

Introdução à criação de relatório

  1. Explore seus dados: examine os campos importados e entenda a estrutura de dados
  2. Planejar suas visualizações: identificar as principais métricas e KPIs que você deseja acompanhar
  3. Criar relatórios iniciais: comece com gráficos simples e adicione gradualmente complexidade
  4. Testar e iterar: validar seus relatórios com os stakeholders e refinar conforme necessário

Tipos de relatório comuns

  • Tendências do item de trabalho: acompanhar relatórios de bugs, histórias de usuário e progresso de recursos ao longo do tempo
  • Gráficos de burndown de sprint: monitorar o progresso do sprint e a velocidade da equipe
  • Métricas de desempenho da equipe: analisar taxa de transferência, tempo de ciclo e taxas de conclusão
  • Análise de lista de pendências: Visualizar a distribuição de trabalho e o alinhamento de prioridade

Para obter exemplos e modelos detalhados, consulte relatórios de exemplo com base em exibições de Análise.

Captura de tela do Power BI Desktop mostrando um relatório baseado em Análise com vários gráficos e métricas.

Práticas recomendadas

Para aproveitar ao máximo a integração do Power BI e do Analytics:

Otimização de desempenho

  • Filtrar suas exibições de Análise para incluir apenas os dados necessários
  • Usar intervalos de data apropriados para limitar o volume de dados
  • Atualizar dados regularmente, mas evitar frequência de atualização excessiva
  • Considere os agendamentos de atualização de dados que se alinham às suas necessidades de relatório

Design de relatório

  • Iniciar simples e adicionar complexidade gradualmente
  • Usar formatação e identidade visual consistentes em relatórios
  • Incluir contexto e explicações para métricas
  • Testar com personas de usuário diferentes para garantir a usabilidade

Governança de dados

  • Documente suas exibições de Análise e suas finalidades
  • Estabelecer políticas de atualização de dados e propriedade
  • Monitorar o uso e o desempenho do relatório
  • Manter controles de segurança e acesso

Resolução de problemas

Cenários de erro comuns

Conector do Azure DevOps não visível

Problema: não é possível localizar "Azure DevOps" na lista de fontes de dados no Power BI Desktop

Possíveis causas e soluções:

  1. Versão desatualizada do Power BI Desktop:

  2. Olhando na categoria errada:

    • Primeiro, verifique a categoria serviços online
    • Se não for encontrado, procure "Azure DevOps" usando a caixa de pesquisa
    • Tente procurar na Outros categoria como uma alternativa
  3. Disponibilidade regional:

    • Verifique se sua região do Power BI dá suporte ao conector do Azure DevOps
    • Contate o administrador se estiver usando o Power BI por meio do licenciamento organizacional
  4. Licenciamento do Power BI:

    • Verifique se você tem o licenciamento apropriado do Power BI
    • Algumas limitações de conector podem ser aplicadas com base na camada de licenciamento

O resultado da consulta excede o tamanho máximo

Mensagem de erro: "O resultado da consulta excede o tamanho máximo. Reduza o número de registros aplicando mais filtros"

Causa: o modo de exibição análise retorna mais de 250.000 registros.

Soluções:

  1. Reduzir o intervalo de tempo na exibição análise
  2. Aplicar mais filtros para limitar tipos de item de trabalho ou estados
  3. Usar várias exibições menores em vez de uma exibição grande
  4. Considere agregar dados em um nível mais alto

Captura de tela mostrando o erro de limite de tamanho da consulta com as etapas de resolução sugeridas.

Acesso negado ou erros de autenticação

Mensagem de erro: "O usuário não está autorizado" ou falhas de autenticação

Possíveis causas e soluções:

  • Verificar permissões de projeto: verifique se você tem acesso ao projeto do Azure DevOps
  • Validar permissões de Análise: verifique se você tem acesso ao Analytics
  • Examinar credenciais: trabalhe com o administrador para problemas de credencial
  • Autenticação do Microsoft Entra: verifique se sua conta está configurada corretamente

Captura de tela mostrando o erro de autenticação com diretrizes de solução de problemas.

Acesso à análise proibido

Mensagem de erro: "O acesso ao recurso é proibido"

Resolução: contate o administrador do projeto para conceder permissão de análise de exibição. Consulte a segurança do Analytics para obter detalhes.

Captura de tela mostrando o erro de acesso proibido do Analytics.

Projeto não encontrado

Mensagem de erro: "O Projeto 'X' não existe ou você não tem permissões para acessá-lo"

Causas comuns:

  • Nome do projeto incorreto: verifique se você está usando o nome do projeto, não o nome da equipe
  • Confusão de URL: para https://dev.azure.com/fabrikam/MyProject/MyTeam, use "MyProject" e não "MyTeam"
  • Permissões ausentes: verifique se você tem acesso ao projeto especificado

Captura de tela mostrando o erro do projeto não encontrado com a explicação dos nomes do projeto versus da equipe.

Lendo mensagens de erro

Ao solucionar problemas do Conector de Dados do Power BI, execute as seguintes tarefas:

  1. Procure a causa raiz: pesquisar [DataSource.Error] na mensagem de erro
  2. Ignorar o texto do wrapper: Concentre-se na descrição do erro principal
  3. Verificar ações sugeridas: mensagens de erro geralmente incluem etapas de resolução
  4. Verificar os pré-requisitos: garantir que todos os requisitos sejam atendidos