You can use a sample script to monitor operating systems in physical servers.

The sample script is tested only on the following operating systems:
  • CentOS 7.x and CentOS 8.x
  • RHEL 7.x and RHEL 8.x
  • SUSE 12.x and SUSE 15.x
  • OEL7.x and OEL 8.x
  • Ubuntu 16.x, Ubuntu 18.x, and Ubuntu 20.x
  • VMware Photon Linux


  • Ensure that Internet is enabled.
  • Verify that cURL is at 7.29.0.
  • Verify that unzip is at 6.0-20.el7 or above.
  • Verify that OpenSSL is at 1.0.2k-fips or above.
  • Ensure that cloud proxy is up and online in vRealize Operations Cloud.
  • Ensure that cloud proxy is reachable from the physical server.
  • The uuidgen package must exist on the physical server.

If you have already used custom Telegraf and have upgraded vRealize Operations Cloud, and you want to view the new properties of the operating system objects, you must reperform all the following steps to monitor operating systems. You must download the helper script again, rerun it, and then restart custom Telegraf.


  1. SSH to the physical server and download the sample script from cloud proxy by running the following command:
    wget --no-check-certificate https://<cloudproxy_ip>/downloads/salt/ 
    Note: Use the relevant cloud proxy IP address for <cloudproxy_ip> in the preceding location specified.
  2. Make the script executable by running the following command:
    chmod +x
  3. Create the user's refresh token associated with the current organization from the following location in the Cloud Service portal.
    User/Organization Settings > My Account > API Tokens >> Generate a New API Token
  4. Run the sample script to download the Telegraf binary files from cloud proxy, create necessary certificates for a secure connection with vRealize Operations Cloud, and make necessary updates in Telegraf configuration files.
    ./ -t <refresh_token_from_previous_step> -c <cloudproxy_ip> -d <Telegraf_Download_Directory> 
    Example: -t UO2HafB0JMYiMmnppZIo2Zn5jCdDf1YeIXa0E7JXUPoUXF5HN6SK29kdJUibcJMg -c -d /opt/TelegrafDownloadDirectory 
    If the environment is behind a corporate proxy, the script considers the proxy explicitly for external connections.
    Note: Ensure that the special characters in the user name and password are either http encoded or escaped correctly. For example:
    ./ -t <refresh_token_from_previous_step> -c <cloudproxy_ip> -d <Telegraf_Download_Directory> -x http://<proxyIp>:<proxyPort> -u <proxyUser> -p <proxyPassword>
    Description of arguments:

    refresh_token_from_previous_step: Refresh token of the user that was generated in the previous step.

    cloudproxy_ip: IP of Cloud Proxy. Mandatory parameter.

    Telegraf_Download_Directory: Where to install the agent? It's an optional parameter. Default value: current directory.

    proxy: Proxy Server URL. Optional parameter.

    Note: If helper script execution fails for the first time due to wrong arguments, clear the Telegraf folder and rerun the script once more with the right arguments.
  5. cd the <Telegraf_Download_Directory> folder and run Telegraf.
    telegraf/usr/bin/telegraf -config telegraf/etc/telegraf/telegraf.conf -config-directory telegraf/etc/telegraf/telegraf.d

What to do next

You can view metrics by selecting the relevant object > Metrics tab from the vRealize Operations Cloud user interface.
  1. From the left panel, navigate to Environment > Custom Groups.
  2. Click the Operating System World object in the right pane.
  3. Navigate to the Metrics tab and select the corresponding OS object.