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

前提条件

  • すべての前提条件を満たします。詳細については、「前提条件」を参照してください。
  • 解凍パッケージは、ターゲット マシンで使用できる必要があります。
  • ユーザーにダウンロード フォルダへのアクセス権限が必要です。
  • Windows PowerShell は 5.0 以上である必要があります。
  • ゲスト IP アドレスが適切に構成され、vCenter Server 全体で一意である必要があります。同じ IP アドレスを持つ複数の仮想マシンが vCenter Server クラウド アカウントによって管理されている場合、スクリプトは解決されず、アプリケーションの監視にサブスクライブすることはできません。
  • 注: この前提条件は、 vCenter Server クラウド アカウントによって管理されている仮想マシンにのみ適用されます。オブジェクト タイプの詳細については、 OSとアプリケーションの監視を参照してください。
  • vCenter Server クラウド アカウントによって管理されている仮想マシンは、VMware Aria Operations で使用できる必要があります。
    注: この前提条件は、 vCenter Server クラウド アカウントによって管理されている仮想マシンにのみ適用されます。
  • クラウド アカウントは、仮想マシンが属する vCenter Server 用に構成されている必要があります。
    注: この前提条件は、 vCenter Server クラウド アカウントによって管理されている仮想マシンにのみ適用されます。
  • 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.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 アドレスを指定します。
  2. スクリプトを実行し、エージェントをインストールまたはアンインストールするには、次のコマンドを実行します。
    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 でエラー メッセージを探します。

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

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