대용량 에이전트 클라이언트 수집기 업그레이드 수행

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 3분

    • 모든 에이전트를 한 번에 업그레이드하려는 경우 에이전트의 에이전트 클라이언트 수집기 대량 업그레이드를 수행합니다.

    시작하기 전에

    에이전트 클라이언트 수집기 웹 서버를 구성합니다. 자세한 내용은 MID 서버에서 웹소켓 서버 구성 문서를 참조하십시오.

    , MID 웹 서버및 MID 서버 웹소켓 서버가 실행 중인지 MID 서버확인하십시오.

    에이전트를 업그레이드할 버전을 선택합니다.
    1. 다음으로 이동 모두 > 시스템 속성 > 모든 속성.
    2. 새로 만들기를 선택합니다.
    3. 다음 값을 할당합니다.
      • 이름 = sn_agent.agent_upgrade_version
      • 유형 = 문자열
      • 값 = 업그레이드할 버전 번호(<major_version.minor_version.patch_version> 형식) 예: 4.3.2
    4. 제출을 선택합니다.
    버전을 선택하지 않으면 에이전트가 현재 에이전트 클라이언트 수집기 프레임워크 범위가 지정된 앱 버전으로 자동 업그레이드합니다.
    필요한 역할: agent_client_collector_admin
    • Windows 환경에서: 로컬 SYSTEM 계정
    • Linux 환경에서: sudo rpm/dpkg
    • macOS 환경에서: sudo pkg

    이 태스크 정보

    대용량 업그레이드는 OR Linux 환경에서만 Windows 지원됩니다.

    대용량 업그레이드는 mTLS를 MID 서버 통한 통신을 지원하지 에이전트 클라이언트 수집기 않습니다.

    대용량 업그레이드를 수행할 때 최신 버전을 사용하지 않는 모든 에이전트가 업그레이드됩니다. 업그레이드된 버전을 이미 사용 중인 에이전트에서는 업그레이드가 수행되지 않습니다.

    애플리케이션 범위를 벗어난 에이전트에서는 업그레이드가 수행되지 않습니다. 자세한 내용은 Application scope 문서를 참조하십시오.

    에이전트의 업그레이드 실패 제한에 도달하면 에이전트는 대용량 업그레이드에서 제외됩니다. 실패한 업그레이드 제한은 시스템 속성에 sn_agent.auto_upgrade.retry_limit 지정되어 있습니다. 이 속성의 기본값은 3입니다.
    • 이 속성은 실패한 대용량 업그레이드와 선택적 업그레이드 모두에 적용됩니다.
    • 에이전트가 업그레이드 실패 제한에 도달해도 에이전트 클라이언트 수집기 관리자는 에이전트에서 선택적 업그레이드를 계속 실행할 수 있습니다.
    • 에이전트 페이지에서 실패한 업그레이드 시도 재설정 옵션을 선택하여 실패한 업그레이드 제한을 수동으로 재설정할 수 있습니다( 모두 > 에이전트 클라이언트 수집기 > 에이전트 을 클릭하고 에이전트 선택).
    • 업그레이드에 성공한 후 업그레이드된 에이전트는 업그레이드 실패가 0건(향후 업그레이드의 경우)이 없는 것으로 간주됩니다.

    프로시저

    1. 업그레이드할 버전 번호를 사용할 수 있는지 확인합니다.
      1. 다음으로 이동 모두 > 시스템 속성 > 모든 속성.
      2. 속성을 찾습니다 sn_agent.agent_version .
        표시된 버전 번호가 에이전트가 업그레이드될 버전을 나타내는 유효한 에이전트 버전인지 확인합니다. 버전 번호가 잘못되면 버전이 해당 번호로 업데이트됩니다 sn_agent.agent_version .
    2. 시스템 속성 테이블에서 속성을 활성화합니다(모두 > 시스템 속성 > 모든 속성)을 클릭하여 업그레이드를 활성화합니다.
      1. 속성을 찾습니다 sn_agent.auto_upgrade.enabled .
      2. 속성 값을 true로 설정합니다.
        속성을 활성화한 후 1분 이내에 업그레이드가 시작됩니다.

    결과

    • 에 연결된 MID 서버에이전트의 경우: 예약된 작업은 시간당 각각 MID 서버 50개의 에이전트를 업그레이드합니다. 모든 MID 서버 에이전트에 대해 한 번에 업그레이드할 수 있는 최대 에이전트 수는 1,000개입니다.
    • MID 없는 에이전트의 경우: 예약된 작업은 기본적으로 시간당 최대 1,000명의 에이전트를 업그레이드합니다.
    • 에이전트 및 MID가 없는 에이전트 모두 MID 서버 의 경우: 한 번에 업그레이드되는 에이전트 수를 수정하려면 속성 값 sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour (모두 > 시스템 속성 > 모든 속성). 기본값은 1,000입니다.
      주:
      이 값을 수정하면 시스템 성능에 부정적인 영향을 줄 수 있습니다.

    업그레이드 빈도를 수정하려면 업그레이드 에이전트 증분 예약 작업(모두 > 시스템 정의 > 예약된 작업).