---
title: Getting Started with Datadog
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > Infrastructure > Datadog Resource Catalog
---

# gcp_vmmigration_utilization_report{% #gcp_vmmigration_utilization_report %}

## `ancestors`{% #ancestors %}

**Type**: `UNORDERED_LIST_STRING`

## `create_time`{% #create_time %}

**Type**: `TIMESTAMP`**Provider name**: `createTime`**Description**: Output only. The time the report was created (this refers to the time of the request, not the time the report creation completed).

## `error`{% #error %}

**Type**: `STRUCT`**Provider name**: `error`**Description**: Output only. Provides details on the state of the report in case of an error.

- `code`**Type**: `INT32`**Provider name**: `code`**Description**: The status code, which should be an enum value of google.rpc.Code.
- `message`**Type**: `STRING`**Provider name**: `message`**Description**: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.

## `frame_end_time`{% #frame_end_time %}

**Type**: `TIMESTAMP`**Provider name**: `frameEndTime`**Description**: Output only. The point in time when the time frame ends. Notice that the time frame is counted backwards. For instance if the "frame_end_time" value is 2021/01/20 and the time frame is WEEK then the report covers the week between 2021/01/20 and 2021/01/14.

## `gcp_display_name`{% #gcp_display_name %}

**Type**: `STRING`**Provider name**: `displayName`**Description**: The report display name, as assigned by the user.

## `labels`{% #labels %}

**Type**: `UNORDERED_LIST_STRING`

## `name`{% #name %}

**Type**: `STRING`**Provider name**: `name`**Description**: Output only. The report unique name.

## `organization_id`{% #organization_id %}

**Type**: `STRING`

## `parent`{% #parent %}

**Type**: `STRING`

## `project_id`{% #project_id %}

**Type**: `STRING`

## `project_number`{% #project_number %}

**Type**: `STRING`

## `region_id`{% #region_id %}

**Type**: `STRING`

## `resource_name`{% #resource_name %}

**Type**: `STRING`

## `state`{% #state %}

**Type**: `STRING`**Provider name**: `state`**Description**: Output only. Current state of the report.**Possible values**:

- `STATE_UNSPECIFIED` - The state is unknown. This value is not in use.
- `CREATING` - The report is in the making.
- `SUCCEEDED` - Report creation completed successfully.
- `FAILED` - Report creation failed.

## `state_time`{% #state_time %}

**Type**: `TIMESTAMP`**Provider name**: `stateTime`**Description**: Output only. The time the state was last set.

## `tags`{% #tags %}

**Type**: `UNORDERED_LIST_STRING`

## `time_frame`{% #time_frame %}

**Type**: `STRING`**Provider name**: `timeFrame`**Description**: Time frame of the report.**Possible values**:

- `TIME_FRAME_UNSPECIFIED` - The time frame was not specified and will default to WEEK.
- `WEEK` - One week.
- `MONTH` - One month.
- `YEAR` - One year.

## `vm_count`{% #vm_count %}

**Type**: `INT32`**Provider name**: `vmCount`**Description**: Output only. Total number of VMs included in the report.

## `vms`{% #vms %}

**Type**: `UNORDERED_LIST_STRUCT`**Provider name**: `vms`**Description**: List of utilization information per VM. When sent as part of the request, the "vm_id" field is used in order to specify which VMs to include in the report. In that case all other fields are ignored.

