Cloud Director usage collection fails due to incompatible version with Usage Meter

Products

• VMware Aria Suite

Issue/Introduction

Symptoms:
Usage Meter stops collecting Cloud Director usage data. The following error appears in the Notification tab of the Usage Meter web application:

"Credentials could not be verified: An unknown error occurred when trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token"

The following information is also seen in the Cloud Director collector logs in Usage Meter.

[2021-04-29 14:10:00] | ERROR | t_credentials_create | com.vmware.um.vcdcollector.VCDCollector | VCD login error: An unknown error occurred when trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token An unknown error occurred when trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token
[2021-04-29 14:10:59] | ERROR | t_credentials_create | om.vmware.um.vcdcollector.apis.VCDClient | An error occurred while trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token
[2021-04-29 14:10:59] | ERROR | t_credentials_create | com.vmware.um.vcdcollector.VCDCollector | VCD login error: An unknown error occurred when trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token An unknown error occurred when trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token
[2021-04-30 09:04:00] | ERROR | VCD collector thread | com.vmware.um.collector.CollectionHelper | VCD collector895 | Status (COLLECT_API_ERR) for VCD server 4: Collection error: APIError
[2021-04-30 10:04:00] | ERROR | VCD collector thread | om.vmware.um.vcdcollector.apis.VCDClient | VCD collector898 | An error occurred while trying to get the X-VMWARE-VCLOUD-ACCESS-TOKEN token

Environment

VMware vCloud Usage Meter 4.x

Cause

The error is due to incompatibility between the version of the Usage Meter instance and Cloud Director.
The Cloud Director usage collection works by exchanging information between the Usage Meter and Cloud Director API. Once the Usage Meter API finds that the metered product API is not compatible, it stops exchanging information, and the metering stops.

Resolution

Procedure

To solve this issue:

1. Check which supported Usage Meter version meters the version of the Cloud Director you use.  Information can be found on the VMware Interoperability Matrix.
2. Check if the Cloud Director version you use is end-of-support on the VMware Lifecycle Matrix.
3. Depending on the information found in the previous steps, either change the Usage Meter version to avoid incompatibility or upgrade your Cloud Director instance if it is end-of-support.