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 e 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á-las manualmente. O Analytics deve ser ativado para cada coleção de projetos para a qual pretende gerar relatórios do Analytics.

O Analytics está em Pré-visualização para o Azure DevOps Server 2019. Para o Azure DevOps Server 2019, instala a extensão do Analytics do seu mercado local para cada coleção de projetos em que pretende utilizar o Analytics. Para o Azure DevOps Server 2019.1, ativa o Analytics para cada coleção de projetos em que pretende utilizar o Analytics. Suportes do Analytics

Nota

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

O Analytics suporta o acesso a 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 são resumidos em Dados disponíveis no Analytics.

Pré-requisitos

Para o Azure DevOps Server 2019.1 e superior:

Para o Azure DevOps Server 2019:

Ativar o Analytics

Se você atualizou para o Azure DevOps Server 2019.1, poderá 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 Analytics é ativado automaticamente para todas as coleções de projetos criadas recentemente.

  1. A partir de um browser, selecione (1) a coleção de projetos, (2) Definições da Coleção ou Definições de administrador e, em seguida, (3) Analytics.

    Abrir a Coleção>Definições do administrador>Analytics

  2. Selecione Ativar o Analytics.

    Ativar o Analytics

    Depois de ativado, as tarefas de teste do Analytics começam a preencher as tabelas de dados do Analytics. Esse processo pode demorar algum tempo, consoante o tamanho da sua coleção. Para obter mais informações sobre as tabelas de dados, consulte Modelo de dados do Analytics.

Colocar em pausa ou desativar o Analytics

Se você atualizou para o Azure DevOps Server 2019.1, poderá pausar ou desabilitar o Analytics para uma coleção de projetos com as etapas a seguir. De outro modo, para o Azure DevOps Server 2019, as ações equivalentes são Desativar ou desinstalar a extensão do Analytics.

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

  1. Na página de definições do Analytics, selecione Colocar em pausa o Analytics ou Desativar o Analytics.

    Colocar em Pausa ou Desativar o Analytics

  2. Confirme que pretende colocar em pausa ou desativar o serviço.

    Caixa de diálogo Confirmar Pausa. Confirmar Desativar

Retomar o 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 reativa trabalhos de preparação, que atualizam as tabelas de dados e as tornam atuais, atualizando desde o momento em que foi pausado.

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

    Ativar o Analytics

  2. Confirme que pretende retomar o serviço.

    Caixa de diálogo Confirmar Retoma.

    Depois de ativado, as tarefas de teste do Analytics começam a preencher as tabelas de dados do Analytics. Esse processo pode demorar algum tempo, consoante o tamanho da sua coleção.

O que acontece se colocar em pausa ou desativar o Analytics?

Quando você pausa ou desabilita a extensão do Google Analytics (2019), os seguintes recursos são desativados:

Ao colocar em pausa o Analytics conserva os seus dados, mas impede que as tarefas de teste atualizem os seus dados. Você pode retomar o serviço mais tarde e, em seguida, suas atualizações de dados.

Quando você desabilita ou remove a extensão do Google Analytics (2019), ela 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 serão perdidos. Não elimina quaisquer outros dados armazenados na sua coleção. Não é possível anular esta ação. Depois de os dados históricos e os dados de tendência serem eliminados, não será possível restaurá-los. A reativação do Google Analytics não restaura os dados históricos.

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

  • Nenhum trabalho de preparo é executado e as informações das tabelas do Google Analytics não são atualizadas.
  • Os dados da tabela são excluídos e, se o Google Analytics for reativado, todos os dados deverão ser preenchidos novamente do zero.

Nota

Desativar o Analytics no Azure DevOps Server 2019.1 é o mesmo 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 do Analytics.

Instalar a extensão do Analytics

Se você não atualizou para o Azure DevOps Server 2019.1, pode 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 Analytics é fornecida no interior do instalador no local. A instalação da extensão simplesmente ativa a funcionalidade. Não é necessário transferir os ficheiros de extensão manualmente para instalar.

Gorjeta

A extensão do Analytics aparece na galeria local do Azure DevOps Server para que não seja necessário transferi-la a partir do Azure DevOps Marketplace.

  1. A partir de um browser, selecione (1) a coleção de projetos, (2) Definições de administrador e, em seguida, (3) Extensões.

    Abrir Coleção>Definições do administrador>Extensões

  2. Selecione Procurar extensões locais.

    Procurar 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 aloja apresenta as classificações da extensão e os comentários de utilizadores.

  3. O mercado local é aberto num novo separador do browser. Selecione o cartão de extensão do Analytics.

    Cartão de extensão do 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.

    Selecionar a coleção de projetos

  6. Após a conclusão da instalação, uma imagem semelhante à seguinte é exibida. Selecione Prosseguir para a coleção para voltar ao portal Web para a sua coleção.

    Captura de ecrã da extensão do Analytics Marketplace instalada. Prosseguir para a coleção.

    Opcionalmente, se pretender instalar a extensão do Analytics noutras coleções de projetos, selecione o botão Voltar do browser.

Desativar 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 Google Analytics estão fora de sincronia e os recursos associados não estão disponíveis. No entanto, nenhum dado é eliminado. A desinstalação da extensão do Analytics elimina os dados das tabelas da base 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 Gerir extensões.

    Captura de ecrã do separador Gerir extensões.

  2. No separador Gerir, abra o menu de atalho para a extensão.

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

Restaurar a extensão do Analytics se for removida da implementação

Se remover a extensão do Analytics da sua implementação, poderá instalar a extensão a partir do mercado online para a restaurar. Poderá não conseguir utilizar o mercado online devido à configuração do servidor. Por exemplo, a sua firewall pode bloquear algumas ligações de saída. Mesmo que este seja o caso, pode restaurá-lo para o mercado local executando os passos seguintes.

  1. Abra as Definições da coleção seguindo as instruções fornecidas na secção Instalar a extensão do Analytics.

    Selecione Extensões e, em seguida, Procurar extensões locais.

  2. Desloque-se para o fundo da página e selecione Gerir Extensões.

    Gerir extensões

  3. Selecione Carregar extensão e, em seguida, selecione clique para carregar. Navegue até a pasta que contém o ficheiro Microsoft.TeamFoundation.Extension.Analytics.vsix.

    Carregar extensão

    O ficheiro .vsix pode ser encontrado na instalação da pasta da camada de aplicação no caminho seguinte.

    C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsix

    Ao carregar a extensão restaura-a para o mercado local. A partir daqui, pode instalá-la numa coleção.

Como determinar se o servidor está desligado?

Se o servidor estiver desligado da Internet, tem de instalar o Analytics a partir do mercado local.

Pode determinar se o Azure DevOps Server está no estado desligado. Verifique se o ícone ligado e o nome do servidor são apresentados na parte superior ao navegar no mercado alojado.

Determinar se o servidor está ou não ligado

Quando navega para o mercado a partir do servidor no local, um erro não será apresentado se não estiver ligado. Simplesmente muda para o contexto do serviço cloud.

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 este problema, pode instalar a extensão a partir de uma máquina que aloja a camada da aplicação e apontar para o URL da máquina local, por exemplo https://myMachineName.