Monitoring the Export Job Status and Data Transfer Metrics

Monitor phase indicator for data export

This topic describes the monitoring tasks you can perform after your appliance request has been approved and the export job begins. The Project Sponsor role typically performs these tasks. See Roles and Responsibilities.

Note

You can only run Oracle Cloud Infrastructure CLI commands from a Linux host. This differs from running CLI commands for other Oracle Cloud Infrastructure Services on a variety of host operating systems. Appliance-based commands require validation that is only available on Linux hosts.

Once Oracle approves the appliance request and the export job begins, follow progress of the export job status.

To monitor the status of your export job using the Console
  1. Open the navigation menu. Under Core Infrastructure, go to Object Storage and click Data Transfer - Exports.

  2. Select the Compartment from the list.

    The export jobs in that compartment are displayed.

  3. Click the export job for which you want to display the details.

    As an alternative, you can click the Actions icon (Actions icon) associated with your export job, and then click View Details.

  4. Look at the State and Details fields. See Export Appliance State Values for a list of the states and their details.

To monitor the status of your export job using the CLI

At the command prompt on the host, run dts appliance show to monitor the export appliance status.

oci dts export show --job-id job_id

See Export Appliance State Values for a list of the states and their details.

Export Appliance State Values

Here are the export job and appliance state values, including their details:

State

Description

Details

Description

Creating

The job is in the initialization phase. Additional steps are required from the user before it becomes Active.

Pending Manifest Generation

Generate an export manifest for the bucket from where data is being exported.

Pending Submission The export job is in a pending state until you request an appliance for the export job.

Active

The job is awaiting approval from Oracle before an appliance can be assigned for this export job.

In Progress

The export job is approved and is actively being worked on.

Appliance Provisioning

An appliance is being provisioned for the export job.

Downloading

Data download to the appliance is in progress.

Oracle Shipped

Oracle has shipped the appliance.

Customer Received

The appliance has been delivered to the customer site.

Customer Processing

The appliance is being processed at the customer site.

Customer Shipped

The appliance has been shipped to Oracle from the customer site.

Oracle Received

Oracle has received back the appliance after export.

Succeeded

The export is complete.

Closed

The export job is closed.

Failed

The export job failed.

Cancelled

The export job was canceled before an appliance was requested for export.

Deleted The export job was deleted.

Viewing Data Transfer Metrics

Once the data transfer begins, you can view the metrics associated with the export job in the Transfer Appliance Details page in chart or table format.

Tip

Set up your notifications to alert you when the data transfer from Oracle Cloud Infrastructure to the appliance is occurring. When the state changes to In Progress Downloading, you can start viewing data transfer metrics.

Select Metrics under Resources to display each of these measures:

  • Export Files Downloaded: Total number of files downloaded to the appliance for export.

  • Export Bytes Downloaded: Total number of bytes downloaded to the appliance for export.

  • Export Files Remaining: Total number of files left to be downloaded for export.

  • Export Bytes Remaining: Total number of bytes left to be downloaded for export.

  • Export Files in Error: Total number of files in error for export.

  • Export Download Verification Progress: Progress of verification of files that have already been downloaded for export.

Select the Start Time and End Time for these measures. You can either set them manually by entering the days and times in their respective fields, or by selecting the Calendar feature and picking the times that way. You can also select from a list of standard times (last hour, last 6 hours, and so forth) from the Quick Selects list for the period measured. The time period you specify applies to all the measures.

Specify the Interval (for example, 5 minutes, 1 hour) that each measure is recorded from the list.

Specify the Statistic being recorded (for example, Sum, Mean) for each measure from the list.

Tip

Mean is the most useful statistic for data transfer as it reflects an absolute value of the metric.

Choose additional actions from the Options list, including viewing the query in the Metrics Explorer, capturing the URL for the measure, and switching between chart and table view.

Click Reset Charts to delete any existing information in the charts and begin recording new metrics.

See Monitoring Overview for general information on monitoring your Oracle Cloud Infrastructure services.