Difference between revisions of "Reporting and Logging"

From Tranzman Documentation
Jump to: navigation, search
(→‎Alerts)
Line 1: Line 1:
−
=== Introduction ===
+
__TOC__
−
<b>Tranzman</b> provides an extensive logging and reporting on the configs involved in migration. <br>
+
<br>
−
It helps to understand the status of the migrated components and useful for troubleshooting issues related to migration. <br>
+
<br>
 +
<div style="background-color:#edf7ff; padding: 1.5rem; border-radius:8px; max-width:80%; margin: 0 auto; margin-bottom:2rem;">
 +
  <h1 style="border-bottom:none; font-size:2.5em; font-weight:bold; text-align:center;">Reporting & Logging in Tranzman Appliance</h1>
 +
  <p style="font-size:1.2em; text-align:left;">
 +
    <b>Tranzman</b> provides extensive logging and reporting for all migration activities.<br>
 +
    Reports help track migration status, troubleshoot issues, and audit migrated components.<br>
 +
    Access reporting features from <b>Views &rarr; Reports</b> in the web console.
 +
  </p>
 +
</div>
  
 +
<div style="max-width:80%; margin: 0 auto;">
 +
  <div style="background-color:#fffbf4; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
 +
    <h2 style="border-bottom:2px solid #ffe0b2; padding-bottom:0.5rem; font-size:1.5em;">Reports Overview</h2>
 +
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li>
 +
        <b>Reports</b> provide statistical charts on image catalog and related information.<br>
 +
        Reports are available for individual environments or as a collective view.<br>
 +
        Use the <b>Selections</b> button (top right) to filter charts.
 +
      </li>
 +
      <li>
 +
        <span style="vertical-align:middle;">[[File:ReportsFullSelections.jpg|100x100px]]</span> Charts for selected migration data.<br>
 +
        <span style="vertical-align:middle;">[[File:ReportsNoneSelections.jpg|100x100px]]</span> Charts for non-selected data.<br>
 +
        <span style="vertical-align:middle;">[[File:ReportsBothSelections.jpg|100x100px]]</span> Charts for both selected and non-selected data.
 +
      </li>
 +
      <li>
 +
        Example: Charts for selected data.<br>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:SelectedDataReports.jpg|700px]]</div>
 +
      </li>
 +
      <li>
 +
        <b>Summary</b> and <b>Environment History</b> reports are available.<br>
 +
        Click <span style="vertical-align:middle;">[[File:summary_report_icon.jpg | 25x25px]]</span> for Summary.<br>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Reports_Summary_brief1.jpg|700px]]</div>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Reports_Summary_envdetails.jpg|700px]]</div>
 +
      </li>
 +
      <li>
 +
        <b>Summary Report</b> shows:
 +
        <ul>
 +
          <li>Tranzman appliance state (e.g., configuration_migration, data_transfer, completion)</li>
 +
          <li>Agent connection status (RUNNING or STALLED)</li>
 +
          <li>Time since last agent connection</li>
 +
          <li>Agent role: Origin (O), Destination (D), finalized (Of/Df)</li>
 +
        </ul>
 +
      </li>
 +
      <li>
 +
        <b>Image State Details:</b>
 +
        <ul>
 +
          <li><b>data_expired</b>: Images expired</li>
 +
          <li><b>data_purged</b>: Images migrated to destination</li>
 +
          <li><b>deselected</b>: Images deselected (e.g., Catalog backup)</li>
 +
          <li><b>discovered</b>: Images discovered on server</li>
 +
          <li><b>export_complete</b>: Exported images</li>
 +
          <li><b>export_in_progress</b>: Export in progress</li>
 +
          <li><b>export_fatal</b>: Export failed (Origin troubleshooting)</li>
 +
          <li><b>manipulate_complete</b>: Images updated for import (stored on /data)</li>
 +
          <li><b>manipulate_in_progress</b>: Images being updated</li>
 +
          <li><b>import_complete</b>: Migrated images</li>
 +
          <li><b>import_in_progress</b>: Import in progress</li>
 +
          <li><b>import_fatal</b>: Import failed (Destination troubleshooting)</li>
 +
        </ul>
 +
      </li>
 +
      <li>
 +
        <b>Environment History:</b> Click <span style="vertical-align:middle;">[[File:Reports_env_history_icon.jpg | 15x15px]]</span> for environment history.<br>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Reports_env_history.jpg |700px]]</div>
 +
      </li>
 +
    </ul>
 +
  </div>
  
