스크립트를 사용하여 엔드포인트 VM에 에이전트를 설치 또는 제거할 수 있습니다.

사전 요구 사항

  • 엔드포인트 VM을 VMware Aria Operations에서 사용할 수 있어야 합니다.
  • 모든 사전 요구 사항을 완료합니다. 자세한 내용은 사전 요구 사항 항목을 참조하십시오.
  • 엔드포인트 VM에서 압축 해제 패키지를 사용할 수 있어야 합니다.
  • 사용자에게 다운로드 폴더에 대한 액세스 권한이 있어야 합니다.
  • 게스트 IP는 올바르게 구성되어야 하며 vCenter Server 전체에서 고유합니다. vCenter Server 전체에 동일한 IP를 사용하는 둘 이상의 엔드포인트 VM이 모니터링되는 경우 스크립트에서 애플리케이션 모니터링을 확인하고 구독할 수 없습니다.
  • 엔드포인트 VM이 속하는 vCenter Server에 대해 클라우드 계정을 구성해야 합니다.
  • VMware Aria Operations의 포트 443은 엔드포인트 VM에 액세스할 수 있어야 합니다.
  • VMware Aria Operations 사용자는 다음 사용 권한을 가지고 있어야 합니다.
    • 관리 > REST-API > 다른 모든 읽기, 쓰기 API
    • 관리 > REST-API > API에 대한 읽기 액세스
    • 환경 > 애플리케이션 > Telegraf 에이전트 관리
    • 환경 > 작업 > 부트스트랩 가상 시스템
    • 환경 > 작업 > 부트스트랩 다운로드
    참고: 사용 권한을 확인하려면 관리 > 액세스 제어 > 역할로 이동한 후 사용자가 할당된 역할을 선택합니다. 페이지 끝의 오른쪽에서 사용 권한을 볼 수 있습니다.
  • 현재 클라우드 프록시에는 IPv4만 지원됩니다.
  • VMTools 버전은 10.2 이상이어야 합니다.

프로시저

  1. 에이전트를 설치/제거하려는 엔드포인트 VM에 로그인하고 다음 위치에서 클라우드 프록시의 샘플 스크립트를 다운로드합니다. https://<CloudProxy>/downloads/salt/telegraf-utils.sh
    다음 명령 중 하나를 실행합니다.
    wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.sh
    curl -k “https://<CloudProxy>/downloads/salt/telegraf-utils.sh” --output telegraf-utils.sh
    
    참고: 앞의 명령 및 지정된 위치에서 <CloudProxy>에 대한 관련 클라우드 프록시 IP 주소를 사용합니다. 애플리케이션 모니터링 고가용성이 활성화된 수집기 그룹의 경우 가상 IP를 입력합니다.
  2. 다음 명령을 실행하여 스크립트를 실행 가능하도록 만듭니다.
    chmod +x telegraf-utils.sh
  3. 스크립트를 실행하고 에이전트를 설치/제거하려면 다음 명령을 실행합니다.
    telegraf-utils.sh  product-managed -c cloud_proxy_ip_or_collector_group_name -t token (-v vmwareariaoperations_ip_or_fqdn | [-g gateway_url -a csp_auth_url]) [-d download_tmp_dir -s sleep_seconds -i list_of_IPs -o operation]
        
    Description of arguments:
          -c : [REQUIRED] cloud_proxy_ip_or_collector_group_name - Cloud Proxy IP or Collector Group Name
          -t : [REQUIRED] token - This can be user_saas_refresh_token or on-prem vmwareariaoperations_auth_token.
                
                on-prem: Auth Token of the user/account. For getting new token
                         ( https://<VMwareAriaOperations_IP>/suite-api/ or curl -ks -X POST https://<VMwareAriaOperations_IP>/suite-api/api/auth/token/acquire -H \"Content-Type: application/json\" -H \"Accept: application/json\" -d \"{\"username\":\"<VMwareAriaOperations_USER>\",\"password\":\"<VMwareAriaOperations_USER_PASSWORD>\"}\")
          -d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
          -v : [CONDITIONAL] [ON-PREM-SPECIFIC] vmwareariaoperations_ip_or_fqdn - IP/FQDN of VMware Aria Operations master node and required for on-prem.
          
          -o : [OPTIONAL] operation - The type of operation to be performed {install,uninstall} Default: install
          -s : [OPTIONAL] sleep_seconds - Time (in seconds) to delay the script execution. This optional parameter will be helpful when this script is used in vRA to have agent installed on deploying VM. Recommended time 600 seconds.
          -i : [OPTIONAL] list_of_IPs - This is an optional parameter. Comma separated IPs that are set as properties of a VM in VMware Aria Operations (VM -> Properties -> Network -> <Integer> -> IP Address). If single adapter has multiple IP Addresses, then delimit them using '_'
                        ex:- If your VM has 3 adapters with IP Address as follows: Adapter1: 10.0.0.1 Adapter2: 10.0.0.2 & 10.0.0.3 Adapter3: 10.0.0.4
                        Then this parameter should be given as "10.0.0.1,10.0.0.2_10.0.0.3,10.0.0.4"
    
    Example: /bin/bash telegraf-utils.sh product-managed -t 8dab02cc-277c-4392-b910-bd2e98c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101
    참고: 도우미 스크립트를 실행하려면 -c 인수가 필수입니다.

    부트스트랩 상태를 확인하려면 uaf-bootstrap-results 파일을 봅니다. 설치가 실패하면 uaf_bootstrap.log의 오류 메시지를 찾습니다.

    스크립트가 성공한 경우 5~10분이 소요되는 한 번의 수집 주기 후 Telegraf 에이전트 관리 탭에서 에이전트 상태가 업데이트됩니다.

    참고: 자동화 스크립트를 사용하는 경우, 배치 크기가 20인 병렬 에이전트 설치가 지원됩니다.