Executar alto volume Agent Client Collector upgrade

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 3 min. de leitura

    • Faça upgrade de alto volume do seu Agent Client Collector quando você deseja fazer upgrade de todos os seus agentes de uma só vez.

    Antes de Iniciar

    Configure o. Agent Client Collector servidor web. Para obter detalhes, consulte Configure o servidor websocket no MID Server.

    Certifique-se de que MID Server, MID Web Server e MID Server o servidor websocket está em execução.

    Selecione a versão para a qual você deseja fazer upgrade do agente.
    1. Navegar até Tudo > Propriedades do sistema > Todas as Propriedades.
    2. Selecione Novo.
    3. Atribua os seguintes valores:
      • Nome: sn_agent.agent_upgrade_version
      • Tipo: cadeia de caracteres
      • O número da versão para a qual será atualizado, no formato <major_version.minor_version.patch_version>. Por exemplo: 4.3.2
    4. Selecione Enviar.
    Se você não selecionar uma versão, o agente atualizará automaticamente para a atual Estrutura do Agent Client Collector versão do app com escopo.
    Funções necessárias: Agent_client_collector_admin
    • Em A. Windows Ambiente: Conta DO SISTEMA local
    • Em A. Linux ambiente: sudo rpm/dpkg
    • Em A. macOS ambiente: pacote sudo

    Por Que e Quando Desempenhar Esta Tarefa

    O upgrade de alto volume é compatível somente em um Windows ou Linux ambiente.

    O upgrade de alto volume não é compatível com Agent Client Collector. MID Server Comunicação via MTLS.

    Ao executar upgrade de alto volume, todos os agentes que não estão usando a versão mais atualizada são atualizados. Nenhum upgrade é realizado em agentes que já usam a versão atualizada.

    Nenhum upgrade é realizado em agentes que estão fora do escopo da aplicação. Para obter mais informações, consulte Application scope.

    Um agente é excluído do upgrade de alto volume quando você atinge o limite de upgrade com falha de um agente. O limite de upgrade com falha está especificado em sn_agent.auto_upgrade.retry_limitpropriedade do sistema. O valor padrão para esta propriedade é 3.
    • Esta propriedade se aplica a upgrades de alto volume e seletivos que falharam.
    • Quando um agente atinge o limite de upgrade com falha, um Agent Client Collector o administrador ainda pode executar o upgrade seletivo no agente.
    • Você pode redefinir manualmente o limite de upgrade com falha selecionando Redefina tentativas de upgrade com falha na página do agente (selecione Tudo > Agent Client Collector > Agentes e selecione um agente).
    • Após um upgrade bem-sucedido, o agente atualizado é considerado como sem upgrades com falha (para upgrades futuros).

    Procedimento

    1. Verifique se o número da versão para a qual você deseja fazer upgrade está disponível.
      1. Navegar até Tudo > Propriedades do sistema > Todas as Propriedades.
      2. Localize a propriedade sn_agent.agent_version.
        Verifique se o número da versão exibido é uma versão válida do agente, representando a versão para a qual o agente será atualizado. Se o número da versão não for válido, a versão será atualizada para sn_agent.agent_versionnúmero.
    2. Habilite a propriedade na tabela Propriedades do sistema (Tudo > Propriedades do sistema > Todas as Propriedades) para ativar o upgrade.
      1. Localize a propriedade sn_agent.auto_upgrade.enabled.
      2. Defina a propriedade valor como true.
        O upgrade começa em um minuto após habilitar a propriedade.

    Resultado

    • Para agentes conectados a um MID Server: O trabalho agendado atualiza 50 agentes em cada MID Server por hora. O número máximo de agentes que podem receber upgrade de uma vez para todos MID Serversé 1 000.
    • Para agentes MID less: O trabalho agendado faz upgrades de até 1 000 agentes por hora por padrão.
    • Para ambos MID Server E agentes MID-less: Para modificar o número de agentes que estão sendo atualizados por vez, atualize o valor de sn_agent.auto_upgrade.max_upgrades_per_handler_per_hourpropriedade (Tudo > Propriedades do sistema > Todas as Propriedades). O valor padrão é 1 000.
      Nota:
      Modificar este valor pode afetar negativamente o desempenho do sistema.

    Para modificar a frequência do upgrade, atualize o valor do Intervalo de repetição no Fazer upgrade de agentes de forma incremental trabalho agendado (Tudo > Definição do Sistema > Trabalhos agendados).