Troubleshooting your Data Management for VMware Tanzu installation may involve generating logs on the Agent VM and/or Service Instance VM(s).
A Service Instance log bundle that you generate from the Data Management for VMware Tanzu user console aggregates relevant logs on the instance VM, enabling faster diagnosis when the service faces an issue.
A Service Instance log bundle is a gzip
ed tar
file, and has the following file name format:
dblogs.<YYYY-MM-DD>-<HHMMSS>.tar.gz
You generate a Service Instance log bundle to review instance activities or to diagnose errors in an instance.
Ensure that you can identify the Service Instance from which you want to generate the logs.
Perform the following procedure to generate a log bundle:
Select Databases from the left navigation pane.
This action displays the Databases view, a table that lists the provisioned database Service Instances.
Examine the databases listed in the table, identify the instance for which you want to generate a log bundle, and navigate to that table row.
Click the database Instance Name.
The database information Details tab displays.
Click the Logs tab.
This action displays a table that lists generated service log bundles.
Click GENERATE LOG in the upper right corner of the view to trigger the generation of a service log bundle.
Data Management for VMware Tanzu initiates the task, generating an operation of type DB_LOG_GENERATION.
Monitor the progress of the operation in the Operations tab or in the DB Operations view:
When the operation completes, the newly generated log bundle is added to the table. You can identify the bundle by its Generation Time.
You can download a service log bundle to your local host for review and analysis, or to provide to VMware support.
Perform the following procedure to download a service log bundle:
Select Databases from the left navigation pane.
This action displays the Databases view, a table that lists the provisioned database Service Instances.
Examine the databases listed in the table, identify the instance for which you want to download a service log bundle, and navigate to that table row.
Click the database Instance Name.
The database information Details tab displays.
Click the Logs tab.
This action displays a table that lists the generated service log bundles.
Examine the bundles listed in the table, identify the bundle that you wish to download, and navigate to that table row.
Click the cloud icon to Download Log.
A browser-specific dialog displays, allowing you to open or to save the log bundle file.
Choose your action for the file to initiate the download.
Note the file system location of the downloaded log bundle file.
Delete one or more service log bundles when you no longer require the data.
Perform the following procedure to delete a log bundle:
Select Databases from the left navigation pane.
This action displays the Databases view, a table that lists the provisioned database Service Instances.
Examine the databases listed in the table, identify the instance for which you want to delete a service log bundle, and navigate to that table row.
Click the database Instance Name.
The database information Details tab displays.
Click the Logs tab.
This action displays a table that lists generated service log bundles.
Examine the bundles listed in the table, and identify the bundle that you wish to delete.
To remove a single bundle, navigate to the table row, click the trashcan icon to Delete Log, and CONFIRM.
To delete multiple log bundles:
Locate and select the checkbox in the first column of each row, and click DELETE SELECTED LOGS near the upper right corner of the view.
The Delete Database Log dialog displays; this confirmation dialog identifies the Log Name of the each bundle that you selected to delete.
Click CONFIRM.
Data Management for VMware Tanzu deletes the bundle(s) and removes them from the table.
Logs that you generate for an Agent VM aggregate relevant logs on the VM, enabling faster diagnosis when the Data Management for VMware Tanzu service faces an issue.
An Agent log bundle is a gzip
ed tar
file, and has the following file name format:
agent_db_logbundle.<YYYY-MM-DD>-<HHMMSS>.tar.gz
You generate an Agent log bundle to review agent activities or to diagnose errors in the service.
Ensure that you can identify the infrastructure from which you want to generate the logs.
Perform the following procedure to generate a log bundle:
Select Infrastructure from the left navigation pane.
This action displays the Infrastructure view, a table that lists the currently onboarded vSphere infrastructures.
Examine the infrastructures listed in the table, identify the infrastructure of interest, and navigate to that table row.
Click the database Agent VM IP.
The infrastructure information Details tab displays.
Click the Logs tab.
This action displays a table that lists generated log bundles.
Click GENERATE LOG in the upper right corner of the view to trigger the generation of an Agent log bundle.
Data Management for VMware Tanzu initiates the task.
When the operation completes, the newly generated log bundle is added to the table. You can identify the bundle by its Generation Time.
You can download an Agent log bundle to your local host for review and analysis, or to provide to VMware support.
Perform the following procedure to download an Agent log bundle:
Select Infrastructure from the left navigation pane.
This action displays the Infrastructure view, a table that lists the currently onboarded vSphere infrastructures.
Examine the infrastructures listed in the table, identify the infrastructure of interest, and navigate to that table row.
Click the database Agent VM IP.
The infrastructure information Details tab displays.
Click the Logs tab.
This action displays a table that lists generated log bundles.
Examine the bundles listed in the table, identify the bundle that you wish to download, and navigate to that table row.
Click the cloud icon to Download Log.
A browser-specific dialog displays, allowing you to open or to save the log bundle file.
Choose your action for the file to initiate the download.
Note the file system location of the downloaded log bundle file.
Delete one or more Agent log bundles when you no longer require the data.
Perform the following procedure to delete a log bundle:
Select Infrastructure from the left navigation pane.
This action displays the Infrastructure view, a table that lists the currently onboarded vSphere infrastructures.
Examine the infrastructures listed in the table, identify the infrastructure of interest, and navigate to that table row.
Click the database Agent VM IP.
The infrastructure information Details tab displays.
Click the Logs tab.
This action displays a table that lists generated log bundles.
Examine the bundles listed in the table and identify the bundle that you wish to delete.
To remove a single bundle, navigate to the table row, click the trashcan icon to Delete Log, and CONFIRM.
To delete multiple log bundles:
Locate and select the checkbox in the first column of each row, and click DELETE SELECTED LOGS near the upper left corner of the view.
The Delete Infra Log dialog displays; this confirmation dialog identifies the Log Name of the each bundle that you selected to delete.
Click CONFIRM.
Data Management for VMware Tanzu deletes the bundle(s) and removes them from the table.