−
===Reports===
+
  <div style="background-color:#fef3f7; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
−
<b>Reports</b> provides statistical reporting on image catalog and its associated information. The report is available for individual environments and/or as collective. <br>
+
    <h2 style="border-bottom:2px solid #f8bbd0; padding-bottom:0.5rem; font-size:1.5em;">Alerts & Activities</h2>
−
Click on <b>Views</b>-><b>Reports</b> to access those charts. A <b>selections</b> button on the top right corner is used as a filter for the charts.
+
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li>
 +
        <b>Alerts:</b> View all issues identified during transition.<br>
 +
        Shows time, Task ID, category, and description.<br>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Alerts_overview.jpg | 700px]]</div>
 +
      </li>
 +
      <li>
 +
        <b>Activities:</b> Shows all job information.<br>
 +
        Click a job for task details; download logs for troubleshooting.<br>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Activities_task_details.jpg|700px]]</div>
 +
      </li>
 +
    </ul>
 +
  </div>
  
−
[[File:ReportsFullSelections.jpg|100x100px]] will display the charts against data selected for migration.
+
  <div style="background-color:#eff8f0; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
 +
    <h2 style="border-bottom:2px solid #c8e6c9; padding-bottom:0.5rem; font-size:1.5em;">Images Management</h2>
 +
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li>
 +
        View all discovered images for backup domains.<br>
 +
        Manipulate migration: ignore, reset, force import, etc.<br>
 +
        Click an image for details and audit stages.<br>
 +
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Images_task_logs.jpg|700px]]</div>
 +
      </li>
 +
      <li>
 +
        Image actions:
 +
        <ul>
 +
          <li>[[File:Hostmanagement_actions_origintest.jpg|15x15px]] Refresh images</li>
 +
          <li>[[File:Images_ignore_icon.jpg|15x15px]] Ignore (mark as <b>Deselected</b>)</li>
 +
          <li>[[File:Images_reset_icon.jpg|15x15px]] Reset state to <b>Selected</b> or <b>Discovered</b></li>
 +
          <li>[[File:Images_import_icon.jpg|15x15px]] Force import</li>
 +
          <li>[[File:Hostmanagement_operations_download.jpg|15x15px]] Download as CSV</li>
 +
          <li>[[File:Hostmanagement_operations_upload.jpg|15x15px]] Upload custom image list</li>
 +
        </ul>
 +
      </li>
 +
      <li>
 +
        Filters: Origin, Destination, Policy Type, State, Category, and custom text.<br>
 +
        All dropdowns support multi-selection; default is no filter.
 +
      </li>
 +
    </ul>
 +
  </div>
  
−
[[File:ReportsNoneSelections.jpg|100x100px]] will display the charts against non selected data.
+
  <div style="background-color:#fffbf4; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
−
 
+
    <h2 style="border-bottom:2px solid #ffe0b2; padding-bottom:0.5rem; font-size:1.5em;">Media Management</h2>
−
[[File:ReportsBothSelections.jpg|100x100px]] will display the charts against both selected and non selected data.
+
    <ul style="font-size:1.1em; margin-left:2em;">
−
 
+
      <li>
−
Below picture shows the charts against the selected data.<br>
+
        Access media info under <b>Views &rarr; Media</b>.<br>
−
[[File:SelectedDataReports.jpg|700px]]
+
        Filter media as needed.<br>
−
 
+
        <div style="display:inline-block; box-shadow:5px 5px 10px grey;">[[File:Media_task_details.jpg|700px]]</div>
−
 
+
      </li>
−
<b>Reports</b> also provides two main additional reporting- <b>Summary</b> and <b>Environment History</b> <br>
+
      <li>
−
 
+
        <b>Media Report:</b>
−
====Summary====
+
        <pre style="background:#fff; color:#333; border-radius:5px; box-shadow:5px 5px 10px grey; padding:1em;">
−
To view the <b>Summary</b> report, navigate to <b>Views</b>-><b>Reports</b> and click on the [[File:summary_report_icon.jpg | 25x25px]] icon. <br>
 
−
Summary report provides an overall insight of the image Transition status, such as exported, manipulated, imported etc.,.It also gives the Agent information. <br>
 
−
The report has two sub section - Agent state information and Image state information. <br>
 
−
[[File:Reports_Summary_brief1.jpg|700px]]
 
−
 
 
−
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).<br>
 
