Conectar o Google Analytics com o Power BI Data Connector

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Neste artigo, você aprenderá a estabelecer uma conexão perfeita entre o Power BI e o Azure DevOps usando o Data Connector. Essa integração permite extrair insights valiosos de seus dados de DevOps do Azure e criar relatórios atraentes no Power BI. O Power BI Data Connector usa modos de exibição do Google Analytics.

Importante

As exibições de análise só dão suporte a dados de Azure Boards (itens de trabalho). As exibições do Google Analytics não oferecem suporte a 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 item de trabalho. Neste ponto, não temos planos de atualizar o conector para dar suporte a outros tipos de dados. Para obter informações sobre outras abordagens, leia a Visão geral da integração do Power BI.

Pré-requisitos

• Familiarize-se com o que é Analytics e a base de dados de conhecimento dos artigos do Power BI.
• Instale a Atualização de outubro de 2018 do Power BI Desktopou uma versão mais recente.
• Certifique-se de que você foi adicionado como membro do projeto. Se não estiver, seja adicionado agora. Qualquer pessoa com acesso ao projeto, exceto os stakeholders, pode exibir exibições do Analytics.
• Certifique-se de que as Placas estejam ativadas. Caso contrário, as visualizações do Google Analytics não serão exibidas . Para reativar Boards, consulte Ativar ou desativar um serviço de DevOps do Azure.
• Verifique se você tem as permissões necessárias para acessar o Google Analytics. Se você for membro do grupo Colaboradores do projeto, terá permissão.
• Crie uma exibição de Análise que você deseja criar um relatório do Power BI.

Importante

O Azure DevOps não dá mais suporte à autenticação de Credenciais Alternativas desde o início de 2 de março de 2020. Se você ainda estiver usando Credenciais Alternativas, recomendamos que você alterne para um método de autenticação mais seguro (por exemplo, tokens de acesso pessoal). Saiba mais.

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

1. Abra o Power BI Desktop.

2. Entre no serviço. Após o acesso pela primeira vez, você precisará entrar e ter suas credenciais autenticadas. Escolha entre o Windows ou o Token de Acesso Pessoal para autenticar. O Power BI Desktop salva suas credenciais para que você só precise fazer isso uma vez.

3. Selecione Conectar após a verificação de suas credenciais.

   

4. Selecione Obter Serviços Online de Dados>, Azure DevOps (somente placas) para serviços de nuvem ou selecione Servidor de DevOps do Azure (somente placas) para local. Depois, selecione Conectar. As exibições de análise só dão suporte a consultas em itens de trabalho e casos de teste.

   

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

   

   Importante

   Não confunda o nome da equipe com o nome do projeto, que é um erro comum. Por exemplo, se a URL que você usa é http://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device, então Fabrikam-Fiber-Git é o nome do projeto e Device é o nome da equipe.

   Após a entrada bem-sucedida, o Power BI verifica se suas credenciais de usuário têm permissões para acessar o projeto especificado. Se surgirem erros, consulte a seção de perguntas e respostas para obter respostas para os problemas mais comuns.

Selecione a exibição Análise

1. Expanda a pasta Modos de Exibição Compartilhados , selecione um modo de exibição do Google Analytics e selecione Carregar. O Conector de Dados apresenta uma lista de exibiçõ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 visualizações padrão do Google Analytics. Sua lista de modos de exibição pode ser diferente com base no modelo de processo usado para criar seu projeto. Todos os modos de exibição listados, exceto os modos de exibição anexados com "Hoje", fornecem dados de tendência histórica.

   Aqui você seleciona Histórias - Últimos 30 dias, que filtra itens da lista de pendências do produto.

   

   Observação

   Como você verificou a exibição na seção anterior, a exibição deve ser carregada. Se o modo de exibição não carregar, é mais provável que o conjunto de dados seja muito grande. Retorne à exibição na exibição Análise no portal da Web e ajuste os filtros para diminuir o tamanho do conjunto de dados.

2. Selecione o modo de exibição.

   

   Observação

   A visualização mostrada para quaisquer exibições selecionadas 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 afetarão a atualização completa dos dados.

   • Selecione a tabela Itens de Trabalho - Hoje e aguarde o carregamento da visualização. Ele representa o estado atual de todos os itens de trabalho no projeto.
   • Marque a caixa de seleção ao lado da tabela Itens de Trabalho - Hoje e selecione Carregar.

   Observação

   Os modos de exibição 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. Aguarde o carregamento dos dados. Você pode observar seu progresso examinando as mensagens status, que aparecem diretamente sob o nome da tabela. Se você vir algum erro, consulte a seção Perguntas e respostas para obter respostas para os problemas mais comuns.

   

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

