VMware Aria Operations 8.17.1 Release Notes

VMware Aria Operations 8.17.1 \| 11 April 2024 Check for additions and updates to these release notes.

VMware Aria Operations 8.17.1 | 11 April 2024

Check for additions and updates to these release notes.

Build Details

VMware Aria Operations 8.17.1 | 2024 | Build 23642243

VMware Aria Operations Upgrade PAK | 2024 | Build 23642532

Note:This upgrade .pak file includes the OS upgrade files from Photon to Photon, the vApp upgrade files, and Cloud Appliance upgrade files.

VMware Aria Operations Upgrade PAK (Only Cloud Proxy) | 2024 | Build 23642532

Note:This upgrade .pak file includes only the Cloud Appliance upgrade file.

VMware Aria Operations 8.17.1 Pre-Upgrade Assessment Tool | 2024 | Build 23642283

VMware Aria Operations Cloud Appliance (VMware Aria Operations Cloud Proxy) 8.17.1 | 2024 | Build 23642533

Check frequently for additions and updates to these release notes.

Document Revision History

Date	Edition	Changes
April 11, 2024	1	Initial edition.

What's New

Read about the new and enhanced features in this release under Key Features and Capabilities.

VMware Aria Operations Two-Step Upgrade Flow

VMware Aria Operations has greatly improved in terms of better scalability and performance. When you upgrade from VMware Aria Operations 8.16 or earlier to 8.17.1, you may notice some gaps in data collection. This might happen in the period between upgrading the main cluster and Cloud Proxies (CPs). To prevent these gaps, a 'Two-Steps Upgrade Flow' has been introduced. It is recommended that you follow this method detailed in KB 97390. While the regular, well-known upgrade workflow functions effectively, by following the two-step upgrade path, you can leverage substantial benefits of the VMware Aria Operations platform enhancements without notable disruption to your data collection processes.

Service Discovery Adapter

The 'Enable Business Application Discovery and Grouping (Legacy)' functionality has been disabled from the Service Discovery adapter starting from VMware Aria Operations 8.17.1. Users can configure Business Applications manually.

Product Support Notice

Remote Collectors

Cloud proxies have been established as a long-term solution for data collection. In future releases, the introduction of new features will be exclusively limited to cloud proxies, if relevant. The announcement regarding the expiration of support for Remote Collectors and the prohibition of deploying new remote Collectors has already been added in the 8.10 Release notes and accompanying documentation.

VMware Aria Operations 8.14 is the last release supporting Remote Collectors. In the 8.16 and above releases, upgrades will not be allowed if there are Remote Collectors in use. To upgrade to the next version or a later one, it is imperative to replace all Remote Collectors with cloud proxies.

Complete the following steps:

If you are using a collector group, you must add new cloud proxies to it and remove the Remote Collectors.
It is recommended that if you are not already using a collector group, create a new collector group and deploy cloud proxies into it. Reassign all adapter instances that were previously associated with Remote Collectors to the collector groups and remove the Remote Collectors.

vRealize Application Remote Collector

vRealize Application Remote Collector is not supported from vRealize Operations 8.10 and above. Migrate all Telegraf end points to cloud proxy before upgrading to vRealize Operations 8.10 and above. For information about migrating from vRealize Application Remote Collector to cloud proxy, see KB 83059.

Key Features and Capabilities

Workload Placement Enhancements

WLP Recent Tasks Enhancements
- In each of the VM movement tasks, extra fields have been added for ease of auditing and clarity. For more information, see Recent Tasks in VMware Aria Operations.
Support for WLP Action-Based Notifications
- Introduction of a new action-based notification in VMware Aria Operations in this release.
- The only actions that are supported now as a part of the above feature is WLP action-based notification.
- Both successful and failed VM movements can be notified now.
- Ability to forward the WLP action-based notifications to any external webhook of choice.
  
  For more information, see Creating Notification Rules for Notification Type 'Action'.
Ability to change policy priority
- Provide users with the ability to change the priority of the policy as per their need. They can do this via relevant APIs.

vSAN Operations Feature Enhancements

vSAN Health Score Integration
- vSAN Cluster health scores are visible for each and every vSAN Cluster in its summary page. You need not go to vCenter every time to see the vSAN Cluster health scores.
- Aggregated view of all the vSAN Cluster health scores have also been provided in vSAN World Summary Page as well as vSAN Adapter Instance summary page.

For more information, see vSAN Cluster Summary Tab and Metrics for vSAN Cluster.

vSAN Storage Policy Based Effective Capacity Needed support
- Ability to view effective space needed if you change the vSAN Storage policy in the vSAN Cluster Summary Page. This view is available in a tabular column.
- Creation of an instanced metric based on the user's selection for the vSAN Cluster Object.

