Entities, lookup information, and metrics for Google Cloud Platform
This topic explains the predefined metrics that are available from the Google Cloud Platform services and how they are mapped to the BMC Helix Continuous Optimization metrics. Most of the metrics are available to all your GCP projects.
Entity list
The Google Cloud Platform - GCP API Extractor monitors the following entities:
- Project - Google Cloud
- Virtual Machine - Google Cloud
Entity relationship
The following table shows the entity relationship details:
Parent entity | Child entity | Relationship type |
|---|---|---|
Project - Google Cloud (project:gcp) | Virtual Machine - Google Cloud (gm:gcp) | PROJECT_CONTAINS_GM |
Lookup information
The following table contains the lookup information for the GCP entities.
Entity type | Lookup fields | |
|---|---|---|
Strong | Weak | |
Project - Google Cloud | PROJECT_ID | Not applicable |
Virtual Machine - Google Cloud | INSTANCE_ID | Not applicable |
Metric mapping
The following tables contain the mapping between the GCP metrics and the BMC Helix Continuous Optimization metrics.
Configuration metrics
BMC Helix Continuous Optimization metric | Google Cloud metric | Formula |
|---|---|---|
AVAILABILITY_ZONE | Instance.zone | |
CPU_FAMILY | Instance.cpuPlatform | |
CPU_NUM | machineType.guestCpus | |
CREATION_TIME | Instance.creationTimestamp | |
DISK_NUM | Instance.disk | Instance.getDisks().size() |
NETIF_NUM | Instance.networkInterfaces | Instance.getNetworkInterfaces().size() |
REGION_NAME | Instance.zone | zone.substring(0, zone.length() - 2) |
REQUESTED_INSTANCE_TYPE | Instance.machineType | |
TOTAL_REAL_MEM | machineType.memoryMb | |
VM_LAST_STATUS | Instance.status |
Default performance metrics
The following table contains the out-of-the-box performance metrics that the Google Cloud Platform provides. The Google Cloud metric type names must be prefixed with compute.googleapis.com/. That prefix has been omitted so that the names fit within the table.
BMC Helix Continuous Optimization metric | Display name (Google Cloud Metric type) | Operating system | Statistic | DataType | Reducer | GroupBy Fields |
|---|---|---|---|---|---|---|
CPU_UTIL | CPU utilization (instance/cpu/utilization) | Both | ALIGN_MEAN | DOUBLE | ||
DISK_READ_RATE | Disk read bytes (instance/disk/read_bytes_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
DISK_WRITE_RATE | Disk write bytes (instance/disk/write_bytes_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
DISK_TRANSFER_RATE | Disk read bytes (instance/disk/read_bytes_count) Disk write bytes (instance/disk/write_bytes_count) | Both | ALIGN_RATE ALIGN_RATE | DOUBLE DOUBLE | REDUCE_SUM REDUCE_SUM | resource.labels.instance_id resource.labels.instance_id |
DISK_IO_READ_RATE | Disk read operations (instance/disk/read_ops_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
DISK_IO_WRITE_RATE | Disk write operations (instance/disk/write_ops_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
DISK_IO_RATE | Disk read operations (instance/disk/read_ops_count) Disk write operations (instance/disk/write_ops_count) | Both | ALIGN_RATE ALIGN_RATE | DOUBLE DOUBLE | REDUCE_SUM REDUCE_SUM | resource.labels.instance_id resource.labels.instance_id |
NET_IN_BYTE_RATE | Received bytes (instance/network/received_bytes_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
NET_OUT_BYTE_RATE | Sent bytes (instance/network/sent_bytes_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
NET_BYTE_RATE1 | Received bytes (instance/network/received_bytes_count) Sent bytes (instance/network/sent_bytes_count) | Both | ALIGN_RATE ALIGN_RATE | DOUBLE DOUBLE | REDUCE_SUM REDUCE_SUM | resource.labels.instance_id resource.labels.instance_id |
NET_BIT_RATE | Received bytes (instance/network/received_bytes_count) Sent bytes (instance/network/sent_bytes_count) | Both | ALIGN_RATE ALIGN_RATE | DOUBLE DOUBLE | REDUCE_SUM REDUCE_SUM | resource.labels.instance_id resource.labels.instance_id |
NET_OUT_PKT_RATE | Sent packets (instance/network/sent_packets_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
NET_IN_PKT_RATE | Received packets (instance/network/received_packets_count) | Both | ALIGN_RATE | DOUBLE | REDUCE_SUM | resource.labels.instance_id |
NET_PKT_RATE | Sent packets (instance/network/sent_packets_count) Received packets (instance/network/received_packets_count) | Both | ALIGN_RATE ALIGN_RATE | DOUBLE DOUBLE | REDUCE_SUM REDUCE_SUM | resource.labels.instance_id resource.labels.instance_id |
UPTIME | Uptime (instance/uptime) | Both | ALIGN_DELTA | DOUBLE |
1 - Indicates metrics that are set at level 4. These metrics are imported only when the collection level of the ETL is set to ‘Extended’. For information about changing the collection level, see Google-Cloud-Platform-GCP-API-Extractor.
The Sub metric label key, Sub metric label value, and Sub resource label key columns are not applicable for the default performance metrics.
For more information, see theGoogle Cloud metricsdocumentation.
Performance metrics from the agent
The following table contains the performance metrics that you get after installing the Monitoring Agent and enabling the Stackdriver monitoring. The following metric type names must be prefixed with agent.googleapis.com/. That prefix has been omitted so that the names fit within the table.
BMC Helix Continuous Optimization metric | Display name (Google Cloud metric type) | Operating system | Statistic | DataType | Sub metric label key | Sub metric label value | Sub resource label key | Reducer | GroupBy Fields |
|---|---|---|---|---|---|---|---|---|---|
BYFS_USED_SPACE_PCT | Disk utilization (disk/percent_used) | Both | ALIGN_MEAN | DOUBLE | State | State | device Devices that end with fs are excluded. | ||
BYFS_USED | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | Used | device Devices that end with fs are excluded. | ||
BYFS_FREE | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | Free | device Devices that end with fs are excluded. | ||
BYFS_SIZE | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | (Used + Free) | device Devices that end with fs are excluded. | ||
TOTAL_FS_USED | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | Used | device Devices that end with fs are excluded. | ||
TOTAL_FS_FREE | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | Free | device Devices that end with fs are excluded. | ||
TOTAL_FS_SIZE | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | (Used + Free) | device Devices that end with fs are excluded. | ||
TOTAL_FS_UTIL | Disk usage (disk/bytes_used) | Linux | ALIGN_MEAN | DOUBLE | State | (Used / (Used + Free)) | device Devices that end with fs are excluded. | ||
BYDISK_SERVICE_TIME | Disk average I/O time (disk/io_time) | Linux | ALIGN_DELTA | INT64 | device Devices that do not end with a digit are excluded. | ||||
BYDISK_PHYS_IO_READ_RATE | Disk operations (disk/operation_count) | Linux | ALIGN_RATE | DOUBLE | Direction | Read | device Devices that do not end with a digit are excluded. | ||
BYDISK_PHYS_IO_WRITE_RATE | Disk operations (disk/operation_count) | Linux | ALIGN_RATE | DOUBLE | Direction | Write | device Devices that do not end with a digit are excluded. | ||
BYDISK_PHYS_IO_RATE | Disk operations (disk/operation_count) | Linux | ALIGN_RATE | DOUBLE | (Read + Write) | device Devices that do not end with a digit are excluded. | |||
DISK_IO_BLOCKED | Disk pending operations (disk/pending_operations) | Linux | ALIGN_RATE | DOUBLE | device | ||||
MEM_REAL_USED | Memory utilization (memory/percent_used) TOTAL_REAL_MEM | Both | ALIGN_MEAN | DOUBLE | State | (Used + Slab) | |||
MEM_CACHED | Memory utilization (memory/percent_used) TOTAL_REAL_MEM | Both | ALIGN_MEAN | DOUBLE | State | Cached | |||
MEM_BUFFERED | Memory utilization (memory/percent_used) TOTAL_REAL_MEM | Both | ALIGN_MEAN | DOUBLE | State | Buffered | |||
MEM_FREE | Memory utilization (memory/percent_used) TOTAL_REAL_MEM | Both | ALIGN_MEAN | DOUBLE | State | (Used + Slab + Cached + Buffered) | |||
MEM_REAL_UTIL | Memory utilization (memory/percent_used) | Both | ALIGN_MEAN | DOUBLE | State | (Used + Slab) | |||
MEM_USED | Memory utilization (memory/percent_used) TOTAL_REAL_MEM | Both | ALIGN_MEAN | DOUBLE | State | (Used + Slab + Cached + Buffered) | |||
MEM_UTIL | Memory utilization (memory/percent_used) | Both | ALIGN_MEAN | DOUBLE | State | (Used + Slab + Cached + Buffered) | |||
MEM_UTIL_CACHED | Memory utilization (memory/percent_used) | Both | ALIGN_MEAN | DOUBLE | State | Cached | |||
SWAP_SPACE_USED | Swap usage (swap/bytes_used) | Both | ALIGN_MEAN | DOUBLE | State | Used | REDUCE_SUM | resource.labels.instance_id | |
SWAP_SPACE_FREE | Swap usage (swap/bytes_used) | Both | ALIGN_MEAN | DOUBLE | State | Free | REDUCE_SUM | resource.labels.instance_id | |
SWAP_SPACE_TOT | Swap usage (swap/bytes_used) | Both | ALIGN_MEAN | DOUBLE | REDUCE_SUM | resource.labels.instance_id | |||
SWAP_SPACE_UTIL | Swap usage (swap/bytes_used) Swap usage (swap/bytes_used) | Both | ALIGN_MEAN ALIGN_MEAN | DOUBLE DOUBLE | State | Used | REDUCE_SUM REDUCE_SUM | resource.labels.instance_id resource.labels.instance_id | |
NET_CONNECTIONS_CURRENT | TCP connections (network/tcp_connections) | Both | ALIGN_MEAN | DOUBLE | TCP_state | Established | |||
CPU_UTIL_USER | CPU utilization (cpu/utilization) | Linux | ALIGN_MEAN | DOUBLE | CPU_state | User | |||
CPU_UTIL_SYSTEM | CPU utilization (cpu/utilization) | Linux | ALIGN_MEAN | DOUBLE | CPU_state | System | |||
CPU_UTIL_IDLE | CPU utilization (cpu/utilization) | Both | ALIGN_MEAN | DOUBLE | CPU_state | Idle | |||
CPU_UTIL_WAIT | CPU utilization (cpu/utilization) | Linux | ALIGN_MEAN | DOUBLE | CPU_state | Wait | |||
CPU_UTIL_GUEST | CPU utilization (cpu/utilization) | Windows | ALIGN_MEAN | DOUBLE | CPU_state | Used |
For more information, see theGoogle Cloud Agent metricsdocumentation.