−
If finalized, then it is denoted as (Of - Origin finalized) and (Df - destination finalized) <br>
 
−
[[File:Reports_Summary_envdetails.jpg|700px]]
 
−
 
 
−
Below is the detailed info of each state of Image- <br>
 
−
* <b>data_expired</b> - Shows the number of Images that already expired
 
−
* <b>data_purged</b> - Number of images that are migrated to destination
 
−
* <b>deselected</b> - tells the number of images that are deselected (by default, <b>Tranzman</b> deselects <i>Catalog</i> backup)
 
−
* <b>discovered</b> - number of images that are discovered on server.
 
−
 
 
−
* <b>export_complete</b> - Images that are exported.
 
−
* <b>export_in_progress</b> - number of images which are export in progress
 
−
* <b>export_fatal</b> - failed images during export. To be troubleshooted on Origin side.
 
−
 
 
−
* <b>manipulate_complete</b> - Images are updated for import on Destination. These images are stored on Tranzman server (/data partition)
 
−
* <b>manipulate_in_progress</b> - Shows the number of images being updated by Tranzman
 
−
 
 
−
* <b>import_complete</b> - Total number of images migrated to destination
 
−
* <b>import_in_progress</b> - Number of images importing in progress
 
−
* <b>import_fatal</b> - Images that failed to migrate. troubleshooting required on destination side.
 
−
 
 
−
====Environment History====
 
−
To view the <b>Environment History</b>, Navigate to <b>Views</b> -> <b>Reports</b> and click on the [[File:Reports_env_history_icon.jpg | 15x15px]] icon. <br>
 
−
A pop-up window showing the history report of environment, the state and the reason for the change in state <br>
 
−
[[File:Reports_env_history.jpg |700px]]
 
−
 
 
−
 
 
−
===Alerts===
 
−
<b>Alerts</b> is a single place to view all the issues identified by Tranzman during transition. <br>
 
−
It provides the time of the issue, Task id, category of the issue and a brief description of the issue. <br>
 
−
 
 
−
[[File:Alerts_overview.jpg | 700px]]
 
−
 
 
−
===Activities===
 
−
Activities shows all the jobs information. Clicking on the job, provides detailed information about the task. <br>
 
−
The task logs can also be downloaded for troubleshooting. <br>
 
−
[[File:Activities_task_details.jpg|700px]]
 
−
 
 
−
 
 
−
===Images===
 
−
Provides the complete list of discovered images of all the backup domain. <br>
 
−
Options to manipulate the data migration (ignore images, Reset an image, Force an image as imported etc.,)  <br>
 
−
Click on an image to view the image information and the different manipulation stages (Image audit) <br>
 
−
[[File:Images_task_logs.jpg|700px]]
 
−
 
 
−
Tranzman provides different options as below to manipulate the images.  <br>
 
−
* [[File:Hostmanagement_actions_origintest.jpg|15x15px]] Refreshes the images page
 
−
* [[File:Images_ignore_icon.jpg|15x15px]] Ignore the selected images. (mark the selected images as <b>Deselected</b>) 
 
−
* [[File:Images_reset_icon.jpg|15x15px]] Reset the state of image back to <b>Selected</b> or <b>Discovered</b>
 
−
* [[File:Images_import_icon.jpg|15x15px]] Forcefully mark the image as imported
 
−
* [[File:Hostmanagement_operations_download.jpg|15x15px]] Download the selected images as <i>csv</i> file.
 
−
* [[File:Hostmanagement_operations_upload.jpg|15x15px]] Upload a custom image list.
 
−
 
 
−
Following filters can be applied on images list:  <br>
 
−
* 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 <b>Views</b>-><b>Media</b>. It provides information about the backup medias for selected backup domain.<br>
 
−
Filters are available to shortlist the media as per need <br>
 
−
[[File:Media_task_details.jpg|700px]]
 
−
 
 
−
The <b>Media</b> log provides the following details about selected media.
 
−
* Media Report - provides details about the media
 
−
<table style="width:50%;color:white;background-color:white;font-family:monospace,monospace;border-collapse:seperate;box-shadow: 5px 5px 10px grey;">
 
−
<tr><td>
 
−
<pre>
 
 
----------            MEDIA REPORT            ----------
 
----------            MEDIA REPORT            ----------
−
 
 
name: NBDB05
 
name: NBDB05
 
state: finalized
 
state: finalized
 
cep: C0A83217
 
