Partilhar via


Conectar o Google Analytics ao Power BI Data Connector

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

Saiba como estabelecer uma conexão perfeita entre o Power BI e o Azure DevOps usando o Power BI Data Connector. Essa integração permite extrair informações valiosas de seus dados de DevOps do Azure e criar relatórios e painéis atraentes no Power BI usando modos de exibição do Google Analytics.

Importante

As vistas do Analytics suportam apenas dados do Azure Boards (itens de trabalho). As vistas do Analytics não suportam outros tipos de dados, como pipelines. Os modos de exibição fornecem uma lista simples de itens de trabalho e não oferecem suporte a hierarquias de itens de trabalho. Neste ponto, não há planos para atualizar o conector para suportar outros tipos de dados. Para obter informações sobre outras abordagens, consulte Acerca da integração do Power BI.

O Power BI Data Connector fornece uma conexão direta com o Azure DevOps Analytics, permitindo que você execute as seguintes tarefas:

  • Importar vistas do Analytics para o Power BI Desktop
  • Crie relatórios personalizados com dados de DevOps do Azure em tempo real
  • Crie painéis interativos para as partes interessadas
  • Acompanhe as métricas do projeto e o desempenho da equipe
  • Visualize tendências de itens de trabalho e progresso de sprint

Pré-requisitos

Certifique-se de atender aos seguintes requisitos antes de conectar o Power BI ao Azure DevOps Analytics:

Categoria Requerimentos
Níveis de acesso - Membro do projeto
- Pelo menos nível de acesso básico
Permissões - Permissões do Google Analytics
- A associação ao grupo de colaboradores fornece as permissões necessárias
Ferramentas - Azure Boards habilitado
- Power BI Desktop (versão mais recente recomendada)
Preparação - Compreensão dos conceitos de Analytics
- Vista do Analytics criada para as suas necessidades de relatórios
- Familiaridade com os fundamentos do Power BI
Categoria Requerimentos
Níveis de acesso - Membro do projeto
- Pelo menos nível de acesso básico
Permissões - Permissões do Google Analytics
- A associação ao grupo de colaboradores fornece as permissões necessárias
Ferramentas - Analytics instalado e ativado
- Azure Boards habilitado
- Power BI Desktop (versão mais recente recomendada)
Preparação - Compreensão dos conceitos de Analytics
- Vista do Analytics criada para as suas necessidades de relatórios
- Familiaridade com os fundamentos 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 mude para um método de autenticação mais seguro.

Crie um novo relatório e ligue-se ao Azure DevOps

Siga estes passos para criar um novo relatório Power BI e estabelecer uma ligação aos seus dados Azure DevOps Analytics:

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

    • Inicie o Power BI Desktop no seu computador
    • Se aparecer o ecrã de arranque, selecione Obter dados
    • Se já estiveres no Power BI Desktop, seleciona Home>Obter Dados na fita

    Captura de ecrã do Power BI Desktop com a opção Obter dados destacada no ecrã de arranque e na fita Home.

  2. Encontre o conector Azure DevOps:

    • No diálogo Obter Dados , selecione Serviços Online
    • Encontre a sua instância Azure DevOps
    • Selecione o conector apropriado e depois selecione Ligar

    Se não vir o conector Azure DevOps na categoria de Serviços Online:

    • Certifique-se de que tem a versão mais recente do Power BI Desktop instalada
    • Procure por "Azure DevOps" na caixa de pesquisa no topo do diálogo Obter Dados
    • Procure na categoria Outros se não estiver em Serviços Online

    Captura de ecrã do diálogo Power BI Get Data com os Serviços Online selecionados e o conector Azure DevOps (apenas Boards) destacado.

Conectar-se a uma visualização do Google Analytics

Siga estas etapas para se conectar a uma visualização do Google Analytics:

  1. Abra Power BI Desktop.

  2. Inicie sessão no serviço. O acesso pela primeira vez exige que você entre e autentique suas credenciais. O Power BI Desktop guarda as suas credenciais, pelo que só tem de iniciar sessão uma vez.

    Nota

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

  3. Selecione Ligar.

    Captura de tela que mostra o diálogo de Conexão do Power BI, com a mensagem sobre estar autenticado e o botão Conectar destacado.

  4. Selecione Obter Dados>Serviços Online e, em seguida, selecione Azure DevOps (apenas Painéis) para serviços de nuvem ou Azure DevOps Server (apenas Painéis) para um servidor local. Selecione Ligar. As visualizações de análises permitem consultas apenas em elementos de trabalho e casos de teste.

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

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

    Captura de ecrã da caixa de diálogo Azure DevOps (apenas painéis). Os campos Organização e Projeto de equipe são realçados.

    Captura de ecrã da caixa de diálogo do Azure DevOps Server (apenas quadros). Os campos URL da coleção e Projeto de equipa e o botão OK estão realçados.

    • URL de Coleta: insira a URL onde sua instância do Servidor de DevOps do Azure está hospedada. Um exemplo de URL é https://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
    • Projeto de equipe: insira apenas o nome do projeto. Por exemplo, insira Fabrikam-Fiber se a URL da sua instância do Azure DevOps Server for https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber.

    Importante

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

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

Selecione a visualização do Google Analytics

