Export collected data - AWS Application Discovery Service

Export collected data

For both the Application Discovery Service Agentless Collector (Agentless Collector) and AWS Application Discovery Agent (Discovery Agent), after the data collection process starts, you can export their collected data about your servers and VMs. This data can be exported either by interacting with the console or by making API calls through the AWS CLI, depending on which discovery tool you used to collect data.

Instructions are provided below for both ways by expanding your method of choice:

The data that's collected from all the agentless collectors and discovery agents running on your hosts and VMs can be bulk exported using the AWS Command Line Interface (AWS CLI). The AWS CLI must be installed in your environment before exporting data.

To install the AWS CLI and export collected data
  1. If you have not already done so, install the AWS CLI appropriate to your OS type (Windows or Mac/Linux). For installation instructions, see the AWS Command Line Interface User Guide.

  2. Open the Command prompt (Windows) or Terminal (MAC/Linux).

    1. Type aws configure and press Enter.

    2. Enter your AWS Access Key Id and AWS Secret Access Key.

    3. Enter us-west-2 for the Default Region Name.

    4. Enter text for Default Output Format.

  3. Type the following command to generate an export ID:

    aws discovery start-export-task
  4. Using the export ID generated in the previous step, type the following command to generate an S3 URL as a value for the parameter "configurationsDownloadUrl":

    aws discovery describe-export-tasks --export-ids <export ID>
  5. Copy the URL generated in the previous step and paste it in a browser to download the zip file with collected data of the discovered servers.

Exporting agent collected data from the console is limited to one agent, when you are on the detail page for a specific server. On the detail page, you can find the server's export jobs listed at the bottom of the screen, underneath Exports. If no export jobs exist, the table is empty. You can run up to five exports of server data at a time.

To export collected data about a discovered server
  1. In the navigation pane, choose Servers.

  2. In the Server info column, choose the link for the server that you want to export data for.

  3. In the Exports section at the bottom of the screen, choose Export server details.

  4. For Export server details, fill in Start date and Time.

    Note

    The start time can't be more than 72 hours prior from the current time.

  5. Choose Export to start the job. The initial status is In-progress; to update the status, click the refresh icon for the Exports section.

  6. When the export job is complete, choose Download and save the .zip file.

  7. Unzip the saved file. A set of .csv files contains the export data.

    You can open the .csv files in Microsoft Excel and review the exported server data.

    Among the files, you can find a JSON file containing data about the export task and its results.

Note

For information on generating and exporting Amazon Elastic Compute Cloud (Amazon EC2) instance recommendations in the AWS Migration Hub console, see Amazon EC2 instance recommendations in the AWS Migration Hub User Guide.