Windows 플랫폼에서 스크립트를 사용하여 에이전트 설치/제거

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

사전 요구 사항

엔드포인트 VM을 VMware Aria Operations에서 사용할 수 있어야 합니다.
모든 사전 요구 사항을 완료합니다. 자세한 내용은 사전 요구 사항 항목을 참조하십시오.
엔드포인트 VM에서 압축 해제 패키지를 사용할 수 있어야 합니다.
사용자에게 다운로드 폴더에 대한 액세스 권한이 있어야 합니다.
Windows PowerShell은 5.0 이상이어야 합니다.
게스트 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 이상이어야 합니다.

프로시저

에이전트를 설치/제거하려는 엔드포인트 VM에 로그인하고 다음 위치에서 클라우드 프록시의 샘플 스크립트를 다운로드합니다. https://<CloudProxy>/downloads/salt/ telegraf-utils.ps1

스크립트 다운로드가 요청이 중단됨: SSL/TLS 보안 채널을 생성할 수 없습니다. 메시지와 함께 실패하는 경우 Windows 플랫폼에서 스크립트 다운로드 실패에 언급된 단계를 따르십시오.
다음 명령 중 하나를 실행합니다.
```
PowerShell command:
Invoke-WebRequest "https://<CloudProxy>/downloads/salt/telegraf-utils.ps1 " -OutFile telegraf-utils.ps1

Or if you have the wget tool:
wget --no-check-certificate https://<CloudProxy>/downloads/salt/telegraf-utils.ps1
```
참고: 앞의 명령 및 지정된 위치에서 <CloudProxy>에 대한 관련 클라우드 프록시 IP 주소를 사용합니다. 애플리케이션 모니터링 고가용성이 활성화된 수집기 그룹의 경우 가상 IP를 입력합니다.

스크립트를 실행하고 에이전트를 설치/제거하려면 다음 명령을 실행합니다.

telegraf-utils.ps1  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: .\telegraf-utils.ps1 product-managed -t 8dab02cc-277c-4383-b910-bd2e89c7e741::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인 병렬 에이전트 설치가 지원됩니다.