Partilhar via

Instalar ou ativar o serviço Analytics

  • Artigo

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 em geral. Ele é ativado 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á-las manualmente. Você habilita o Google Analytics para cada coleção de projetos para a qual deseja gerar relatórios do Google Analytics.

O Analytics está em Pré-visualização para o 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 Analytics. Para o Azure DevOps Server 2019.1, você habilita o Analytics para cada coleção de projetos que deseja usar o Analytics. Suportes do Google Analytics

Nota

A extensão do Analytics Marketplace e o Analytics não são suportados para o TFS 2018 ou versões anteriores.

O Google Analytics suporta o acesso a widgets do Google Analytics para todos os projetos definidos na coleção de projetos. Para saber mais, consulte O que é o Google Analytics e Widgets baseados no Google 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:

Para o Azure DevOps Server 2019:

Ativar Análise

Se você atualizou para o Azure DevOps Server 2019.1, pode habilitar o Analytics para uma coleção de projetos com as etapas a seguir. Caso contrário, para o Azure DevOps Server 2019, consulte Instalar o Analytics.

Nota

O Google Analytics é ativado automaticamente para todas as coleções de projetos recém-criadas.

  1. Em um navegador da Web, selecione (1) a coleção de projetos, (2) Configurações da coleção ou Configurações de administrador e, em seguida, (3) Análise.

    Abrir o Google Analytics Configurações>de administrador de coleção>

  2. Selecione Ativar análise.

    Ativar Análise

    Depois de ativados, os trabalhos de preparação 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, pode 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 Google Analytics.

Você só pode pausar ou desativar o Google Analytics que tenha sido ativado anteriormente.

  1. Na página Configurações do Google Analytics, selecione Pausar o Google Analytics ou Desativar o Google Analytics.

    Pausar ou desativar o Google Analytics

  2. Confirme que deseja pausar ou desativar o serviço.

    Confirme a caixa de diálogo Pausar. Confirmar Desativar

Retomar o Google Analytics

Para o Azure DevOps Server 2019.1, você pode retomar o Google Analytics depois de pausá-lo para uma coleção de projetos. Retomar o serviço reativará os trabalhos de preparação, que atualizarão as tabelas de dados e as tornarão atuais, atualizando desde o momento em que foram pausadas.

  1. Na página Configurações do Google Analytics , selecione Retomar o Google Analytics.

    Ativar Análise

  2. Confirme que deseja retomar o serviço.

    Confirme a caixa de diálogo Retomar.

    Depois de ativados, os trabalhos de preparação 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 desativar a extensão do Google Analytics (2019) desativa os seguintes recursos:

Pausar o Google Analytics preserva seus dados, mas impede que trabalhos de preparação atualizem seus dados. Pode retomar o serviço mais tarde e os seus dados serão atualizados.

Desativar 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 Google Analytics que capturam tendências históricas são perdidos. Não elimina quaisquer outros dados armazenados na sua coleção. Não é possível anular esta ação. Depois que os dados históricos e os dados de tendência forem excluídos, você não poderá restaurá-los. A reativação do Google Analytics não restaurará os dados históricos.

Com o Google Analytics desativado ou removido, ocorrem as seguintes ações:

  • Nenhum trabalho de preparo é executado e as tabelas do Google Analytics 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.

Nota

Desabilitar o Analytics 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 tiver atualizado 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 dentro do instalador local. A instalação da extensão simplesmente permite a funcionalidade. Não há necessidade de baixar arquivos de extensão manualmente para instalar.

Gorjeta

A extensão do Google Analytics aparece na galeria local do Servidor de DevOps do Azure para que não seja necessário baixá-la do Azure DevOps Marketplace.

  1. Em um navegador da Web, selecione (1) a coleção de projetos, (2) Configurações de administrador e, em seguida, (3) Extensões.

    Abrir extensões de configurações>de administrador de coleção>

  2. Selecione Procurar extensões locais.

    Navegue no mercado local

    Nota

    A instalação da extensão a partir do mercado local é idêntica à instalação a partir do mercado alojado. A única diferença é que o mercado hospedado mostra classificações de extensão e comentários de usuários.

  3. O Marketplace local é aberto em uma nova guia do navegador. Selecione o cartão de extensão do Google Analytics.

    Cartão de extensão do Google Analytics

  4. Selecione Obter gratuitamente.

    Captura de ecrã da extensão do Analytics Marketplace, selecione Obter gratuitamente.

  5. Selecione a coleção de projetos e, em seguida, selecione Instalar.

    Selecione a coleção de projetos

  6. 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 para sua coleção.

    Captura de ecrã da extensão do Analytics Marketplace instalada, Prosseguir para a recolha.

    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 Google 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 Analytics. Após a reinstalação da extensão, os dados são preenchidos novamente do zero.

  1. Abra o menu de extensões e selecione Gerenciar extensões.

    Captura de ecrã do separador Gerir extensões.

  2. Na guia Gerenciar, abra o menu de atalho para a extensão.

  3. Selecione Desativar ou Desinstalar, conforme necessário.

Restaure a extensão do Google Analytics se removida da implantação

Se você remover a extensão do Google Analytics da sua implantação, poderá instalá-la do mercado online para restaurá-la. Poderá não conseguir utilizar o mercado online devido à configuração do servidor. Por exemplo, seu firewall pode bloquear algumas conexões de saída. Mesmo que esse seja o caso, você pode restaurá-lo para o mercado local usando as etapas a seguir.

  1. 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.

  2. Desloque-se para a parte inferior da página e selecione Gerir Extensões.

    Gerenciar extensões

  3. 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.

    Extensão de upload

    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 carregamento 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 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.

Determinar se o servidor está conectado ou não

Quando você navega para o Marketplace a partir do servidor local, um erro não será exibido se você não estiver conectado. Ele simplesmente muda 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.