Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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:
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
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
Conectar-se a uma exibição de Análise
Siga estas etapas para conectar a uma visão do Analytics:
Abra o Power BI Desktop.
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.
Selecione Conectar.
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.
Especifique os parâmetros básicos para se conectar aos seus dados.
-
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.
-
URL da coleção: insira a URL em que a instância do Servidor do Azure DevOps está hospedada. Um exemplo de URL é
Selecione a exibição Análise
Siga estas etapas para selecionar o modo de exibição de análise:
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.
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.
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.
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.
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
- Explore seus dados: examine os campos importados e entenda a estrutura de dados
- Planejar suas visualizações: identificar as principais métricas e KPIs que você deseja acompanhar
- Criar relatórios iniciais: comece com gráficos simples e adicione gradualmente complexidade
- 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.
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:
Versão desatualizada do Power BI Desktop:
- Baixar e instalar a versão mais recente do Power BI Desktop
- O conector do Azure DevOps foi adicionado em versões posteriores
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
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
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:
- Reduzir o intervalo de tempo na exibição análise
- Aplicar mais filtros para limitar tipos de item de trabalho ou estados
- Usar várias exibições menores em vez de uma exibição grande
- Considere agregar dados em um nível mais alto
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
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.
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
Lendo mensagens de erro
Ao solucionar problemas do Conector de Dados do Power BI, execute as seguintes tarefas:
- Procure a causa raiz: pesquisar [DataSource.Error] na mensagem de erro
- Ignorar o texto do wrapper: Concentre-se na descrição do erro principal
- Verificar ações sugeridas: mensagens de erro geralmente incluem etapas de resolução
- Verificar os pré-requisitos: garantir que todos os requisitos sejam atendidos