Instalar ou ativar o serviço Analytics

  • 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 Analytics está geralmente disponível. É ativado automaticamente para todas as novas coleções de projetos adicionadas ao servidor. Para coleções de projetos atualizadas a partir de uma versão anterior, poderá ter de a ativar manualmente. Ativa a Análise para cada coleção de projetos para a qual pretende gerar relatórios de Análise.

A Análise está em Pré-visualização para Azure DevOps Server 2019. Para Azure DevOps Server 2019, instale a extensão Analytics a partir do marketplace local para cada coleção de projetos que pretende utilizar a Análise. Para Azure DevOps Server 2019.1, ativa a Análise para cada coleção de projetos que pretende utilizar a Análise. Suportes de análise

Nota

A extensão do Marketplace de Análise e a Análise não são suportadas para o TFS 2018 ou versões anteriores.

A Análise suporta o acesso a widgets de Análise para todos os projetos definidos na coleção de projetos. Para saber mais, consulte O que é a 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:

Ativar Análise

Se atualizou para o Azure DevOps Server 2019.1, pode ativar a Análise para uma coleção de projetos com os seguintes passos. Caso contrário, para Azure DevOps Server 2019, consulte Instalar o Analytics.

Nota

A análise é ativada automaticamente para todas as coleções de projetos recentemente criadas.

  1. Num browser, selecione (1) a coleção de projetos, (2) Definições de Coleção ou definições de Administração e, em seguida, (3) Análise.

    Abrir o Collection> Administração settings>Analytics

  2. Selecione Ativar Análise.

    Ativar Análise

    Depois de ativadas, as tarefas de teste do Analytics começam a preencher as tabelas de dados do Analytics. Este processo pode demorar algum tempo, dependendo do tamanho da sua coleção. Para saber mais sobre as tabelas de dados, veja Modelo de dados de análise.

Colocar em pausa ou desativar a Análise

Se atualizou para o Azure DevOps Server 2019.1, pode colocar em pausa ou desativar a Análise de uma coleção de projetos com os seguintes passos. Caso contrário, para Azure DevOps Server 2019, as ações equivalentes são desativar ou desinstalar a extensão Analytics.

Só pode colocar em pausa ou desativar a Análise que tenha sido ativada anteriormente.

  1. Na página Definições de análise, selecione Colocar em Pausa Análise ou DesativarAnálise.

    Colocar em Pausa ou Desativar a Análise

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

    Caixa de diálogo Confirmar Pausa.Confirmar Desativar

Retomar Análise

Para Azure DevOps Server 2019.1, pode retomar a Análise depois de a colocar em pausa para uma coleção de projetos. Retomar o serviço irá reativar as tarefas de teste, que irão atualizar as tabelas de dados e torná-las atuais, atualizando desde a hora em que foi colocada em pausa.

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

    Ativar Análise

  2. Confirme que pretende retomar o serviço.

    Caixa de diálogo Confirmar Currículo.

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

O que acontece se colocar em pausa ou desativar a Análise?

Colocar a Análise em pausa ou desativar a extensão de Análise (2019), desativa as seguintes funcionalidades:

Colocar o Analytics em pausa preserva os seus dados, mas impede que as tarefas de teste atualizem os seus dados. Pode retomar o serviço mais tarde e os seus dados serão atualizados.

Desativar a Análise ou remover a extensão Análise (2019), desativa todas as tarefas de teste do Analytics e elimina os dados de Análise armazenados nas tabelas de Análise. Todos os dados do Analytics que captam tendências históricas perdem-se. Não elimina quaisquer outros dados armazenados na sua coleção. Não pode anular esta ação. Assim que os dados históricos e os dados populares forem eliminados, não poderá restaurá-lo. A reativação do Analytics não irá restaurar os dados históricos.

Com a Análise desativada ou removida, ocorrem as seguintes ações:

  • Não são executadas tarefas de teste e as tabelas do Analytics não terão informações atualizadas.
  • Os dados da tabela são eliminados e, se a Análise for reativada, todos os dados terão de ser repovoados do zero.

Nota

Desativar a Análise 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, veja Modelo de dados de análise.

Instalar a extensão do Analytics

Se ainda não atualizou para o Azure DevOps Server 2019.1, pode instalar a extensão Analytics para obter acesso a widgets e relatórios de Análise para a sua coleção de projetos. A extensão Analytics é enviada no instalador no local. Instalar a extensão permite simplesmente a funcionalidade. Não é necessário transferir manualmente ficheiros de extensão para instalar.

Dica

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

  1. Num browser, selecione (1) a coleção de projetos, (2) Administração definições e, em seguida, (3) Extensões.

    Abrir a Coleção> Administração definições>Extensões

  2. Selecione Procurar extensões locais.

    Procurar no marketplace local

    Nota

    A instalação da extensão a partir do marketplace local é idêntica à instalação a partir do marketplace alojado. A única diferença é que o marketplace alojado mostra as classificações de extensão e os comentários dos utilizadores.

  3. O Marketplace local é aberto num novo separador do browser. Selecione o cartão de extensão Análise.

    Cartão de extensão do Analytics

  4. Selecione Obter gratuitamente.

    Captura de ecrã da extensão do Marketplace de Análise, 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, verá uma imagem semelhante à seguinte. Selecione Continuar para a coleção para regressar ao portal Web da coleção.

    Captura de ecrã a mostrar a extensão do Marketplace de Análise instalada, Avançar para a coleção.

    Opcionalmente, se quiser instalar a extensão Análise noutras coleções de projetos, selecione o botão anterior do browser.

Desativar ou desinstalar a extensão do Analytics

Se optar por desativar a extensão de Análise, esta irá impedir a execução de quaisquer tarefas. Os dados de análise ficarão dessincronizados e as funcionalidades associadas não estarão disponíveis. No entanto, não são eliminados dados. Desinstalar a extensão de Análise elimina os dados das tabelas da base de dados do Analytics. Após a reinstalação da extensão, os dados são repovoados 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 da 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 de Análise da sua implementação, pode instalar a extensão a partir do marketplace online para restaurá-la. Poderá não conseguir utilizar o marketplace online devido à configuração do servidor. Por exemplo, a firewall pode bloquear algumas ligações de saída. Mesmo que seja esse o caso, pode restaurá-lo para o marketplace local com os seguintes passos.

  1. Abra as definições da Coleção ao seguir 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 a parte inferior da página e selecione Gerir Extensões.

    Gerir extensões

  3. Selecione Carregar extensão e, em seguida, clique para carregar. Navegue para 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 de camada de aplicação no seguinte caminho.

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

    Carregar a extensão restaura-a para o marketplace local. A partir daí, 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 marketplace local.

Pode determinar se a sua Azure DevOps Server está num estado desligado. Verifique se o ícone ligado e o nome do servidor aparecem na parte superior ao navegar no marketplace alojado.

Determinar se o servidor está ligado ou não

Quando navega para o Marketplace a partir do servidor no local, não é apresentado um erro se não estiver ligado. Muda simplesmente para o contexto do serviço cloud.

Problema conhecido

Se utilizar um URL público para instalar a extensão, por exemplo https://OnPrem.MyCompany.com, poderá receber um erro de chamada de retorno, como um erro de TLS/SSL.

Para resolver este problema, pode instalar a extensão a partir de um computador que aloja a camada da aplicação e aponte para o URL do computador local, por exemplo https://myMachineName.