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.
- 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.
- 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
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
- 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.
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.
- 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
- 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.
