Puede instalar o desinstalar un agente de en una máquina de destino mediante un script.

Requisitos previos

  • Complete todos los requisitos previos. Para obtener más información, consulte Requisitos previos.
  • El paquete descomprimido debe estar disponible en la máquina de destino.
  • El usuario debe tener permisos de acceso a la carpeta de descarga.
  • La cuenta de nube debe configurarse para la instancia de vCenter Server a la que pertenece la máquina virtual. Si no existe, se creará el adaptador de supervisión de aplicaciones que está asignado a vCenter Server.
    Nota: Este requisito previo solo se aplica a las máquinas virtuales que administra la cuenta de nube de vCenter Server. Para obtener más información sobre los tipos de objetos, consulte Supervisión de aplicaciones y sistemas operativos.
  • La máquina virtual que administra la cuenta de nube de vCenter Server debe estar disponible en VMware Aria Operations.
    Nota: Este requisito previo solo se aplica a las máquinas virtuales que administra la cuenta de nube de vCenter Server.
  • La IP de invitado debe estar configurada correctamente y ser única en todas las instancias de vCenter Server. Si se supervisa más de una máquina virtual que administra la cuenta de nube de vCenter Server con la misma dirección IP, el script no podrá resolverse ni suscribirse a la supervisión de aplicaciones.
    Nota: Este requisito previo solo se aplica a las máquinas virtuales que administra la cuenta de nube de vCenter Server. Para obtener más información sobre los tipos de objetos, consulte Supervisión de aplicaciones y sistemas operativos.
  • Asegúrese de que Internet esté habilitado.
  • El usuario de VMware Aria Operations debe tener los siguientes permisos:
    • Administración > REST API > Todas las demás API de lectura y escritura
    • Administración > REST API > Acceso de lectura a las API
    • Entorno > Aplicaciones > Administrar agente de Telegraf
    • Entorno > Acciones > Máquinas virtuales de arranque
    • Entorno > Acciones > Descargar arranque
    Nota: Para comprobar los permisos, desplácese hasta Administración > Control de acceso > Roles y seleccione la función a la que está asignado el usuario. Puede ver los permisos en la parte derecha al final de la página.
  • Actualmente, solo se admite IPv4 para los proxies de nube.
  • La versión de VMTools debe ser >= 10.2.
    Nota: Solo se aplica a las máquinas virtuales que administra la cuenta de nube de vCenter Server.

Procedimiento

  1. Inicie sesión en la máquina de destino en la que desea instalar o desinstalar el agente y descargue el script de muestra desde el proxy de nube en la siguiente ubicación: https://<CloudProxy>/downloads/salt/telegraf-utils.ps1.
    Si se produce un error en la descarga del script con el siguiente mensaje: La solicitud se anuló: No se pudo crear el canal seguro SSL/TLS, siga los pasos mencionados en Error en la descarga de scripts en una plataforma Windows.
    Ejecute uno de los siguientes comandos:
    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
    Nota: Use la dirección IP del proxy de nube correspondiente para <proxy-de-nube> en los comandos y la ubicación anteriores especificados. Para los grupos de recopiladores activados de alta disponibilidad para supervisión de aplicaciones, proporcione la IP virtual.
  2. Cree el token de actualización del usuario asociado a la organización actual desde la siguiente ubicación en el portal de Cloud Service: Ajustes de usuario/organización > Mi cuenta > Tokens de API >> Generar un nuevo token de API
  3. Para ejecutar el script e instalar/desinstalar el agente, ejecute el siguiente comando:
    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.
                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: .\telegraf-utils.ps1 product-managed -t 8dab02cc-265c-4392-b910-bd2e89c7e741::8bcde100-6318-44d7-a8dc-11f4ff84b3b -v 10.10.10.100 -c 10.10.10.101
    Nota: El argumento -c es obligatorio para ejecutar el script de aplicación auxiliar.
    Nota: La URL de la puerta de enlace predeterminada es https://www.mgmt.cloud.vmware.com/vrops-cloud y la URL de autenticación predeterminada es https://console.cloud.vmware.com/csp/gateway/am/api/auth/api-tokens/authorize. Si la URL de autenticación y la URL de puerta de enlace son diferentes de la configuración predeterminada, indique los argumentos adecuados (-g y -a).
    Para comprobar el estado de arranque, consulte el archivo uaf-bootstrap-results. Si se produce un error en la instalación, busque mensajes de error en uaf_bootstrap.log.

    Si el script es correcto, el estado del agente se actualizará en la pestaña Administrar agentes de Telegraf después de un ciclo de recopilación que tarda entre 5 y 10 minutos.

    Nota: Cuando se usa un script de automatización, se admite la instalación simultánea de agentes con un tamaño de lote de 20.