For more information, see the vSAN Cluster Summary Tab, vSAN World Summary Tab, vSAN Adapter Summary Tab, and Metrics for vSAN Cluster.

Private AI & GPU Monitoring:

Out of the box dashboards:
- GPU Equipped Clusters
  - Displays GPU compute utilization and GPU memory usage at the cluster level, host level, and GPU level.
  For more information, see GPU Equipped Clusters Dashboard.
- GPU Overview
  - Highlights any GPUs that have high-temperature.
  - Highlights GPUs with low to zero usage by analyzing their capacity based on compute and memory utilization.
  For more information, see GPU Overview Dashboard.
Alerts
- Generates an alert when the GPU temperature is high.

Computed Metrics Change

Change in some capacity metrics of Virtual Machine object type during failures
- In this release, a change has been made in the behavior of some computed capacity metrics. When data collection failures occur, the following metrics are now set to empty until data collection is restored. Until the current release, the metrics were set to a value of '0' during data collection failures. The list of virtual machine metrics is as follows:
  - Summary|Is Oversized
  - Summary|Is Undersized
  - Summary|Oversized|Memory (KB)
  - Summary|Oversized|Virtual CPUs
  - Summary|Undersized|Memory (KB)
  - Summary|Undersized|Virtual CPUs

Instanced Metrics

Instanced metrics are deactivated by default after deploying or upgrading to vRealize Operations 8.2 or later, and after importing a policy from older versions. To re-activate instanced metrics in vRealize Operations 8.2 or later, see KB 81119.

Basic Authentication

Basic authentication using the REST API is deprecated and deactivated in VMware Aria Operations 8.17.1 fresh deployments by default. Instances that have been upgraded to VMware Aria Operations 8.17.1, will inherit the same properties before the upgrade. It is recommended that you use token-based authentication instead. If you still need to activate or deactivate basic authentication, see KB 77271.

Active Directory Authentication Sources

Logging in to VMware Aria Operations with a short name will be successful only if the user name's domain suffix matches the domain name specified in the Base DN option. Otherwise, the full user name with the domain suffix is required during login. For more information, see KB 68131

System Requirements

Review this section before you install or update VMware Aria Operations.

Sizing and Scaling

The CPU, memory, and disk requirements that meet the needs of a particular environment depend on the number and type of objects in your environment and data collected. This includes the number and type of adapters installed, the use of HA (High Availability) and CA (Continuous Availability), the duration of data retention, and the quantity of specific data points of interest. VMware updates Knowledge Base article 2093783 with the most current information about sizing and scaling. The Knowledge Base article includes overall maximums and spreadsheet calculations that provide a recommendation based on the number of objects and metrics you expect to monitor.

Deployment Formats

You can deploy VMware Aria Operations 8.17.1 with VMware virtual appliance.

If you are deploying a VMware Aria Operations virtual appliance and VMware Aria Operations Cloud Appliance (cloud proxy), use a VMware vSphere Client to connect to a VMware vCenter Server, and deploy the virtual appliance through the vCenter Server instance. The VMware Aria Operations virtual appliance and VMware Aria Operations Cloud Appliance (cloud proxy) must be deployed on hosts that are:

ESX/ESXi 6.5 Update 1 or later and managed by VMware vCenter Server 6.5 or later.
If you have VMware Aria Operations virtual appliance deployed on ESXi 6.0 or older hosts, you must first upgrade vCenter Server and ESXi to version 6.5 Update 1 or later, and then upgrade to VMware Aria Operations 8.17.1.

Hardware Versions, Cipher Suites and Protocols, and Log4j

Hardware Versions

The minimum hardware version required for VMware Aria Operations 8.x releases is version 11. If your VMware Aria Operations virtual appliance had a hardware version earlier than 11, you must first upgrade to hardware version 11 on VMware Aria Operations virtual appliance and then upgrade to VMware Aria Operations 8.17.1.

Cipher Suites and Protocols

For information about cipher suite lists and relevant protocols, see Cipher Suites and Protocols.

Log4j version is at 2.17.2.

VMware Product Compatibility

Note: The VMware Product Interoperability Matrix provides details about the compatibility of VMware Aria Operations with VMware products.

Note: For FIPS mode compatibility details, see the footnotes in the interoperability matrix. The product will not work in FIPS mode if there are footnotes that state that it will not work in FIPS mode.

Solutions and Browser Support

Solutions Support

In addition to the VMware solutions (vSphere, VMware Aria Operations for Logs, vSAN, Service Discovery, NSX-T, and many more), see the VMware Marketplace for many more solutions. These solutions work with Virtual Appliance single or multiple nodes.