cep: C0A83217
 
images: 2
 
images: 2
−
</pre>
+
        </pre>
−
</td></tr>
+
      </li>
−
</table>
+
      <li>
−
 
+
        <b>Images in Media:</b>
−
* Images in the Media
+
        <pre style="background:#fff; color:#333; border-radius:5px; box-shadow:5px 5px 10px grey; padding:1em;">
−
<table style="width:50%;color:white;background-color:white;font-family:monospace,monospace;border-collapse:seperate;box-shadow: 5px 5px 10px grey;">
 
−
<tr><td>
 
−
<pre>
 
 
----------    CONTAINS THESE BACKUP IMAGES    ----------
 
----------    CONTAINS THESE BACKUP IMAGES    ----------
−
 
 
     qa-nbu812-o-lnx-g-e2e.devs.com_1692928837
 
     qa-nbu812-o-lnx-g-e2e.devs.com_1692928837
 
     qa-nbu812-o-lnx-g-e2e.devs.com_1692928878
 
     qa-nbu812-o-lnx-g-e2e.devs.com_1692928878
−
 
+
        </pre>
−
</pre>
+
      </li>
−
</td></tr>
+
      <li>
−
</table>
+
        <b>Media Property Differences:</b>
−
 
+
        <pre style="background:#fff; color:#333; border-radius:5px; box-shadow:5px 5px 10px grey; padding:1em;">
−
* Media property differences.
 
−
<table style="width:50%;color:white;background-color:white;font-family:monospace,monospace;border-collapse:seperate;box-shadow: 5px 5px 10px grey;">
 
−
<tr><td>
 
−
<pre>
 
 
----------          MEDIA PROPERTY DIFFERENCES          ----------
 
----------          MEDIA PROPERTY DIFFERENCES          ----------
−
 
 
KeyWord                    qa-nbu812-o-lnx-g-e2e.devs.com  qa-nbu83-d-lnx-g-e2e.devs.com
 
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
 
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
+
        </pre>
−
LastWriteHostName          qa-nbu812-m-lnx-g-e2e.devs.com                        ------
+
      </li>
−
LastWriteHostType                                      1                            -1
+
      <li>
−
LegacyRobotType                                        8                              0
+
        <b>Rules Applied in Media:</b>
−
MediaGroup                                  000_00000_TLD                            ---
+
        <pre style="background:#fff; color:#333; border-radius:5px; box-shadow:5px 5px 10px grey; padding:1em;">
−
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
 
−
</pre>
 
−
</td></tr>
 
−
</table>
 
−
 
 
−
* Rules applied in Media
 
−
<table style="width:50%;color:white;background-color:white;font-family:monospace,monospace;border-collapse:seperate;box-shadow: 5px 5px 10px grey;">
 
−
<tr><td>
 
−
<pre>
 
−
<pre>
 
 
----------                RULES                ----------
 
----------                RULES                ----------
−
 
 
  TYP|  RULE ID|    MAP ID|      ORIG|      DEST|ORDER|            CRITERIA|OPERATION|                    MATCH|          RESIDENCE|              DEVICE
 
  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
 
  EME|        3|        2|  C0A83217|  C0A83273|10001|                all|        =|                      all|                N/A|                N/A
 
----------------------------------------------------------------------------------
 
----------------------------------------------------------------------------------
−
</pre>
+
        </pre>
−
</td></tr>
+
      </li>
−
</table>
+
      <li>
−
 
+
        <b>Media State Audit:</b>
−
* Audit about Media state during transition.
+
        <pre style="background:#fff; color:#333; border-radius:5px; box-shadow:5px 5px 10px grey; padding:1em;">
−
<table style="width:50%;color:white;background-color:white;font-family:monospace,monospace;border-collapse:seperate;box-shadow: 5px 5px 10px grey;">
 
−
<tr><td><pre>
 
 
--------------------------
 
--------------------------
 
Media state audit:
 
Media state audit:
Line 181: Line 167:
 
     State: [imported]
 
     State: [imported]
 
     Reason: [Changed to imported]
 
     Reason: [Changed to imported]
−
--------------------------
+
...
−
    Timestamp: [2023-08-25 02:23:17.111485]
+
        </pre>
−
    Action: [QueryMedia]
+
      </li>
−
    Job: [54]
+
      <li>
−
    State: [export_pending]
+
        Media actions:
−
    Reason: [Changed to export_pending]
+
        <ul>
