Instalar ou ativar o serviço Analytics
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Para o Azure DevOps Server 2020 e versões posteriores, o serviço Analytics está disponível para o público em geral. Ele é habilitado automaticamente para todas as novas coleções de projetos adicionadas ao seu servidor. Para coleções de projetos atualizadas de uma versão anterior, talvez seja necessário habilitá-la manualmente. Você habilita o Google Analytics para cada coleção de projetos para a qual deseja gerar relatórios do Google Analytics.
O Google Analytics está em Visualização do Azure DevOps Server 2019. Para o Azure DevOps Server 2019, você instala a extensão do Google Analytics do seu mercado local para cada coleção de projetos que deseja usar o Google Analytics. Para o Azure DevOps Server 2019.1, você habilita o Google Analytics para cada coleção de projetos que deseja usar o Google Analytics. O Google Analytics oferece suporte
Observação
A extensão do Analytics Marketplace e o Google Analytics não são compatíveis com o TFS 2018 ou versões anteriores.
O Google Analytics oferece suporte ao acesso a widgets do Google Analytics para todos os projetos definidos na coleção de projetos. Para saber mais, consulte O que é Analytics? e Widgets baseados em Analytics. Os dados disponíveis no Google Analytics são resumidos em Dados disponíveis no Google Analytics.
Pré-requisitos
Para o Azure DevOps Server 2019.1:
- Você deve ter instalado e configurado seu Servidor de DevOps do Azure. Para obter detalhes, consulte Instalar e configurar o Azure DevOps local.
- Você deve ter adicionado pelo menos uma coleção de projeto. Para adicionar coleções de projeto, consulte Gerenciar coleções de projeto.
- Para habilitar, pausar, desabilitar ou retomar o Google Analytics, você deve ser 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:
- Você deve ter instalado e configurado seu Servidor de DevOps do Azure. Para obter detalhes, consulte Instalar e configurar o Azure DevOps local.
- Você deve ter adicionado pelo menos uma coleção de projeto. Para adicionar coleções de projeto, consulte Gerenciar coleções de projeto.
- Para instalar uma extensão, você deve ser membro do grupo Administradores da Coleção de Projetos com permissões 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, você deve ser membro do grupo Administradores do Servidor de DevOps do Azure com permissões Editar informações no nível da instância.
Habilitar Análise
Se você atualizou para o Azure DevOps Server 2019.1, poderá habilitar o Google Analytics para uma coleção de projetos com as etapas a seguir. Caso contrário, para o Azure DevOps Server 2019, consulte Instalar análises.
Observação
O Google Analytics é habilitado 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, (3) Análise.
Selecione Ativar análise.
Depois de habilitados, os trabalhos de preparo do Google Analytics começam a preencher as tabelas de dados do Google Analytics. Esse processo pode levar algum tempo, dependendo do tamanho da sua coleção. Para saber mais sobre as tabelas de dados, consulte Modelo de dados do Google Analytics.
Pausar ou desativar o Google Analytics
Se você atualizou para o Azure DevOps Server 2019.1, poderá pausar ou desabilitar o Google 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 Google Analytics que tenha sido habilitado anteriormente.
Na página Configurações do Google Analytics, selecione Pausar análise ou Desativar análise.
Confirme que você deseja pausar ou desabilitar o serviço.
Análise de currículos
Para o Azure DevOps Server 2019.1, você pode retomar o Google Analytics depois de pausá-lo para uma coleção de projetos. A retomada do serviço reativará os trabalhos de preparo, que atualizarão as tabelas de dados e as tornarão atuais, atualizando desde o momento em que foram pausadas.
Na página Configurações do Google Analytics , selecione Retomar análise.
Confirme que você deseja retomar o serviço.
Depois de habilitados, os trabalhos de preparo do Google Analytics começam a preencher as tabelas de dados do Google Analytics. Esse processo pode levar algum tempo, dependendo do tamanho da sua coleção.
O que acontece se eu pausar ou desativar o Google Analytics?
Pausar o Google Analytics ou desabilitar a extensão do Google Analytics (2019) desabilita os seguintes recursos:
- Widgets de análise
- Relatórios analíticos no contexto, como relatórios de pipeline e de teste
- Integração do Power BI usando modos de exibição do Google 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 seus dados serão atualizados.
Desabilitar o Google Analytics ou remover a extensão do Google Analytics (2019) desativa todos os trabalhos de preparo do Google Analytics e exclui os dados do Google Analytics armazenados nas tabelas do Google 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. Habilitar novamente o Analytics não restaurará os dados históricos.
Com o Analytics desabilitado ou removido, as seguintes ações ocorrem:
- Nenhum trabalho de preparo é executado e as tabelas de Análise não terão informações atualizadas.
- Os dados da tabela são excluídos e, se o Google Analytics for reativado, todos os dados terão que ser preenchidos novamente do zero.
Observação
Desabilitar a Análise no Azure DevOps Server 2019.1 é o mesmo que desinstalar a extensão do Analytics para o Azure DevOps Server 2019.
Para saber mais sobre as tabelas de dados, consulte Modelo de dados do Google Analytics.
Instalar a extensão do Google Analytics
Se você não atualizou para o Azure DevOps Server 2019.1, poderá instalar a extensão do Google Analytics para obter acesso aos widgets e relatórios do Google Analytics para sua coleção de projetos. A extensão do Google Analytics é fornecida no instalador local. A instalação da extensão simplesmente habilita a funcionalidade. Não há necessidade de baixar arquivos de extensão manualmente para instalar.
Dica
A extensão do Analytics aparece na galeria local do Servidor de DevOps do Azure para que não haja necessidade de baixá-la do Azure DevOps Marketplace.
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
A instalação da extensão a partir do marketplace local é idêntica à instalação a partir do marketplace hospedado. A única diferença é que o mercado hospedado mostra classificações de extensão e comentários de usuários.
O Marketplace local é aberto em uma nova guia do navegador. Selecione o cartão de extensão do Google Analytics.
Selecione Get it free.
Selecione a coleção de projetos e, em seguida, selecione Instalar.
Após a conclusão da instalação, você verá uma imagem semelhante à seguinte. Selecione Continuar para a coleção para retornar ao portal da Web da sua coleção.
Opcionalmente, se você quiser instalar a extensão do Google Analytics em outras coleções de projetos, selecione o botão Voltar do navegador.
Desativar ou desinstalar a extensão do Google 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 estarão fora de sincronia e os recursos associados não estarão disponíveis. No entanto, nenhum dado é excluído. A desinstalação da extensão do Google Analytics exclui os dados das tabelas do banco de dados do Google Analytics. Após a reinstalação da extensão, os dados são repovoados do zero.
Abra o menu de extensões e selecione Gerenciar extensões.
Na guia Gerenciar, abra o menu de atalho da extensão.
Selecione Desativar ou Desinstalar conforme necessário.
Restaurar a extensão do Google Analytics se for removida da implantação
Se você remover a extensão do Google Analytics de sua implantação, poderá instalá-la no mercado online para restaurá-la. Talvez você não consiga usar o mercado online devido à configuração do servidor. Por exemplo, o firewall pode bloquear algumas conexões de saída. Mesmo que seja esse o caso, você pode restaurá-lo para o mercado local usando as etapas a seguir.
Abra as configurações da Coleção seguindo as instruções fornecidas na seção Instalar a extensão do Google 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.
O arquivo .vsix pode ser encontrado 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.vsix
O upload da extensão restaura-a para o mercado local. A partir daí, você pode instalá-lo em uma coleção.
Como determinar se o servidor está desconectado?
Se o servidor estiver desconectado da Internet, você deverá instalar o Google Analytics a partir do mercado local.
Você pode determinar se o Servidor de DevOps do Azure está em um estado desconectado. Verifique se o ícone conectado e o nome do servidor aparecem na parte superior ao navegar no mercado hospedado.
Quando você navega para o Marketplace a partir do servidor local, um erro não é exibido se você não estiver conectado. Ele simplesmente alterna para o contexto do serviço de nuvem.
Problema conhecido
Se você usar uma URL pública 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
.
Artigos relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de