Understand the setup and the VMware Aria Operations (SaaS)integration v1 limitations and caveats.

VMware Aria Operations (SaaS) (formerly vRealize Operations Cloud) delivers intelligent operations management with application-to-storage visibility across physical, virtual, and cloud infrastructures. Using policy-based automation, operations teams automate key processes and improve the IT efficiency.

The VMware Aria Operations (SaaS) integration is a full-featured native integration that offers agentless data ingestion of VMware Aria Operations (SaaS) metric data, as well as a predefined dashboard.

How to Register a VMware Aria Operations (SaaS) Integration

To register a new VMware Aria Operations (SaaS) instance, you need a Cloud Services console API token and a VMware Aria Operations (SaaS) endpoint URL.

Obtain an API Token

The API token will give read-only access to VMware Aria Operations (SaaS) and enable VMware Aria Operations for Applications (formerly Tanzu Observability by Wavefront) to continually load metrics from various resource categories. The minimum role required for the integration is the Operations ReadOnly role. Make sure that the role assigned to the API token is also assigned to the user generating the API token.

  1. Navigate to the VMware Cloud Services Console page.
  2. Click your user name on the right of the toolbar, and select My Account.
  3. Click the API Tokens tab.
  4. Click the Generate a New API Token button.
  5. Enter a meaningful API token name, for example, wavefront-integration.
  6. Choose to generate a never expiring API Token by selecting never expiring from the drop-down menu showing the Token TTL units of time.

    If you select to generate an API token that will expire after certain period of time, when the API token expires, you will have to configure the service again.

  7. Define the role of the token.

    1. Under Organization Roles, select Organization Member.
    2. Under Service Roles, scroll down, expand VMware Aria Operations (SaaS), and select the Operations ReadOnly role.

      Note: The same Operations ReadOnly role must be also assigned to your user account.

  8. Click the Generate button.
  9. Click the Copy button and copy the generated token.

Set Up the VMware Aria Operations (SaaS) Integration

  1. Log in to your Operations for Applications instance.
  2. Click Integrations on the toolbar.
  3. In the VMware section, click the VMware Aria Operations (SaaS) tile.
  4. Click Add Integration.
  5. Provide a meaningful name of the integration.
  6. Paste the API token that you generated in the API Token text box.
  7. Select the resources to fetch.

    Currently we fetch only vCenter Server adapter resources, such as Cluster Compute Resource and Datastore.

  8. In the Metric Allow List text box, add metrics to an allow list by specifying a regular expression.

    For example, to fetch only cost metrics, enter ^vrops.vmware.(datastore|clustercomputeresource).cost.*$.

  9. In the Service Refresh Rate text box, enter the number of minutes between requesting metrics. Default is 5 minutes.
  10. In the VMware Aria Operations URL text box, enter the VMware Aria Operations (SaaS) Endpoint URL.
  11. Click Register.

Metrics for VMware Aria Operations (SaaS)

With this initial, v1 release of the VMware Aria Operations (SaaS) integration, we collect the following high-level list of metrics. For the complete list and descriptions of the metrics that we collect for cluster compute resources and datastores, see Cluster Compute Resource Metrics and Datastore Metrics.

Metric Name Description
vrops.vmware.clustercomputeresource.* Metrics for cluster compute resources, such as:
  - Overall score metrics that show the cluster compute resource state, such as compliance, efficiency, health, risk, and workload.
  - Cluster services metrics that provide information about cluster services.
  - Configuration metrics that provide information about configuration settings.
  - Cost metrics that provide information about the cost.
  - CPU usage metrics provide information about CPU usage.
  and so on
vrops.vmware.datastore.* Metrics for datastores, such as:
  - Capacity metrics that provide information about datastore capacity.
  - Device metrics that provide information about device performance.
  - Datastore metrics that provide information about the datastore usage.
  and so on

You can see the full list of the collected metrics on the Metrics Browser page.

  1. In your VMware Aria Operations for Applications cluster, click Browse > Metrics.
  2. On the Metrics Browser page, in the Metrics text box, enter vrops.vmware..
  3. Click the folder icons to drill down to the individual metrics.

VMware Aria Operations (SaaS) Integration Known Issues and Limitations

This initial release of the VMware Aria Operations (SaaS) integration has the following known issues and limitations:

  • For supermetrics, such as Cost Drivers - Facilities (US $/Month), Total Server Purchase Cost, and so on, the metric names are not fetched and in our UI, these metrics are displayed with the super metric ID.
  • The VMware Aria Operations (SaaS) metrics have a point tag, which represents the organization ID. This is the UUIF of the organization. Currently, we collect the Organization ID as a point tag, instead of the Organization name.
  • Along with the summary for a resource, in VMware Aria Operations (SaaS) there might be other properties. In Operations for Applications, currently we do not collect such properties. The VMware VMware Aria Operations (SaaS) integration only collects properties under the summary section as point tags.
  • In this release, you will see all the vCenter Server instances that you have configured in VMware Aria Operations (SaaS). To shortlist the vCenter Server instances you want to monitor, apply a filter by using the REST API.
    1. In your cluster, click the gear icon in the top right corner, and select API Documentation.
    2. Expand Cloud Integration and click the GET /api/v2/cloudintegration request.

      You will see the list of the cloud integrations in the Response Body in JSON format.

    3. Search for the VMware Aria Operations (SaaS) integration that you want to update.
    4. Copy the value of the id parameter of the VMware Aria Operations (SaaS) integration and keep it handy.
    5. In a JSON file replace all the values in the below structure with the values that you got from step 4, and filter out the vCenter Server instances.

          "vrops": {
                  "baseURL": "<vmware-aria-operations-cloud-base-URL>",
                  "metricFilterRegex": "<metric-filter-regex>",
                  "categoriesToFetch": <categories-to-fetch>,
                  "vropsAPIToken": "<vmware-aria-operations-operations-API-Token>",
                  "organizationID": "<organization-ID>",
                  "adapterNames":{"VMWARE":["vCenter Server name 1","vCenter Server name 2",...]}

      Here the adapterNames are the names of your vCenter Server instances.

      Leave only the names of the vCenter Server instances that you want to monitor.

    6. After you create the JSON file, click the PUT /api/v2/cloudintegration/{id} request.
    7. In the id text box, enter the ID of the integration that you copied in Step 5.
    8. In the Edit Value text box, enter the contents of the JSON file that you created in Step 6.
    9. Click Execute.

    You get a 200 response and in the Operations for Applications UI, you can see that the vCenter Server instances are filtered out.