function::qsq_utilization - Linux


The function::qsq_utilization command is primarily used to monitor the utilization of resources such as CPU, memory, and network. It’s particularly useful for analyzing the performance metrics of cloud-based resources and optimizing their allocation to maximize efficiency.


function::qsq_utilization --metrics [metric_list] --resource [resource_type]
                             --duration [duration_window] --interval [interval_window]
                             --start-time [start_time] --end-time [end_time]
                             --filter [filter_expression] --summarization [aggregation_type]
                             --sort [sort_expression] --project [project_id] --region [region]
                             --zone [zone] --instance [instance_id] --group [group_id]


  • –metrics: Specifies the performance metrics to collect, such as cpu.utilization, memory.utilization.
  • –resource: Defines the type of resource to monitor, such as instance, disk.
  • –duration: Sets the time range for the utilization data (e.g. 5m, 1h).
  • –interval: Specifies the interval at which data points are collected (e.g. 1m, 10s).
  • –start-time: Sets the start time for data collection.
  • –end-time: Sets the end time for data collection.
  • –filter: Allows filtering of data based on resource properties (e.g. resource.type = "instance").
  • –summarization: Aggregates data points based on the specified type (e.g. AVG, MAX).
  • –sort: Sorts the results based on the specified expression (e.g. metric.utilization).
  • –project: Specifies the Google Cloud project ID.
  • –region: Specifies the geographical region where the resources are located.
  • –zone: Specifies the availability zone where the resources are located.
  • –instance: Limits the results to a specific instance.
  • –group: Limits the results to a specific resource group.
  • –help: Displays usage instructions.


Example 1: Monitoring CPU Utilization

function::qsq_utilization --metrics cpu.utilization --resource instance

Example 2: Filtering by Instance Name

function::qsq_utilization --metrics cpu.utilization --resource instance
                           --filter " = 'my-instance'"

Example 3: Sorting by Maximum Utilization

function::qsq_utilization --metrics cpu.utilization --resource instance
                           --summarization MAX --sort "metric.utilization:desc"

Common Issues

Error: Insufficient permissions.
Solution: Ensure you have the necessary permissions to access the Cloud Monitoring API and the resources you’re trying to monitor.

Error: No data points available.
Solution: Check that the specified time range and resource type are correct. Also, verify that the resources are configured to collect the desired metrics.

Error: Invalid filter expression.
Solution: Ensure that the filter expression is syntactically correct and uses the correct field names.


  • Integrate the command into monitoring scripts or dashboards to continuously monitor resource utilization.
  • Use the command output to identify inefficient resource allocation and optimize cloud infrastructure usage.
  • Combine with other commands, such as gcloud compute instances list to correlate utilization data with instance properties.

Related Commands