Reporting and Logging

Introduction

Tranzman provides an extensive logging and reporting on the configs involved in migration.
It helps to understand the status of the migrated components and useful for troubleshooting issues related to migration.

Reports

Reports provides statistical reporting on image catalog and its associated information. The report is available for individual environments and/or as collective.
Click on Views->Reports to access those charts. A selections button on the top right corner is used as a filter for the charts.

will display the charts against data selected for migration.

will display the charts against non selected data.

will display the charts against both selected and non selected data.

Below picture shows the charts against the selected data.

Reports also provides two main additional reporting- Summary and Environment History

Summary

To view the Summary report, navigate to Views->Reports and click on the icon.
Summary report provides an overall insight of the image Transition status, such as exported, manipulated, imported etc.,.It also gives the Agent information.
The report has two sub section - Agent state information and Image state information.

The Agent state info provides -

• Information about the current state of Tranzman appliance (i.e, configuration_migration, data_transfer, completion etc)
• Shows the up-to-date status of agent connection (RUNNING or STALLED)
• Tells the time since the last connection is made with agent.
• This report also shares info on whether the agent is Origin (O denotes origin) or Destination (D denotes destination).
  

If finalized, then it is denoted as (Of - Origin finalized) and (Df - destination finalized)

Below is the detailed info of each state of Image-

• data_expired - Shows the number of Images that already expired
• data_purged - Number of images that are migrated to destination
• deselected - tells the number of images that are deselected (by default, Tranzman deselects Catalog backup)
• discovered - number of images that are discovered on server.

• export_complete - Images that are exported.
• export_in_progress - number of images which are export in progress
• export_fatal - failed images during export. To be troubleshooted on Origin side.

• manipulate_complete - Images are updated for import on Destination. These images are stored on Tranzman server (/data partition)
• manipulate_in_progress - Shows the number of images being updated by Tranzman

• import_complete - Total number of images migrated to destination
• import_in_progress - Number of images importing in progress
• import_fatal - Images that failed to migrate. troubleshooting required on destination side.

Environment History

To view the Environment History, Navigate to Views -> Reports and click on the icon.
A pop-up window showing the history report of environment, the state and the reason for the change in state

Activities

Activities shows all the jobs information. Clicking on the job, provides detailed information about the task.
The task logs can also be downloaded for troubleshooting.

Images

Provides the complete list of discovered images of all the backup domain.
Options to manipulate the data migration (ignore images, Reset an image, Force an image as imported etc.,)
Click on an image to view the image information and the different manipulation stages (Image audit)

Tranzman provides different options as below to manipulate the images.

• Refreshes the images page
• Ignore the selected images. (mark the selected images as Deselected)
• Reset the state of image back to Selected or Discovered
• Forcefully mark the image as imported
• Download the selected images as csv file.
• Upload a custom image list.

Following filters can be applied on images list:

• Origin, Destination and Policy Type drop down provides filtering based on configuration data.
• State and Category filters based on the manipulation status of image .
• Valid data can be entered on other text fields as a custom filtering.
• All dropdown list supports multi-selection filtering and the default is with no filter.

Media

The media related information is available under Views->Media. It provides information about the backup medias for selected backup domain.
Filters are available to shortlist the media as per need

The Media log provides the following details about selected media.

• Media Report - provides details about the media

---------- MEDIA REPORT ---------- name: NBDB05 state: finalized cep: C0A83217 images: 2

• Images in the Media

---------- CONTAINS THESE BACKUP IMAGES ---------- qa-nbu812-o-lnx-g-e2e.devs.com_1692928837 qa-nbu812-o-lnx-g-e2e.devs.com_1692928878

• Media property differences.

---------- MEDIA PROPERTY DIFFERENCES ---------- KeyWord qa-nbu812-o-lnx-g-e2e.devs.com qa-nbu83-d-lnx-g-e2e.devs.com ------------------------ ------------------------------ ------------------------------ AssignedDateTime 2023-08-25 02:00:37.000000 1970-01-01 00:00:00.000000 ImageExpireDateTime 2023-08-28 02:01:18.000000 1970-01-01 00:00:00.000000 LastWriteHostKey 1000003 0 LastWriteHostName qa-nbu812-m-lnx-g-e2e.devs.com ------ LastWriteHostType 1 -1 LegacyRobotType 8 0 MediaGroup 000_00000_TLD --- MediaGroupName 000_00000_TLD --- MediaKey 4000014 4000037 NumberOfImages 3 0 NumberOfValidImages 3 0 PoolName CatalogBackup TZM_OLD_CATALOG PoolNumber 3 7 PrevPoolName Scratch TZM_OLD_CATALOG RetentionLevel 2 11 ServerGroupKey 7000002 0 ServerGroupName NO_SHARING_GROUP ------ SlotNumber 6 -1 TotalWriteKBytes 370418 0 VolumePool CatalogBackup TZM_OLD_CATALOG isCatalogMedia 1 0

• Rules applied in Media

<pre> ---------- RULES ---------- TYP| RULE ID| MAP ID| ORIG| DEST|ORDER| CRITERIA|OPERATION| MATCH| RESIDENCE| DEVICE EME| 3| 2| C0A83217| C0A83273|10001| all| =| all| N/A| N/A ----------------------------------------------------------------------------------

• Audit about Media state during transition.

-------------------------- Media state audit: -------------------------- Timestamp: [2023-08-25 02:07:18.879454] Action: [CreateMedia] Job: [38] State: [imported] Reason: [Changed to imported] -------------------------- Timestamp: [2023-08-25 02:23:17.111485] Action: [QueryMedia] Job: [54] State: [export_pending] Reason: [Changed to export_pending] -------------------------- Timestamp: [2023-08-25 02:23:17.168721] Action: [QueryMedia] Job: [54] State: [exported] Reason: [Changed to exported] -------------------------- Timestamp: [2023-08-25 02:26:24.396248] Action: [CreateMedia] Job: [46] State: [imported] Reason: [Changed to imported] -------------------------- Timestamp: [2023-08-25 02:29:39.199069] Action: [CreateMedia] Job: [68] State: [finalized] Reason: [Changed to finalized] --------------------------

Like the Images, Media also has actions to manipulate the media state on Tranzman.

• Refresh the page
• Ignore the selected media. (mark the selected media as Deselected)
• Reset the state of media back to Selected or Discovered
• Forcefully mark the media as imported (Useful after manually resolving an issue with the media)
• Download the selected media list as csv file.

Config Objects

Config Objects, lists the information on all the available configurations that can be migrated.
Shows the status of each object such as, selected, deselected, imported, not selected.
Like other menus, Config objects supports filter as well. It is available under Views->Config Objects

The different State are:

• deselected: The configuration item is excluded by rules in Selections.
• exported: List the configurations available on Origin.
• imported: list the configurations migrated to Destination.
• not selected: Configurations that cannot be selected or added in rules but are auto selected.
• selected: Selected as part of selections or through Rules.