Browser Support

This VMware Aria Operations release supports all current Web browsers, although only the following browsers were tested with this release:

Google Chrome: Versions 122 and 123
Mozilla Firefox: Versions 123.0.1 and 124.0.1
Microsoft Edge: Versions 121 and 122
Safari: 17.3 and 17.4

Note: Support for Internet Explorer has been dropped from vRealize Operations 8.4 onwards.

SDDC Compliance

Ensure compliance of your vSphere, vSAN, and NSX-T resources deployed across private data centers, and other VMware managed clouds such as VMware Cloud Foundation (VCF), VMware Cloud on AWS, Azure VMware Solution, Google Cloud VMware Engine, Oracle Cloud VMware Solution, and VMware Cloud on Dell EMC using various compliance packs in VMware Aria Operations. For information about supported versions of vSphere, vSAN, and NSX, see VMware SDDC Benchmark Details.

Installing and Upgrading VMware Aria Operations

Upgrading to VMware Aria Operations 8.17.1 or upgrading any Management Pack (MP), resets out-of-the-box content as part of the software upgrade process. This implies that the user modifications made to default content such as alert definitions, symptom definitions, recommendations, policies, views, dashboards, widgets, and reports are overwritten. You need to clone or backup the content before you upgrade to VMware Aria Operations 8.17.1.

Notes:

To see the supported direct upgrade path, refer to the Product Interoperability Matrix.
While upgrading to VMware Aria Operations 8.17.1, the expected size of the /dev/sda for Photon OS is 20 GB (hard disk 1). For information about this requirement, see KB 75298.
It is always recommended to run the Pre-Upgrade Assessment tool before an upgrade. A pre-upgrade assessment report that is generated will provide you with the recommended replacements. This tool provides you with an impact analysis following the reduction of metrics in various versions of the product. For more details on using the Pre-Upgrade Assessment Tool, see KB 97070.
It is mandatory to create a snapshot of each node in a cluster before you update a VMware Aria Operations cluster. Once the update is complete, you must delete the snapshot to avoid performance degradation.

VMware Aria Suite Lifecycle 8.16 supports the installation of VMware Aria Operations 8.17.1. For more information, see the VMware Aria Suite Lifecycle 8.16 Release Notes.

Refer to the VMware Aria Operations Upgrade Center that has information about upgrading VMware Aria Operations. Refer to the VMware Lifecycle Product Matrix for information about supported versions of VMware Aria Operations.

The VMware Aria Operations Information Center has detailed information about installation and software updates.

Refer to the Getting Started with VMware Aria Operations Guide that provides guidance for a VMware Aria Operations virtual appliance, before you install or update VMware Aria Operations.

Deploy vSphere with Operations Management (any edition) and VMware Aria Operations Standard together in one deployment.

Deploy vCloud Suite/VMware Aria Suite Standard, Advanced, or Enterprise and VMware Aria Operations Advanced or Enterprise edition together in one deployment.

Note: You can also install VMware Aria Operations by using VMware Aria Suite Lifecycle Manager. For more information, see the VMware Aria Suite Lifecycle Installation, Upgrade, and Management Guide.

Resolved Issues

For details on resolved issues, see KB 97067.

A PDF report file might not include all data from a widget that has a scrollbar

When you generate a report that contains a custom dashboard with a widget that has a scrollbar, the downloaded PDF file might not include all the data in the widget.
Generated Reports
1. The generated report which contains a dashboard containing a metric chart is rendered empty when the widget metric charts fit in the metric chart grid perfectly (the scrollbar is being omitted).
2. Generated reports that contain distribution and trend views will have their date ranges trimmed if the view's description exceeds 2 lines.
3. In a generated report, when the report template contains a dashboard of a specific length, its content is not separated between multiple pages and is trimmed instead.
4. In a generated report, when the report template contains a distribution view, the distribution chart is split between two pages when the "Footer" layout option is chosen. In addition, a blank page is attached at the end of the generated report, when the distribution view mode is set to "Landscape".
5. The generated report content is rendered empty if the "Cost Optimization" dashboard is included in the report template and the "Footer" layout option is selected.

Installation and Upgrade Issues

Upgrade to VMware Aria Operations 8.17.1 will impact some management packs

When you upgrade to VMware Aria Operations 8.17.1, some management packs might not be compatible with JDK11 and would require an upgrade to a JDK11 compatible version. Contact the vendor to confirm if the management pack is compatible with VMware Aria Operations 8.17.1.

Workaround: See KB 89675 for more details.
The PAK file upload process is slower in VMware Aria Operations 8.17.1

