スクリプトを使用して、ターゲット マシンにエージェントをインストールまたはアンインストールできます。

前提条件

  • すべての前提条件を満たします。詳細については、「前提条件」を参照してください。
  • 解凍パッケージは、ターゲット マシンで使用できる必要があります。
  • ユーザーにダウンロード フォルダへのアクセス権限が必要です。
  • クラウド アカウントは、仮想マシンが属する vCenter Server 用に構成されている必要があります。
    注: この前提条件は、 vCenter Server クラウド アカウントによって管理されている仮想マシンにのみ適用されます。オブジェクト タイプの詳細については、 OSとアプリケーションの監視を参照してください。
  • vCenter Server クラウド アカウントによって管理されている仮想マシンは、VMware Aria Operations で使用できる必要があります。
    注: この前提条件は、 vCenter Server クラウド アカウントによって管理されている仮想マシンにのみ適用されます。
  • ゲスト IP アドレスが適切に構成され、vCenter Server 全体で一意である必要があります。同じ IP アドレスを持つ複数の仮想マシンが vCenter Server クラウド アカウントによって管理されている場合、スクリプトは解決されず、アプリケーションの監視にサブスクライブすることはできません。
    注: この前提条件は、 vCenter Server クラウド アカウントによって管理されている仮想マシンにのみ適用されます。オブジェクト タイプの詳細については、 OSとアプリケーションの監視を参照してください。
  • VMware Aria Operations のポート 443 からターゲット マシンにアクセスできる必要があります。
  • VMware Aria Operations ユーザーに、次の権限が必要です。
    • 管理 > コントロール パネル > REST-API > その他のすべての読み取り、書き込み API
    • 管理 > コントロール パネル > REST-API > API への読み取りアクセス
    • 操作 > アプリケーション > Telegraf エージェントの管理
    • インベントリ > アクション > 仮想マシンのブートストラップ
    • インベントリ > アクション > ブートストラップのダウンロード
    注: 権限を確認するには、 [管理] > [コントロール パネル] > [アクセス制御] > [ロール] の順に移動して、ユーザーが割り当てられているロールを選択します。権限はページの右端に表示されます。
  • 現在、クラウド プロキシでは IPv4 のみがサポートされています。
  • VMware Tools のバージョンが 10.2 以上である必要があります。
    注: vCenter Server クラウド アカウントによって管理される仮想マシンにのみ適用されます。

手順

  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. スクリプトを実行し、エージェントをインストールまたはアンインストールするには、次のコマンドを実行します。
    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 でエラー メッセージを探します。

    スクリプトが正常に実行された場合は、1 回の収集サイクル後に [Telegraf エージェントの管理] タブのエージェント ステータスが更新されます。サイクルの完了には約 5 ~ 10 分かかります。

    注: 自動化スクリプトを使用する場合、バッチ サイズが 20 のエージェントの同時インストールがサポートされます。