−
--------------------------
+
          <li>[[File:Hostmanagement_actions_origintest.jpg|15x15px]] Refresh</li>
−
    Timestamp: [2023-08-25 02:23:17.168721]
+
          <li>[[File:Images_ignore_icon.jpg|15x15px]] Ignore (mark as <b>Deselected</b>)</li>
−
    Action: [QueryMedia]
+
          <li>[[File:Images_reset_icon.jpg|15x15px]] Reset state</li>
−
    Job: [54]
+
          <li>[[File:Images_import_icon.jpg|15x15px]] Force import (after manual resolution)</li>
−
    State: [exported]
+
          <li>[[File:Hostmanagement_operations_download.jpg|15x15px]] Download as CSV</li>
−
    Reason: [Changed to exported]
+
        </ul>
−
--------------------------
+
      </li>
−
    Timestamp: [2023-08-25 02:26:24.396248]
+
    </ul>
−
    Action: [CreateMedia]
+
  </div>
−
    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]
 
−
--------------------------
 
−
</pre>
 
−
</td></tr>
 
−
</table>
 
−
 
 
−
 
 
−
Like the <b>Images</b>, <b>Media</b> also has actions to manipulate the media state on Tranzman. <br>
 
−
* [[File:Hostmanagement_actions_origintest.jpg|15x15px]] Refresh the page
 
−
* [[File:Images_ignore_icon.jpg|15x15px]] Ignore the selected media. (mark the selected media as <b>Deselected</b>)  
 
−
* [[File:Images_reset_icon.jpg|15x15px]] Reset the state of media back to <b>Selected</b> or <b>Discovered</b>
 
−
* [[File:Images_import_icon.jpg|15x15px]] Forcefully mark the media as imported (Useful after manually resolving an issue with the media)
 
−
* [[File:Hostmanagement_operations_download.jpg|15x15px]] Download the selected media list as <i>csv</i> file.
 
−
 
 
−
 
 
−
===Config Objects===
 
−
Config Objects, lists the information on all the available configurations that can be migrated. <br>
 
−
Shows the status of each object such as, selected, deselected, imported, not selected. <br>
 
−
Like other menus, Config objects supports filter as well. It is available under <b>Views</b>-><b>Config Objects</b> <br>
 
−
 
 
−
The different State are: <br>
 
−
* <b>deselected</b>: The configuration item is excluded by rules in Selections.
 
−
* <b>exported</b>: List the configurations available on Origin.
 
−
* <b>imported</b>: list the configurations migrated to Destination.
 
−
* <b>not selected</b>: Configurations that cannot be selected or added in rules but are auto selected.
 
−
* <b>selected</b>: Selected as part of selections or through Rules.
 
−
 
 
−
 
 
−
 
 
−
 
 
  
 +
  <div style="background-color:#eff8f0; padding:1.5rem; border-radius:8px; box-shadow:0 2px 4px rgba(0,0,0,0.06); margin-bottom:2rem;">
 +
    <h2 style="border-bottom:2px solid #c8e6c9; padding-bottom:0.5rem; font-size:1.5em;">Config Objects</h2>
 +
    <ul style="font-size:1.1em; margin-left:2em;">
 +
      <li>
 +
        Lists all available configuration objects for migration.<br>
 +
        Shows status: selected, deselected, imported, not selected.<br>
 +
        Filter options available under <b>Views &rarr; Config Objects</b>.
 +
      </li>
 +
      <li>
 +
        <b>States:</b>
 +
        <ul>
 +
          <li><b>deselected</b>: Excluded by rules in Selections</li>
 +
          <li><b>exported</b>: Available on Origin</li>
 +
          <li><b>imported</b>: Migrated to Destination</li>
 +
          <li><b>not selected</b>: Auto-selected, not in rules</li>
 +
          <li><b>selected</b>: Selected via Selections or Rules</li>
 +
        </ul>
 +
      </li>
 +
    </ul>
 +
  </div>
 +
</div>
  
−
{| class="wikitable"  style="margin:auto;width:100%;color:blue;text-align:center;borderstyle=ridge;"
+
<div style="display:flex; justify-content:space-between; margin-top:2rem; padding:1rem; background-color:#ffffff; max-width:90%; margin: 2rem auto 0;">
−
|-
+
  <div style="text-align:left;">
−
| [[Image:prev_icon.jpg|30px|link=Manage_Hosts]]
+
    [[Image:prev_icon.jpg|30px|link=Manage_Hosts]]
−
|| [[Image:next_icon.jpg|30px|link=Finalize]]
+
  </div>
−
|}
+
  <div style="text-align:right;">
 +
    [[Image:next_icon.jpg|30px|link=Finalize]]
 +
  </div>
 +