The VMware Aria Operations 8.17.1 upgrade PAK file may take longer to upload and may sometimes not complete uploading if you are using Firefox as a browser through a high latency network.

Workaround: Use another supported browser to upload the PAK file and start upgrading to VMware Aria Operations 8.17.1.
After you upgrade vRealize Operations from 8.4 to a later release, content upgrade and agent management actions fail

After you upgrade from a previous release, content upgrade and agent management actions fail on on-prem and SaaS when you also upgrade cloud proxy.
Workaround:

Complete the following steps:
1. SSH to the Cloud Proxy VM.
2. Run the following command: /rpm-content/ucp/subsequentboot.sh
You can view the log from the following location: /opt/vmware/var/log/ucp-subsequentboot
Upgrade might fail if any of the nodes are running on VMs with US/Pacific-New timezone

PostgreSQL database systems no longer support the US/Pacific-New timezone, which was just an alias for America/Los_Angeles timezone. If any of the VMware Aria Operations nodes are running on VMs with US/Pacific-New timezone, upgrade might fail.

Workaround: Change VM timezones from US/Pacific-New to America/Los_Angeles, and then upgrade.

General Issues

VMware Chargeback migration must be run with an "admin" user

While migrating from VMware Chargeback to VMware Aria Operations, you must run the migration with an "admin" user.

Workaround: None
VC Pricing Policies migration must be run with an "admin" user

While migrating from VC Pricing card to VMware Aria Operations policies, you must run the migration with an "admin" user.

Workaround: None
Side-details panel for the collector group fails to load if many cloud proxies are configured

The side-details panel for the collector group fails to load if more than 90 cloud proxies are configured.

Workaround: Configure less than 90 cloud proxies.
vSAN Oversubscription Capacity and Oversubscription Ratio metrics are incorrect

Oversubscription Capacity and Oversubscription Ratio metrics calculation is incorrect for the vSAN ESA environment. The Oversubscription metrics are applicable only for the vSAN OSA clusters.

Workaround: None
Addition of custom cloud providers or edit of IBM Cloud and Amazon Web Services cloud providers is not possible

You cannot add custom cloud providers from the Cloud Providers tab. You cannot edit IBM Cloud and Amazon Web Services cloud providers from the Cloud Providers tab.

Workaround: None
VMware Cloud Foundation Compliance

VMware Cloud Foundation Compliance based on VMware Cloud Foundation Audit Guides currently does not consider vSAN objects from the VMware Cloud Foundation 4.4 Audit Guide. Compliance Score % calculation currently excludes vSAN rules for VMware Cloud Foundation version 4.4.

Workaround: None
Agent install fails with the error: Connect to salt master

When you install an agent to monitor applications using Telegraf, the following error may occur: Connect to Salt Master. The error occurs because the end point VM is unable to connect with the salt master.
Workaround: Verify the ownership of the folders in /ucp/salt/pki/master in cloud proxy. The ownership must be admin/admin. If the ownership is not admin, reset permissions/ownership.
1. Run the /ucp/ucp-config-scripts/ucp-firstboot.sh script and verify the permissions of the folder.
2. Reinstall the agent after successful execution of the script.
Agent install should be successful.
VMware Aria Operations API (Suite-API) based Telegraf agent installation fails with an error
When you use an API end point for Telegraf agent installation in VMware Aria Operations API (Suite-API) using /api/applications/agents, the following error occurs:
```
VM with ID - id is not connected to any ARC or Cloud Proxy
Ex- VM with ID - 94b8e2eb-37fa-4a44-b241-b50e3a013bf7 is not connected to any ARC or Cloud Proxy
```
Workaround:
1. Move the vCenter adapter collector/group back to the same cloud proxy/collector group that was selected the during the first Telegraf agent installation of VMs for that vCenter.
2. Navigate to Data Sources > Integrations > Accounts > vCenter and select the vCenter where the endpoint is located.
3. Click Edit and under the Cloud Account Information, select the vCenter tab > Collector/Group and change collector/collector group from drop down options and then click Save.
4. After the Telegraf agent installation is successful, move the vCenter adapter collector/group back to the initial cloud proxy/collector group.
JBoss server running in domain mode does not support LCM using custom Telegraf

You cannot deploy jolokia.war across all the servers that run as a part of the JBoss domain mode and hence metrics cannot be collected.

Workaround: Monitoring domain mode configuration in JBoss is supported in open source Telegraf. You can deploy jolokia.war across multiple servers.
The Add button in the Manage Telegraf Agents page remains activated after the creation of an application service

