Generate an offline assessment

This page describes the offline assessment that you can generate with thediscovery client and themcdc CLI.

Overview

The discovery client and themcdc CLIlet you run an offline assessment with the information that you collectin the discovery phase. The offline assessment creates reports that provideyou with a high-level fit assessment result for migration and potentialblockers for different migration journeys. The offline assessment alsodescribes any issues that must be resolved before the migration.

It provides an overall fit assessment using one of the following scores:

  • Excellent fit
  • Good fit, with some findings that might require attention
  • Needs minimal work before migrating
  • Needs moderate work before migrating
  • Needs major work before migrating
  • No fit
  • Insufficient data

You can generate reports in HTML, Microsoft Excel, CSV, and JSON format.

Before you begin

  • To generate an offline assessment report, discover and collect data from yourassets with thediscovery clientor themcdc CLI.

Generate a report with the discovery client

To generate and download an offline report with the discovery client,follow these steps:

  1. In the discovery client application, go to theReports tab.
  2. ClickNew report.
  3. Enter a name for your report, then select the format that you want toexport.
  4. To confirm, clickCreate.

When your report is ready, clickDownload.

Generate a report with themcdc CLI

Themcdc CLI lets you output the offline assessment reportas HTML, JSON, CSV, or XLSX file format. HTML and CSV reports are availableas summary and detailed versions.

HTML

Summary

  1. In the directory where you downloadedmcdc CLI,run the following command:

    Linux

    ./mcdc report --format html --fileREPORT_NAME.html

    Windows

    mcdc.exe report --format html --fileREPORT_NAME.html

    The tool outputs to the current directory an HTML file namedREPORT_NAME.html.

  2. To view the report, openREPORT_NAME.html in abrowser.

    This report includes a cost analysis section.

    Use this report to estimate the cost of running modernized workloads inGoogle Cloud. The report groups VMs by modernization strategy, andsums the cost by modernization strategy, and by overall cost. The costanalysis helps you decide what modernization strategy to purse,depending on how much you want to modernize your workloads, andhow much effort you plan to invest.

    The calculation is based on the VMs configuration details, such asnumber of CPUs, memory, and storage, and excludes VMs that don't fitmodernization targets.

Detailed

  1. In the directory where you downloadedmcdc CLI,run the following command:

    Linux

    ./mcdc report --format html --full --fileREPORT_NAME.html

    Windows

    mcdc.exe report --format html --full --fileREPORT_NAME.html

    The tool outputs to the current directory an HTML file named REPORT_NAME.html.

  2. To view the report, openREPORT_NAME.html in abrowser.

    The report contains a table listing all of the discovered VMs.It is possible to add further columns to the table.You can also apply a text filter to the table.

    You can open any VM in the table to see its attributes, targetjourneys, and app components. You can then open any of the appcomponents from the VM to see their attributes and target journeys.

    The detailed HTML report can fail to open when reporting on a verylarge number of VMs–typically more than 10,000 VMs, but the exactnumber depends on your machine, on your browser, and on the contentof the report. The XLSX report is a good alternative in such cases.

JSON

  1. In the directory where you downloadedmcdc CLI,run the following command:

    Linux

    ./mcdc report --format json --fileREPORT_NAME.json

    Windows

    mcdc.exe report --format json --fileREPORT_NAME.json

    The tool outputs a JSON file namedREPORT_NAME.json tothe current directory.

  2. Open the file with a text editor.

CSV

Summary

  1. In the directory where you downloadedmcdc CLI,run the following command:

    Linux

    ./mcdc report --format csv --fileREPORT_NAME.csv

    Windows

    mcdc.exe report --format csv --fileREPORT_NAME.csv

    The tool outputs a CSV file namedREPORT_NAME.csv to thecurrent directory.

  2. Import the CSV report into your data visualization utility.

    The report contains the fit score for each journey for each VM, butdoesn't include results for individual rules.

Detailed

  1. In the directory where you downloadedmcdc CLI,run the following command:

    Linux

    ./mcdc report --format csv --full --fileREPORT_NAME.csv

    Windows

    mcdc.exe report --format csv --full --fileREPORT_NAME.csv

    The tool outputs a CSV file namedREPORT_NAME.csv to thecurrent directory.

  2. Import the CSV report into your data visualization utility.

    The report contains the results for all rules for each VM andapplication component.

XLSX

  1. In the directory where you downloadedmcdc CLI,run the following command:

    Linux

    ./mcdc report --format xlsx --fileREPORT_NAME.xlsx

    Windows

    mcdc.exe report --format xlsx --fileREPORT_NAME.xlsx

    The tool outputs a spreadsheet namedREPORT_NAME.xlsx to thecurrent directory.

  2. Open the spreadsheet.

    The spreadsheet contains a number of worksheets displaying the following:

    • Information about all discovered VMs
    • Information about all discovered application components
    • Fit score for all journeys for each VM and app component
    • A worksheet per journey containing the results for all rules for thatjourney

Themcdc CLI stores assessment data and log informationin the~/.mcdc directory on the host machine.For information on how to remove this data, seeDelete collected data from host machine.

Specify the target platform

When generating a report, use the--target-platform flag to indicate thespecific platform to which you want to migrate your VMs.The available options are:gcp,gdc,containers, andall.Each option lets you specify a different set of journeys to evaluate:

  • gcp assesses lift and shift journeys to Compute Engine,Google Cloud VMware Engine, and containerization journeys to Google Kubernetes Engine,GKE Autopilot, and Cloud Run.
  • gdc assesses lift and shift journeys to Google Distributed Cloudand containerization journeys to GKE andCloud Run.
  • containers assesses modernization to Google Distributed Cloud, Google Kubernetes Engine,GKE Autopilot, and Cloud Run.
  • all assesses all possible journeys.

For example, to limit the report to thegcp migration journey, runthe following command:

Linux

./mcdc report --formatFORMAT --target-platform gcp --fileREPORT_NAME

Windows

mcdc.exe report --formatFORMAT --target-platform gcp --fileREPORT_NAME

If you use themcdc CLI in aGoogle Distributed Cloud environment,then specify thegdc value for the target platform:

Linux

./mcdc report --formatFORMAT --target-platform gdc --fileREPORT_NAME

Windows

mcdc.exe report --formatFORMAT --target-platform gdc --fileREPORT_NAME

What's next

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.