Collect a vCloud Availability Replication Usage Report

Extract the incoming replication usage data from vCloud Availability. The report contains the number of incoming replications and the number of incoming replications aggregated by organizations and by virtual data centers.

Procedure

1. Connect to the vCloud Availability vApp Replication Manager appliance by using a Secure Shell (SSH) client.
   1. Open an SSH connection to Appliance-IP-Address.
   2. Log in as the root user.
2. Obtain a vCloud Availability vApp Replication Manager token.

   $ c4 loginroot 'vApp-Replication-Manager-Password'

   [
   "token-id",
   {
   "user": "root",
   "roles": [
   "EVERYONE",
   "ADMINISTRATORS",
   "VRADMINISTRATORS"
   ],
   "authenticatedSites": [
   
   { "site": "site1", "org": "System" }
   ]
   }
   ]

3. (Optional) Retrieve the usage information about the usage-report script.

   $ usage-report --help

4. Generate the vCloud Availability usage report.

   $ usage-report --output /tmp/report_summary.tsv --details /tmp/report_details.tsv

   By not using the --dry-run argument, the usage report overwrites the reporting data in the two .tsv files.

   The /tmp/report_summary.tsv file contains the number of all incoming replications and information about incoming replications grouped by organizations and by virtual data centers. This information is presented in the following format:

   vCloud Availability Usage Report
   generatedOn date-time-stamp
   buildVersion 3.x-build-number
   localSite site1
   instanceId instance-id
   
   Incoming replication counts
   Replication type Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations
   Total incoming vApp replications 5 1 0 3 1
   Newly started incoming vApp replications 5 1 0 3 1
   Carried over incoming vApp replications 0 0 0 0 0
   Total incoming VM replications 5 1 0 3 1
   Newly started incoming VM replications 5 1 0 3 1
   Carried over incoming VM replications 0 0 0 0 0
   
   Incoming vApp replications by org
   Org Org Id Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations
   alpha eb410797-9038-4755-a7f1-f28981ef5408 2 1 0 1 0
   beta 082ce1a1-7b17-4316-92ab-db82da0c35e0 3 0 0 2 1
   
   Incoming VM replications by org
   Org Org Id Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations
   alpha eb410797-9038-4755-a7f1-f28981ef5408 2 1 0 1 0
   beta 082ce1a1-7b17-4316-92ab-db82da0c35e0 3 0 0 2 1
   
   Incoming vApp replications by vDC
   vDC vDC Id Org Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations
   alphaorgvdc1 33ff6729-b55f-4ae8-bf20-6b0b553542ed alpha 2 1 0 1 0
   betaorgvdc1 964ce5f9-e8b9-494c-81dd-4deea158b61e beta 3 0 0 2 1
   
   Incoming VM replications by vDC
   vDC vDC Id Org Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations
   alphaorgvdc1 33ff6729-b55f-4ae8-bf20-6b0b553542ed alpha 2 1 0 1 0
   betaorgvdc1 964ce5f9-e8b9-494c-81dd-4deea158b61e beta 3 0 0 2 1
   
   End of report.
   vCloud Availability Detailed Usage Report
   generatedOn 2019-09-10 10:55:42.359126
   buildVersion 3.5.0.14556251-71017ba
   localSite site1
   instanceId cb45ee35-09b8-4c80-b72a-0c0d4290e924
   
   Incoming replication counts
   Replication type Total count Cloud to cloud protections Cloud to cloud migrations vSphere to cloud protections vSphere to cloud migrations
   Total incoming vApp replications 5 1 0 3 1
   Newly started incoming vApp replications 5 1 0 3 1
   Carried over incoming vApp replications 0 0 0 0 0
   Total incoming VM replications 5 1 0 3 1
   Newly started incoming VM replications 5 1 0 3 1
   Carried over incoming VM replications 0 0 0 0 0
   
   Incoming VM Replications
   Replication Type Migration/Protection vApp Name vApp Id VM Name VM Id Replication ID Source Site Source Org Source vDC Id Source vDC Destination Site Destination Org Id Destination Org Destination vDC Id Destination vDC
   cloud-to-cloud protection ...
   vsphere-to-cloud protection ...
   vsphere-to-cloud protection ...
   vsphere-to-cloud migration ...
   vsphere-to-cloud protection ...
   
   End of report.

5. Download the vCloud Availability usage report to your local machine.

   $ scp /tmp/report_summary.tsv /tmp/report_details.tsv user@your-host:/download-target-location

6. (Optional) Remove the generated reports from the vCloud Availability vApp Replication Manager appliance.

   $ rm /tmp/report_summary.tsv /tmp/report_details.tsv