</div>

Revision as of 07:14, 12 September 2025



Reporting & Logging in Tranzman Appliance

Tranzman provides extensive logging and reporting for all migration activities.
Reports help track migration status, troubleshoot issues, and audit migrated components.
Access reporting features from Views → Reports in the web console.

Reports Overview

  • Reports provide statistical charts on image catalog and related information.
    Reports are available for individual environments or as a collective view.
    Use the Selections button (top right) to filter charts.
  • ReportsFullSelections.jpg Charts for selected migration data.
    ReportsNoneSelections.jpg Charts for non-selected data.
    ReportsBothSelections.jpg Charts for both selected and non-selected data.
  • Example: Charts for selected data.
    SelectedDataReports.jpg
  • Summary and Environment History reports are available.
    Click Summary report icon.jpg for Summary.
    Reports Summary brief1.jpg
    Reports Summary envdetails.jpg
  • Summary Report shows:
    • Tranzman appliance state (e.g., configuration_migration, data_transfer, completion)
    • Agent connection status (RUNNING or STALLED)
    • Time since last agent connection
    • Agent role: Origin (O), Destination (D), finalized (Of/Df)
  • Image State Details:
    • data_expired: Images expired
    • data_purged: Images migrated to destination
    • deselected: Images deselected (e.g., Catalog backup)
    • discovered: Images discovered on server
    • export_complete: Exported images
    • export_in_progress: Export in progress
    • export_fatal: Export failed (Origin troubleshooting)
    • manipulate_complete: Images updated for import (stored on /data)
    • manipulate_in_progress: Images being updated
    • import_complete: Migrated images
    • import_in_progress: Import in progress
    • import_fatal: Import failed (Destination troubleshooting)
  • Environment History: Click Reports env history icon.jpg for environment history.
    Reports env history.jpg

Alerts & Activities

  • Alerts: View all issues identified during transition.
    Shows time, Task ID, category, and description.
  • Activities: Shows all job information.
    Click a job for task details; download logs for troubleshooting.
    Activities task details.jpg

Images Management

  • View all discovered images for backup domains.
    Manipulate migration: ignore, reset, force import, etc.
    Click an image for details and audit stages.
    Images task logs.jpg
  • Image actions:
    • Hostmanagement actions origintest.jpg Refresh images
    • Images ignore icon.jpg Ignore (mark as Deselected)
    • Images reset icon.jpg Reset state to Selected or Discovered
    • Images import icon.jpg Force import
    • Hostmanagement operations download.jpg Download as CSV
    • Hostmanagement operations upload.jpg Upload custom image list
  • Filters: Origin, Destination, Policy Type, State, Category, and custom text.
    All dropdowns support multi-selection; default is no filter.

Media Management

  • Access media info under Views → Media.
    Filter media as needed.
    Media task details.jpg
  • Media Report: 
    ----------             MEDIA REPORT             ----------
name: NBDB05
state: finalized
cep: C0A83217
images: 2
  • Images in 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
...
  • Rules Applied in Media: 
    ----------                 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
----------------------------------------------------------------------------------
  • Media State Audit: 
    --------------------------
Media state audit:
--------------------------
    Timestamp: [2023-08-25 02:07:18.879454]
    Action: [CreateMedia]
    Job: [38]
    State: [imported]
    Reason: [Changed to imported]
...
  • Media actions:
    • Hostmanagement actions origintest.jpg Refresh
    • Images ignore icon.jpg Ignore (mark as Deselected)
    • Images reset icon.jpg Reset state
    • Images import icon.jpg Force import (after manual resolution)
    • Hostmanagement operations download.jpg Download as CSV

Config Objects

  • Lists all available configuration objects for migration.
    Shows status: selected, deselected, imported, not selected.
    Filter options available under Views → Config Objects.
  • States:
    • deselected: Excluded by rules in Selections
    • exported: Available on Origin
    • imported: Migrated to Destination
    • not selected: Auto-selected, not in rules
    • selected: Selected via Selections or Rules
   Prev icon.jpg

   Next icon.jpg
Retrieved from "https://docs.stoneram.com/index.php?title=Reporting_and_Logging&oldid=3482"