Criar seu relatório

Crie relatórios com base nos dados carregados. Depois que a operação de carga for concluída, você poderá explorar os dados criando relatórios personalizados. Para obter exemplos de relatórios comuns, consulte Data Connector - Exemplos de relatórios.

Perguntas e respostas

Encontre respostas para perguntas comuns sobre o Power BI Data Connector e as mensagens de erro do Google Analytics.

P: Como devo ler mensagens de erro provenientes do conector?

R: Você pode se sentir desafiado a ler mensagens de erro provenientes do conector porque elas geralmente contêm informações contextuais extras. Se a operação de carregamento falhar, a mensagem começará com "Falha ao salvar modificações no servidor...". Quando você vê-lo, procure [DataSource.Error] Azure DevOps...:. O exemplo a seguir mostra a mensagem de erro retornada do conector. A parte mais importante da mensagem de erro é "O resultado da consulta excede o tamanho máximo. Reduza o número de registros aplicando filtros adicionais."

P: Como resolvo o "O resultado da consulta excede o tamanho máximo. Reduzir o número de registros aplicando filtros adicionais" erro?

R: Você receberá o seguinte erro se o número de registros recuperados do Google Analytics exceder 250.000:

"Falha ao salvar modificações no servidor. Erro retornado: 'Erro OLE DB ou ODBC: [DataSource.Error] VSTS: Falha na solicitação: o servidor remoto retornou um erro: (400) Solicitação incorreta. (O resultado da consulta excede o tamanho máximo. Por favor, reduza o número de registros aplicando filtros adicionais).'"

Esse erro normalmente ocorre quando seu projeto tem um grande número de itens de trabalho. Reduza o tamanho do conjunto de dados personalizando a exibição. Execute esta etapa antes de usá-la no Power BI.

P: Como resolvo o erro "o usuário não foi autorizado"?

R: Você pode receber esse erro se tentar acessar um projeto para o qual não tem permissões. Você também poderá vê-lo se o Power BI não reconhecer suas credenciais. Para marcar suas permissões, consulte Definir permissões para acessar as exibições de Análise e Análise. Se for um problema de credencial, trabalhe com o administrador para ver se ele pode ajudar a resolver o problema. Para obter mais informações, consulte Segurança do Power BI, autenticação de usuário e Solução de problemas de entrada do Power BI.

Observação

O Power BI usa a ID do Microsoft Entra para autenticar usuários que entram no serviço do Power BI e, por sua vez, usa as credenciais de entrada do Power BI sempre que um usuário tenta acessar recursos que exigem autenticação. Os usuários entram no serviço do Power BI usando o endereço de email usado para estabelecer sua conta do Power BI. O Power BI usa esse email de entrada como o nome de usuário efetivo, que é passado para recursos sempre que um usuário tenta se conectar a dados. O nome de usuário efetivo é mapeado para um nome principal de usuário e resolvido para a conta de domínio do Windows associada, na qual a autenticação é aplicada.

P: Como resolvo o erro "O acesso ao recurso é proibido"?

R: Você pode receber esse erro se tiver acesso a um projeto específico, mas não tiver as permissões Exibir análise . Trabalhe com o administrador do projeto para obter essas permissões. Para obter mais informações sobre o modelo de segurança, consulte Segurança de análise.

P: Como resolvo o erro "Projeto 'X' não existe ou você não tem permissões para acessá-lo"?

Um: Esse erro indica que o valor inserido para Nome do projeto não corresponde a nenhum projeto. Um erro comum que os usuários cometem é confundir o nome do projeto com um nome de equipe.

Por exemplo, se a URL usada for https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device, então Fabrikam-Fiber-Git será o nome do projeto e deverá ser usado no parâmetro. Device é o nome da equipe.

Artigos relacionados

• Permissões necessárias para acessar o Analytics
• Visão geral da integração do Power BI
• Segurança de análise
• Autenticar sua identidade com tokens de acesso pessoal
• Design de conjunto de dados para o Power BI Data Connector
• Conector de Dados – Relatórios de exemplo