How to Troubleshoot Error or Warning Notifications related to the Usage Meter Services

Products

• VMware Aria Suite

Issue/Introduction

Symptoms:
If you receive any of the notifications below in your Usage Meter web application, please check the status of your Usage Meter appliance:

• Detected health issues with the Gnats services
• Detected offline Core nsxtCol vraCol services
• Detected offline NginX GW services
• Detected offline NginX services

Resolution

 

Additional Information

Troubleshooting

You need to do the following to troubleshoot your Usage Meter and solve any issues with its services:

1. Start SSH on your Usage Meter
2. Verify the status of your Usage Meter services
3. Check your Usage Meter logs for any errors
4. Restart all or only the defective Usage Meter services
5. Generate a support bundle to attach it to your support request
6. Stop SSH on your Usage Meter

Start SSH on Your Usage Meter

You need to enable SSH in order to connect remotely to Usage Meter from another computer, check its logs and restart its services.

Procedure:

1. Log in to the vCloud Usage Meter console as usagemeter:
2. Enter in the terminal:

service sshd start

Verify the Status of Your Usage Meter Services

You need to check the status of your Usage Meter services before restoring any defective services.

Procedure:

1. Enter the /opt/vmware/cloudusagemetering directory.

cd /opt/vmware/cloudusagemetering

2. Verify the status of the vCloud Usage Meter services.

bash scripts/status.sh

Check Your Usage Meter Logs for Errors

You can check the cause for the failure of your Usage Meter services by checking its logs.

Procedure

1. Log in to the vCloud Usage Meter console as usagemeter.
2. Access the Usage Meter logs directory.

   cd /opt/vmware/cloudusagemetering/var/logs

Restart Your Usage Meter Services

After checking the cause for the failure of your Usage Meter services, you can restart only those which failed or restart all Usage Meter services.

Procedure

1. Log in to the vCloud Usage Meter console as usagemeter.
2. Access the cloudusagemetering directory.

cd /opt/vmware/cloudusagemetering

3. Restart the defective Usage Meter service. Replace DSS with the corresponding service. Options include: All, Core, daasCol, DSS, GW, nsxtCol, nsxvCol, vcavCol, vcCol, vcdCol, vraCol, vrniCol, and vropsCol.

bash scripts/stop.sh DSS

bash scripts/start.sh DSS

4. Optionally, restart all Usage Meter services.

bash scripts/stop.sh All

bash scripts/stаrt.sh All

Generate a Support Bundle

In addition to checking the logs of your Usage Meter, you can also generate a support bundle, which you need to attach to your support request to the VMware Global Support Services team. The support bundle includes logs and other data that will help the support team investigate your issue.

Procedure

1. Log in to the vCloud Usage Meter console as usagemeter.
2. Access the cloudusagemetering directory.

cd /opt/vmware/cloudusagemetering

3. To generate the support bundle, run the script.

./scripts/bundle.sh

This process takes a few minutes. The generated support bundle file bundle.tar.gz is saved to the cloudusagemetering directory.

Stop SSH on Your Usage Meter

Stop SSH on your Usage Meter appliance after restoring its services.

Procedure

1. Log in to the vCloud Usage Meter console as usagemeter.
2. Disable SSH in vCloud Usage Meter console.

service sshd stop