- `utilization`**Type**: `STRUCT`**Provider name**: `utilization`**Description**: Utilization metrics for this VM.
  - `cpu_average_percent`**Type**: `INT32`**Provider name**: `cpuAveragePercent`**Description**: Average CPU usage, percent.
  - `cpu_max_percent`**Type**: `INT32`**Provider name**: `cpuMaxPercent`**Description**: Max CPU usage, percent.
  - `disk_io_rate_average_kbps`**Type**: `INT64`**Provider name**: `diskIoRateAverageKbps`**Description**: Average disk IO rate, in kilobytes per second.
  - `disk_io_rate_max_kbps`**Type**: `INT64`**Provider name**: `diskIoRateMaxKbps`**Description**: Max disk IO rate, in kilobytes per second.
  - `memory_average_percent`**Type**: `INT32`**Provider name**: `memoryAveragePercent`**Description**: Average memory usage, percent.
  - `memory_max_percent`**Type**: `INT32`**Provider name**: `memoryMaxPercent`**Description**: Max memory usage, percent.
  - `network_throughput_average_kbps`**Type**: `INT64`**Provider name**: `networkThroughputAverageKbps`**Description**: Average network throughput (combined transmit-rates and receive-rates), in kilobytes per second.
  - `network_throughput_max_kbps`**Type**: `INT64`**Provider name**: `networkThroughputMaxKbps`**Description**: Max network throughput (combined transmit-rates and receive-rates), in kilobytes per second.
- `vm_id`**Type**: `STRING`**Provider name**: `vmId`**Description**: The VM's ID in the source.
- `vmware_vm_details`**Type**: `STRUCT`**Provider name**: `vmwareVmDetails`**Description**: The description of the VM in a Source of type Vmware.
  - `architecture`**Type**: `STRING`**Provider name**: `architecture`**Description**: Output only. The CPU architecture.**Possible values**:
    - `VM_ARCHITECTURE_UNSPECIFIED` - The architecture is unknown.
    - `VM_ARCHITECTURE_X86_FAMILY` - The architecture is one of the x86 architectures.
    - `VM_ARCHITECTURE_ARM64` - The architecture is ARM64.
  - `boot_option`**Type**: `STRING`**Provider name**: `bootOption`**Description**: Output only. The VM Boot Option.**Possible values**:
    - `BOOT_OPTION_UNSPECIFIED` - The boot option is unknown.
    - `EFI` - The boot option is EFI.
    - `BIOS` - The boot option is BIOS.
  - `committed_storage_mb`**Type**: `INT64`**Provider name**: `committedStorageMb`**Description**: The total size of the storage allocated to the VM in MB.
  - `cpu_count`**Type**: `INT32`**Provider name**: `cpuCount`**Description**: The number of cpus in the VM.
  - `datacenter_description`**Type**: `STRING`**Provider name**: `datacenterDescription`**Description**: The descriptive name of the vCenter's datacenter this VM is contained in.
  - `datacenter_id`**Type**: `STRING`**Provider name**: `datacenterId`**Description**: The id of the vCenter's datacenter this VM is contained in.
  - `disk_count`**Type**: `INT32`**Provider name**: `diskCount`**Description**: The number of disks the VM has.
  - `gcp_display_name`**Type**: `STRING`**Provider name**: `displayName`**Description**: The display name of the VM. Note that this is not necessarily unique.
  - `guest_description`**Type**: `STRING`**Provider name**: `guestDescription`**Description**: The VM's OS. See for example [https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html](https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html) for types of strings this might hold.
  - `memory_mb`**Type**: `INT32`**Provider name**: `memoryMb`**Description**: The size of the memory of the VM in MB.
  - `power_state`**Type**: `STRING`**Provider name**: `powerState`**Description**: The power state of the VM at the moment list was taken.**Possible values**:
    - `POWER_STATE_UNSPECIFIED` - Power state is not specified.
    - `ON` - The VM is turned ON.
    - `OFF` - The VM is turned OFF.
    - `SUSPENDED` - The VM is suspended. This is similar to hibernation or sleep mode.
  - `uuid`**Type**: `STRING`**Provider name**: `uuid`**Description**: The unique identifier of the VM in vCenter.
  - `vm_id`**Type**: `STRING`**Provider name**: `vmId`**Description**: The VM's id in the source (note that this is not the MigratingVm's id). This is the moref id of the VM.

## `zone_id`{% #zone_id %}

**Type**: `STRING`