While monitoring specific application services using Telegraf, the Add button in the Manage Telegraf Agents page is active after the creation of the second instance of the following application services: MSIIS, Active Directory, SharePoint, MSExchange, and Network Time Protocol.

Workaround: Delete the previous configurations of the specific application services and configure a new one.
Concurrent activation or deactivation of plugins during application monitoring using suite-api does not work

During application monitoring using suite-api, when you activate or deactivate plugins concurrently, plugin activation or deactivation does not work. An exception is logged in the ucpapi.log file.

Workaround: Provide a gap of one second between each thread during activation or deactivation of the plugins using suite-api.
When you get an application instance's configuration status using a Rest-API call, a wrong status is returned when the same configuration was installed or uninstalled previously

If you installed or uninstalled an application instance and then uninstalled or installed it respectively, the API returns "SUBMITTING" when you try to get the application instance install or uninstall configuration status using "GET /api/applications/agents/services/{taskId}/status".

Workaround: While getting the application instance configuration status using the "GET /api/applications/agents/services/{taskId}/status" API, ensure that you use the latest performed task ID. The result of calls with older IDs is undefined.
When you upgrade from vRealize Operations 8.1 to VMware Aria Operations 8.17.1, the Cassandra application service is displayed as Java Application in the Services Discovered/Configured column of the Manage Telegraf Agents tab

During application monitoring, after you upgrade from vRealize Operations 8.1 to VMware Aria Operations 8.17.1, the Cassandra application service is displayed as Java Application in the Services Discovered/Configured column of the Manage Telegraf Agents tab. This happens if the Cassandra application service is configured for monitoring in vRealize Operations 8.1, using the vRealize Application Remote Collector generic Java plugin.

Workaround: Deactivate the Java plugin before you upgrade the vRealize Application Remote Collector agent on the VM. After upgrading the vRealize Application Remote Collector agent, the Cassandra plugin will be discovered and can then be activated.
System language settings affects service discovery

Service discovery might not work if the system language is different from English. For languages different from English, network connection state values might be different from constants defined in standard RFCs.

Workaround: None
Reconfigure the Project Price widget if the VMware Aria Automation integration is deactivated and then reactivated

There is data missing in the Project Price widget of the Cloud Automation Project Price Overview dashboard when you deactivate and then reactivate an existing VMware Aria Automation integration.
Workaround: Reconfigure the Project Price widget by completing the following steps:
1. After you deactivate and then reactivate the VMware Aria Automation integration, navigate to Dashboards > VMware Aria Automation > Cloud Automation Project Price Overview dashboard.
2. Edit the Project Price widget.
3. Navigate to the Input data section.
4. Select the '+' (Add Object) button and select the CAS World object from VMware Aria Automation > CAS World.
5. Click OK.
6. Navigate to the Output data in the same widget configuration mode. Search for and select the CAS Project Price View object from the list.
7. Save the widget.
While monitoring applications, you cannot activate a plugin with the same fields till the plugin configuration is deleted

An error message is displayed in the user interface of VMware Aria Operations that states the following: 'Failed to update resource: Resource with same key already exists'.

Workaround: Manually delete the existing plugin configuration and then continue with the activation of the plugin. If the problem persists, delete the corresponding resource from the inventory.
Alerts from the vSAN adapter that correspond to vSAN health check tests are not canceled if the test is removed from the vSAN Health Service.

VMware Aria Operations cannot detect and cancel deleted alerts.

Workaround: Manually cancel the alert from the user interface of VMware Aria Operations.
Despite deleting ucp-adapter instance certificates, users can run actions

If users delete ucp-adapter instance certificates, they can still run actions such as, start and stop an agent, configure remote checks, and so on.

Workaround: None
The compliance score for a user with limited object visibility is the same as for a user with complete object visibility

The compliance score is calculated for objects that are not visible (not assigned) to the current user.
Workaround: Complete the following steps:
1. Create a custom group with objects visible (assigned) to the user.
2. For that group, apply a policy in which the needed set of compliance alert definitions is activated.
  
  If that set is activated only in one active policy (the one that is applied to the custom group), the compliance benchmark based on those alert definitions will display the correct score.

User Interface Issues

After upgrading cloud proxy and VMware Aria Operations to 8.17.1, the VM name is not appended to the MSSQL instance

After upgrading cloud proxy and VMware Aria Operations to 8.17.1, the VM name is not appended to the MSSQL instance for existing or newly activated plugins.

Workaround: None
The Last Year option in the date picker is not intuitive

The Last Year option in the date picker indicates that the time range starts from the end of the previous month and goes back a year. It does not indicate a time range that spans one year from the current date or the whole previous year.

Workaround: None