Siga estas etapas para selecionar a visualização do Google Analytics:

  1. Expanda Visualizações compartilhadas. O Conector de Dados apresenta uma lista de visualizações disponíveis do Google Analytics. Cada modo de exibição representa um conjunto de dados que você pode extrair para o Power BI. Também pode criar vistas personalizadas do Analytics.

    A imagem a seguir mostra as visualizações padrão do Google Analytics. Sua lista de exibições pode diferir com base no modelo de processo usado para criar seu projeto. Todas as visualizações listadas, exceto as visualizações anexadas com Hoje, fornecem dados de tendências históricas.

    Captura de ecrã da caixa de diálogo Navegador. A pasta Vistas Partilhadas é realçada e expandida, com várias vistas predefinidas visíveis.

  2. Selecione a visualização Itens de Trabalho - Últimos 30 dias e aguarde o carregamento da visualização. Essa exibição usa um filtro para mostrar os últimos 30 dias do histórico de todos os itens de trabalho no projeto.

    Nota

    Se você verificar o modo de exibição ao criá-lo, o modo de exibição deverá ser carregado. Se a exibição não carregar, é mais provável que seja porque o conjunto de dados é muito grande. Regresse à página de vistas do Analytics no portal Web e abra a vista para edição. Ajuste os filtros para diminuir o tamanho do conjunto de dados.

    Captura de ecrã da caixa de diálogo do Navegador. A vista Itens de Trabalho - Últimos 30 dias está selecionada e realçada, e a sua pré-visualização é visível.

    Nota

    • A pré-visualização apresentada para qualquer vista 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 completa dos dados.
    • As exibições do Google Analytics 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 Google Analytics. Se o filtro se destinar a reduzir o tamanho do conjunto de dados, aplique-o personalizando a exibição.
  3. Marque a caixa de seleção ao lado da visualização Histórias - Últimos 30 dias e selecione Carregar. Aguarde até que os dados sejam carregados. Monitore seu progresso através das mensagens de status exibidas sob o nome da tabela. Para obter soluções para problemas comuns, consulte Solução de problemas.

    Captura de ecrã da janela de carregamento para a vista Histórias - Últimos 30 Dias. Um anel de progresso parcial e uma mensagem de Avaliação são visíveis.

  4. Analise o modelo de dados. Enquanto o modelo é carregado, revise o design do conjunto de dados para o Power BI Data Connector.

Criar relatórios e painéis

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

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

  1. Explore seus dados: revise os campos importados e entenda a estrutura de dados
  2. Planeje suas visualizações: identifique as principais métricas e KPIs que você deseja acompanhar
  3. Crie relatórios iniciais: comece com gráficos simples e adicione complexidade gradualmente
  4. Teste e itere: valide seus relatórios com as partes interessadas e refine conforme necessário

Tipos comuns de relatórios

  • Tendências de itens de trabalho: acompanhe relatórios de bugs, histórias de usuários e progresso de recursos ao longo do tempo
  • Gráficos de burndown do Sprint: monitore o progresso do sprint e a velocidade da equipe
  • Métricas de desempenho da equipe: analise a taxa de transferência, o tempo de ciclo e as taxas de conclusão
  • Análise de backlog: Visualize a distribuição do trabalho e o alinhamento de prioridades

Para obter exemplos e modelos detalhados, consulte Exemplos de relatórios baseados em visualizações do Google Analytics.

Captura de ecrã do Power BI Desktop a mostrar um relatório baseado no Analytics com vários gráficos e métricas.

Melhores práticas

Para tirar o máximo partido da sua integração com o Power BI e o Analytics:

Otimização do desempenho

  • Filtre suas visualizações do Google Analytics para incluir apenas os dados necessários
  • Usar intervalos de datas apropriados para limitar o volume de dados
  • Atualize os dados regularmente, mas evite a frequência excessiva de atualização
  • Considere agendas de atualização de dados alinhadas às suas necessidades de relatórios

Design de relatório

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

Governação de dados

  • Documente suas visualizações do Google Analytics 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

Solução de problemas

Cenários de erro comuns

Conector do Azure DevOps não está visível

Problema: Não consigo encontrar "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. Procurar na categoria errada:

    • Verifique primeiro a categoria de Serviços Online
    • Se não for encontrado, procure por "Azure DevOps" usando a caixa de pesquisa
    • Tenta procurar na categoria Outros como plano B
  3. Disponibilidade regional:

    • Garanta que a sua região Power BI suporta o conector Azure DevOps
    • Contacte o seu administrador se estiver a usar Power BI através de licenciamento organizacional
  4. Licenciamento Power BI:

    • Verifique se tem a licença adequada para o Power BI
    • Algumas limitações do conector podem aplicar-se consoante o nível de licenciamento

O resultado da consulta excede o tamanho máximo

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

Causa: sua visualização do Google Analytics retorna mais de 250.000 registros.

Soluções:

  1. Reduzir o intervalo de tempo na visualização do Google Analytics
  2. Aplique mais filtros para limitar os tipos ou estados dos itens de trabalho
  3. Utilizar várias vistas mais pequenas em vez de uma vista grande
  4. Considere a agregação de dados em um nível mais alto

Captura de ecrã a mostrar o erro de limite de tamanho da consulta com passos de resolução sugeridos.

Acesso negado ou erros de autenticação

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

Causas e soluções possíveis:

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

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

Acesso ao Google Analytics proibido

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

Resolução: entre em contato com o administrador do projeto para conceder permissão de análise de exibição . Consulte Segurança do Google Analytics para obter detalhes.

Captura de ecrã a mostrar o erro proibido de acesso ao Analytics.

Projeto não encontrado

Mensagem de erro: "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 erro de projeto não encontrado com explicação de nomes de projeto vs equipe.

Ler mensagens de erro

Ao solucionar problemas do Power BI Data Connector, execute as seguintes tarefas:

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