Instalar ou ativar o serviço do Analytics
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Para Azure DevOps Server 2020 e versões posteriores, o serviço de Análise está em disponibilidade geral e habilitado automaticamente para todas as novas coleções de projetos adicionadas ao servidor. Para coleções de projetos atualizadas de uma versão anterior, talvez seja necessário habilitá-la manualmente. Você habilita o Analytics para cada coleção de projetos para a qual deseja gerar relatórios do Analytics.
O Analytics está em versão prévia para o Azure DevOps Server 2019. Para Azure DevOps Server 2019, você instala a extensão do Analytics do marketplace local para cada coleção de projetos em que você deseja usar o Analytics. Para Azure DevOps Server 2019.1, você habilita o Analytics para cada coleção de projetos em que você deseja usar o Analytics. Suporte para Analytics
Observação
Não há suporte para a extensão Analytics Marketplace e o Analytics no TFS 2018 ou versões anteriores.
O Analytics oferece suporte ao acesso aos widgets do Analytics para todos os projetos definidos na coleção de projetos. Para obter mais informações, consulte O que é o Analytics? e Widgets baseados no Analytics. Os dados disponíveis no Analytics estão resumidos em Dados disponíveis no Analytics.
Pré-requisitos
Para Azure DevOps Server 2019.1 e superior:
- Ter Azure DevOps Server instalado e configurado.
- Tenha uma coleção de projetos.
- Permissões: para ativar, pausar, desativar ou retomar o Analytics, seja membro do grupo Administradores de Coleção de Projetos com permissões Editar informações no nível da coleção.
Para o Azure DevOps Server 2019:
- Ter Azure DevOps Server instalado e configurado.
- Tenha uma coleção de projetos.
- Permissões:
- Ser membro do grupo Administradores de Coleção de Projetos com a permissão Editar informações no nível da coleção. Se você não tiver permissões, poderá solicitar extensões .
- Para carregar uma extensão, seja membro do grupo Azure DevOps Server Administradores com a permissão Editar informações no nível da instância.
Habilitar Analytics
Se você atualizou para Azure DevOps Server 2019.1, poderá habilitar o Analytics para uma coleção de projetos com as etapas a seguir. Caso contrário, consulte Instalar o Analytics para o Azure DevOps Server 2019.
Observação
O Analytics é ativado automaticamente para todas as coleções de projetos recém-criadas.
Em um navegador da Web, selecione (1) a coleção de projetos, (2) Configurações de coleção ou Configurações de administrador e, em seguida, Analytics.
Selecione Habilitar Analytics.
Depois de habilitados, os trabalhos de preparo do Analytics começam a preencher as tabelas de dados. Esse processo pode levar algum tempo dependendo do tamanho da sua coleção. Para obter mais informações sobre as tabelas de dados, consulte Modelo de dados de Analytics.
Pausar ou desabilitar o Analytics
Se você atualizou para Azure DevOps Server 2019.1, poderá pausar ou desabilitar o Analytics para uma coleção de projetos com as etapas a seguir. Caso contrário, para o Azure DevOps Server 2019, as ações equivalentes são desabilitar ou desinstalar a extensão do Analytics.
Você só pode pausar ou desativar o Analytics ativado anteriormente.
Na página de configurações do Analytics, selecione Pausar Analytics ou Desabilitar Analytics.
Confirme que deseja pausar ou desabilitar o serviço.
Retomar Analytics
Para Azure DevOps Server 2019.1, você pode retomar o Analytics depois de pausá-lo para uma coleção de projetos. A retomada do serviço reabilita os trabalhos de preparo, que atualizam as tabelas de dados e as tornam atuais, atualizando desde o momento em que foi pausado.
Na página de configurações de Analytics, selecione Retomar Analytics.
Confirme que deseja retomar o serviço.
Depois de habilitados, os trabalhos de preparo do Analytics começam a preencher as tabelas de dados. Esse processo pode levar algum tempo dependendo do tamanho da sua coleção.
O que acontece se eu pausar ou desabilitar Analytics?
Quando você pausa ou desativa a extensão do Google Analytics (2019), os seguintes recursos são desativados:
- Widgets do Analytics
- Relatórios contextuais do Analytics, como relatórios de pipeline e teste
- Integração do Power BI usando exibições do Analytics
- Consultas de ponto de extremidade OData
Pausar o Analytics preserva seus dados, mas impede que os trabalhos de preparo atualizem seus dados. Você pode retomar o serviço mais tarde e, em seguida, atualizar seus dados.
Quando você desativa ou remove a extensão do Analytics (2019), ela desativa todos os trabalhos de preparo do Analytics e exclui os dados do Analytics armazenados nas tabelas do Analytics. Todos os dados do Analytics que capturam tendências históricas são perdidos. Ele não exclui nenhum outro dado armazenado em sua coleção. Essa ação não pode ser desfeita. Depois que dados históricos e dados de tendência são excluídos, você não pode restaurá-los. A reativação do Google Analytics não restaura os dados históricos.
Com o Analytics desabilitado ou removido, as seguintes ações ocorrem:
- Nenhum trabalho de preparo é executado e as informações das tabelas do Analytics não são atualizadas.
- Os dados da tabela são excluídos e, se o Analytics for reativado, todos os dados deverão ser preenchidos novamente do zero.
Observação
Desabilitar o Analytics no Azure DevOps Server 2019.1 funciona da mesma forma que desinstalar a extensão do Analytics para o Azure DevOps Server 2019.
Para obter mais informações sobre as tabelas de dados, consulte Modelo de dados de Analytics.
Instalar a extensão do Analytics
Se você não atualizou para Azure DevOps Server 2019.1, poderá instalar a extensão do Analytics para obter acesso aos widgets e relatórios do Analytics para sua coleção de projetos. A extensão do Analytics é fornecida no instalador local. Basta instalar a extensão, e ela já será habilitada. Não há necessidade de baixar arquivos de extensão manualmente para instalar.
Dica
A extensão do Analytics aparece na galeria local do Azure DevOps Server para que não haja necessidade de baixá-la do Marketplace do Azure DevOps.
Em um navegador da Web, selecione (1) a coleção de projetos, (2) Configurações de administrador e, em seguida, (3) Extensões.
Selecione Procurar extensões locais.
Observação
Instalar a extensão a partir do marketplace local funciona da mesma forma que do marketplace hospedado. A única diferença é que o marketplace hospedado mostra avaliações e comentários de usuários sobre a extensão.
O Marketplace local é aberto em uma nova guia do navegador. Selecione o cartão de extensão do Analytics.
Selecione Get it free.
Selecione a coleção de projetos e Instalar.
Após a conclusão da instalação, uma imagem semelhante às seguintes é exibida. Selecione Prosseguir para a coleta para retornar ao portal da Web da sua coleção.
Como alternativa, se você quiser instalar a extensão do Analytics em outras coleções de projetos, selecione o botão Voltar do navegador.
Desabilitar ou desinstalar a extensão do Analytics
Se você optar por desativar a extensão do Google Analytics, ela interromperá a execução de todos os trabalhos. Os dados do Analytics estão fora de sincronia e os recursos associados não estão disponíveis. No entanto, nenhum dado é excluído. Desinstalar a extensão do Analytics exclui os dados das tabelas do banco de dados do Analytics. Após a reinstalação da extensão, os dados são preenchidos novamente.
Abra o menu de extensões e selecione Gerenciar Extensões.
Na guia Gerenciar, abra o menu de atalho da extensão.
Selecione Desabilitar ou Desinstalar, conforme necessário.
Restaurar a extensão do Analytics se removida da implantação
Se você remover a extensão do Analytics da sua implantação, poderá instalá-la no marketplace online para restaurar. Você pode não conseguir usar o mercado online devido à configuração do servidor. Por exemplo, seu firewall pode bloquear algumas conexões de saída. Mesmo que seja esse o caso, você pode restaurar no marketplace local usando as etapas a seguir.
Abra Configurações de coleção seguindo as instruções fornecidas na seção Instalar a extensão do Analytics.
Selecione Extensões e, em seguida Procurar extensões locais.
Role até a parte inferior da página e selecione Gerenciar Extensões.
Selecione Carregar extensão e, em seguida, selecione clique para carregar. Navegue até a pasta que contém o arquivo Microsoft.TeamFoundation.Extension.Analytics.vsix.
Encontre o arquivo .vsix na instalação da pasta da camada de aplicativo no caminho a seguir.
C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsixCarregar a extensão a restaura no marketplace local. Nele, você pode instalar a extensão em uma coleção.
Como determinar se o seu servidor está desconectado?
Se o servidor estiver desconectado da Internet, você precisará instalar o Analytics no marketplace local.
Você pode determinar se Azure DevOps Server está em um estado desconectado verificando se o ícone conectado e o nome do servidor aparecem na parte superior ao navegar no marketplace hospedado.
Quando você navega para o Marketplace a partir do servidor local, um erro não é exibido caso não haja conexão. O contexto do serviço de nuvem é aberto diretamente.
Problema conhecido
Se você usar um URL público para instalar a extensão, por exemplo https://OnPrem.MyCompany.com, poderá receber um erro de retorno de chamada, como um erro TLS/SSL.
Para resolver esse problema, você pode instalar a extensão de uma máquina que hospeda a camada de aplicativo e apontar para a URL da máquina local, por exemplo, https://myMachineName.