You must select the vCenter Server VMs on which you want to install the agent. All the vCenter Server VMs of the vCenter Server cloud account are listed in the Manage Telegraf Agents page.

Prerequisites

Note: You cannot install an agent from the VMware Aria Operations user interface, on physical servers and target machines (Discovered in VMware Aria Operations as the Endpoint object type).
Ensure that you have completed all the prerequisites. For more information, see Prerequisites.

Procedure

  1. From the left menu, select Operations > Applications. From the Applications panel, select Manage Telegraf Agents. You see the Manage Telegraf Agents page.
  2. From the Manage Telegraf Agents page, select the VMs managed by the vCenter Server cloud account on which you want to install the agent.
  3. From the Manage Telegraf Agents page, click Agent Actions, and then click Install.
  4. If the VMware Aria Operations Application Monitoring Adapter instance has not been created for the specific vCenter Server, you see the Installing Telegraf Agent dialog box. You can configure high availability for application monitoring via collector groups:
    • Select Cloud Proxy Groups, with High-Availability if you want to associate an application monitoring high availability activated collector group to the vCenter Server. You can choose the collector group from the HA Enabled Group drop down list, or
    • Select Cloud Proxies, without High-Availability if you want to associate a cloud proxy to the vCenter Server. You can choose a cloud proxy from the Cloud Proxy drop down list.
    • Click Done.
    Note: If the vCenter Server is on the default collector, the cloud proxy options are blank. If the vCenter Server is on a specific cloud proxy, the cloud proxy option is automatically populated. To deploy the VMware Aria Operations Application Monitoring Adapter instance on a different cloud proxy, select another cloud proxy or application monitoring high availability activated collector group.
  5. You see the Manage Agent dialog box.
  6. From the How do you want to provide VM Credentials page, complete the following steps:
    1. If you have a common user name and password for all the VMs, select the Common username and password option.
    2. If you have different user names and passwords for all the VMs, select the Enter virtual machine credentials option.
    3. Under the section called Telegraf Configurations, select the Telegraf agent configurations - Use backup of configurations if available option if you want to restore the configuration details that were backed up for available agents on the VM, during a previous uninstall of the agents. For more information see, Uninstall an Agent.
      Note: Some agents such as Active MQ, Java Application, JBoss Server, Pivotal TC Server, Tomcat Server, Oracle WebLogic Server, and Riak KV might not work after you upgrade VMware Aria Operations from a previous version to 8.18 and choose to restore the agent configurations. As a workaround, after you restore agent configurations during the install, select the agents that were restored after you upgraded VMware Aria Operations to 8.18 and update the agents by selecting the vertical ellipsis > Update against the agent.
    4. Click Next.
  7. From the Provide Credentials page, depending on whether you have a common credential for all VMs managed by the vCenter Server cloud account or different credentials for all VMs managed by the vCenter Server cloud account, enter the following details:
    1. If the selected VMs have a common user name and password, enter the common user name and password.
    2. For different user names and passwords for each VM, download the CSV template and add the required details such as the user name, password for each VM managed by the vCenter Server cloud account. Use the Browse button to select the template.
    3. The Create run time user on Linux virtual machines, with required permissions as part of agent installation check box is selected by default. For more information, see User Account Prerequisites.
    4. Click Next.
  8. From the Summary page, you can view the list of VMs managed by the vCenter Server cloud account on which the agent is to be deployed.
  9. Click Install Agent. Refresh the UI to view the agents that are installed.
    On User Account Control (UAC) deactivated Windows VMs managed by the vCenter Server cloud account, the Telegraf agent installation completes with the Agent running agent status and Install Success Last operation status, if all prerequisites are performed.

    UAC Activated on Windows VMs Managed by the vCenter Server Cloud Account

    In the case of UAC activated VMs, for a non-administrator user who belongs to the administrator group, Telegraf agent installation completes with the Not Started agent status and Download Success last operation status, if all the prerequisites are performed. The bits are downloaded to the VM. You must manually install the bits. From C:\VMware\UCP\downloads, run a bootstrap launcher, and then the agent status becomes Agent Running and the Last operation status becomes Install Success.

    • Open PowerShell with administrator privileges.
    • Go to $SYSTEMDRIVE\VMware\UCP\downloads folder: cd $SYSTEMDRIVE\VMware\UCP\downloads
    • Run the cmd /c uaf-bootstrap-launcher.bat > uaf_bootstrap.log 2>&1 command.
    • View the results from uaf_bootstrap.log.
    • Verify the status of agent installation from the Agent Status and Last Operation Status columns in the Manage Telegraf Agents page.
  10. The agent discovers the application services that are installed on the target machines. You can view the application services by clicking the drop down arrow against the VMs managed by the vCenter Server cloud account on which the agent is installed in the Manage Telegraf Agents page. You can view the status of agent installation from the Agent Status column in the Manage Telegraf Agents page.
  11. After installation, an OS object will be created under VMs managed by the vCenter Server cloud account topology. To view the object, select a VM from Operations > Applications > Manage Telegraf Agents page. Click the vertical ellipsis and select Go to Details, and click on the Metrics tab. Expand the Object relationship widget, and select the OS object.
  12. If agent installation fails, a detailed error message is displayed when you hover over the red exclamation icon before the Install Failed text in the Last operation status column. You can take appropriate action based on the error message to resolve the agent installation issues.

What to do next

You can manage the services on each agent.

For information about uninstalling an agent, see Uninstall an Agent.