Instalar ou habilitar o serviço de Análise

  • Artigo

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. Ele é 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.

A análise está em versão prévia para Azure DevOps Server 2019. Para Azure DevOps Server 2019, instale a extensão análise do marketplace local para cada coleção de projetos que deseja usar o Analytics. Para Azure DevOps Server 2019.1, você habilita o Analytics para cada coleção de projetos que deseja usar o Analytics. Suporte à análise

Observação

A extensão do Analytics Marketplace e a Análise não têm suporte para o TFS 2018 ou versões anteriores.

O Analytics dá suporte ao acesso a widgets do Analytics para todos os projetos definidos na coleção de projetos. Para saber mais, confira O que é Análise? e Widgets com base na Análise. Os dados disponíveis na Análise são resumidos em Dados disponíveis na Análise.

Pré-requisitos

Para Azure DevOps Server 2019.1:

Para Azure DevOps Server 2019:

Habilitar Análise

Se você tiver atualizado 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 Azure DevOps Server 2019, consulte Instalar Análise.

Observação

A análise é habilitada 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 de Coleção ou Administração configurações e, em seguida, (3) Análise.

    Open Collection> Administração settings Analytics>

  2. Selecione Habilitar Análise.

    Habilitar Análise

    Depois de habilitados, os trabalhos de preparo do Analytics começam a preencher as tabelas de dados do 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 de análise.

Pausar ou desabilitar Análise

Se você tiver atualizado para o 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 Azure DevOps Server 2019, as ações equivalentes serão desabilitar ou desinstalar a extensão de Análise.

Você só pode pausar ou desabilitar a Análise que foi habilitada anteriormente.

  1. Na página Configurações de análise, selecione Pausar Análise ou Desabilitar Análise.

    Pausar ou desabilitar análise

  2. Confirme se deseja pausar ou desabilitar o serviço.

    Caixa de diálogo Confirmar Pausa.Confirmar Desabilitar

Retomar Análise

Para Azure DevOps Server 2019.1, você pode retomar o Analytics depois de pausar para uma coleção de projetos. Retomar o serviço habilitará novamente os trabalhos de preparo, que atualizarão as tabelas de dados e as tornarão atuais, atualizando desde o momento em que ele foi pausado.

  1. Na página Configurações de análise , selecione Retomar Análise.

    Habilitar Análise

  2. Confirme se deseja retomar o serviço.

    Confirme a caixa de diálogo Retomar.

    Depois de habilitados, os trabalhos de preparo do Analytics começam a preencher as tabelas de dados do Analytics. Esse processo pode levar algum tempo dependendo do tamanho da sua coleção.

O que acontece se eu pausar ou desabilitar o Analytics?

Pausar o Analytics ou desabilitar a extensão de Análise (2019), desabilita os seguintes recursos:

Pausar Análise preserva seus dados, mas impede que trabalhos de preparo atualizem seus dados. Você pode retomar o serviço mais tarde e seus dados serão atualizados.

Desabilitar a Análise ou remover a extensão de Análise (2019), desativa todos os trabalhos de preparo do Analytics e exclui os dados de Análise armazenados nas tabelas de Análise. 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 a Análise estiver habilitada novamente, todos os dados precisarão ser repovoados do zero.

Observação

Desabilitar o Analytics no Azure DevOps Server 2019.1 é o mesmo que desinstalar a extensão de Análise para Azure DevOps Server 2019.

Para saber mais sobre as tabelas de dados, consulte Modelo de dados de análise.

Instalar a extensão do Analytics

Se você não tiver atualizado para o Azure DevOps Server 2019.1, poderá instalar a extensão análise para obter acesso a widgets e relatórios do Analytics para sua coleção de projetos. A extensão analytics é enviada dentro do instalador local. Instalar a extensão simplesmente habilita a funcionalidade. Não é necessário baixar arquivos de extensão manualmente para instalar.

Dica

A extensão Análise aparece na galeria local para Azure DevOps Server para que não haja necessidade de baixá-la do Azure DevOps Marketplace.

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

    Extensões de configurações>do Open Collection> Administração

  2. Selecione Procurar extensões locais.

    Procurar o marketplace local

    Observação

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

  3. O Marketplace local é aberto em uma nova guia do navegador. Selecione a extensão análise cartão.

    Cartão de extensão de análise

  4. Selecione Obter gratuitamente.

    Captura de tela da extensão do Marketplace do Analytics, 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, você verá uma imagem semelhante à seguinte. Selecione Prosseguir para a coleção para retornar ao portal da Web para sua coleção.

    Captura de tela da extensão do Marketplace do Analytics instalada, Prossiga para a coleção.

    Opcionalmente, se você quiser instalar a extensão Análise 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 desabilitar a extensão análise, ela impedirá a execução de todos os trabalhos. Os dados de análise estarão fora de sincronia e os recursos associados não estarão disponíveis. No entanto, nenhum dado é excluído. Desinstalar a extensão análise exclui os dados das tabelas de 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 tela da guia Gerenciar extensões.

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

  3. Selecione Desabilitar ou Desinstalar conforme necessário.

Restaurar a extensão de Análise se removida da implantação

Se você remover a extensão análise de sua implantação, poderá instalar a extensão do marketplace online para restaurá-la. Talvez você não consiga usar o marketplace online devido à configuração do servidor. Por exemplo, o firewall pode bloquear algumas conexões de saída. Mesmo que esse seja o caso, você pode restaurá-lo para o marketplace local usando as etapas a seguir.

  1. Abra as configurações de Coleção seguindo as instruções fornecidas na seção Instalar a extensão análise.

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

  2. Role até a parte inferior da página e selecione Gerenciar Extensões.

    Gerenciar extensões

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

    Carregar extensão

    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

    Carregar a extensão a restaura no marketplace 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 do marketplace local.

Você pode determinar se o Azure DevOps Server está em um estado desconectado. Verifique se o ícone conectado e o nome do servidor aparecem na parte superior ao navegar no marketplace hospedado.

Determinar se o servidor está conectado ou não

Quando você navega para o Marketplace 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 resolve esse problema, você pode instalar a extensão de um computador que hospeda a camada de aplicativo e apontar para a URL do computador local, por exemplohttps://myMachineName.