Vous pouvez installer un agent sur une VM de point de terminaison à l'aide d'un script.

Conditions préalables

  • La machine virtuelle de point de terminaison doit être disponible dans VMware Aria Operations.
  • Complétez toutes les conditions préalables. Pour plus d'informations, consultez : Conditions préalables.
  • Le module de décompression doit être disponible sur la machine virtuelle de point de terminaison.
  • L'utilisateur doit disposer d'autorisations d'accès au dossier de téléchargement.
  • La version de Windows PowerShell doit être >= 5.0.
  • L'adresse IP de l'invité doit être correctement configurée et est unique sur les instances de vCenter Server. Si plusieurs machines virtuelles de point de terminaison ayant la même adresse IP dans différentes instances de vCenter Server sont surveillées, le script ne peut pas être résolu et s'abonner à la surveillance d'applications.
  • Le compte de cloud doit être configuré pour l'instance de vCenter Server à laquelle appartient la machine virtuelle de point de terminaison.
  • La VM de point de terminaison VMware Aria Operations doit pouvoir accéder au port 443.
  • L'utilisateur de VMware Aria Operations doit disposer des autorisations suivantes :
    • Administration > REST-API > Toutes les autres API de lecture et d'écriture
    • Administration > REST-API > Accès en lecture aux API
    • Environnement > Applications > Gérer l'agent Telegraf
    • Environnement > Actions > Démarrer des machines virtuelles
    • Environnement > Actions > Télécharger le démarrage
    Note : Pour vérifier les autorisations, accédez à Administration > Contrôle d'accès > Rôles, sélectionnez le rôle auquel l'utilisateur est attribué. Vous pouvez afficher les autorisations sur le côté droit à la fin de la page.
  • Seul IPv4 est actuellement pris en charge pour le proxy cloud.
  • La version de VMTools doit être supérieure ou égale à la version 10.2.

Procédure

  1. Connectez-vous à la VM de point de terminaison sur laquelle vous souhaitez installer/désinstaller l'agent et téléchargez l'exemple de script à partir du proxy cloud, à partir de l'emplacement suivant : https://<CloudProxy>/downloads/salt/ telegraf-utils.ps1.

    Si le téléchargement du script échoue avec le message suivant : La demande a été abandonnée : impossible de créer un canal sécurisé SSL/TLS, suivez les étapes mentionnées dans Échec du téléchargement du script sur une plate-forme Windows.

    Exécutez l'une des commandes suivantes : 
    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
    Note : Utilisez l' adresse IP du proxy cloud approprié pour <CloudProxy> dans les commandes précédentes et à l'emplacement spécifiés. Pour les groupes de collecteurs activés pour la haute disponibilité de surveillance d'applications, fournissez l'adresse IP virtuelle.
  2. Pour exécuter le script et installer/désinstaller l'agent, exécutez la commande suivante : 
    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
    Note : L'argument -c est obligatoire pour exécuter le script d'aide.

    Pour vérifier l'état du démarrage, affichez le fichier uaf-bootstrap-results. En cas d'échec de l'installation, recherchez les messages d'erreur dans uaf_bootstrap.log.

    Si l'exécution du script réussit, le statut de l'agent est mis à jour dans l'onglet Gérer les agents Telegraf après un cycle de collecte d'une durée de 5 à 10 minutes.

    Note : Lorsque vous utilisez un script d'automatisation, l'installation simultanée d'un agent avec une taille de lot de 20 est prise en charge.