스크립트를 사용하여 대상 시스템에 에이전트를 설치하거나 제거할 수 있습니다.

사전 요구 사항

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

프로시저

  1. 에이전트를 설치/제거하려는 대상 시스템에 로그인하고 다음 위치에서 클라우드 프록시의 샘플 스크립트를 다운로드합니다. 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. Cloud Service 포털의 다음 위치에서 현재 조직과 연결된 사용자의 새로 고침 토큰을 생성합니다. 사용자/조직 설정 > 내 계정 > API 토큰 > 새 API 토큰 생성
  4. 스크립트를 실행하고 에이전트를 설치/제거하려면 다음 명령을 실행합니다. 
    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.
            saas: CSP Refresh Token of the user/account. For getting new token, follow - User/
                  Organization Settings >> My Account >> API Tokens >> Generate a New API Token.
                  Example: gi7lwabjnvdfiawt4watzksuol8sywrjvg8kabh31mx9x1guepgyhycyx61dqrpq
            
      -d : [OPTIONAL] download_tmp_dir - Temporary directory for agent installation. Default: current directory
     
      -g : [OPTIONAL] [SAAS-SPECIFIC] gateway_url - argument to override default VMware Aria Operations SaaS gateway URL
      -a : [OPTIONAL] [SAAS-SPECIFIC] csp_auth_url - argument to override default CSP authentication URL
      -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-4383-b910-bd2e89c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101
    참고: 도우미 스크립트를 실행하려면 -c 인수가 필수입니다.
    참고: 기본 게이트웨이 URL은 https://www.mgmt.cloud.vmware.com/vrops-cloud이고 기본 인증 URL은 https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize입니다. 인증 URL 및 게이트웨이 URL이 기본 설정과 다른 경우 적절한 인수(-g 및 -a)를 제공하십시오.
    부트스트랩 상태를 확인하려면 uaf-bootstrap-results 파일을 봅니다. 설치가 실패하면 uaf_bootstrap.log의 오류 메시지를 찾습니다.

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

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