steampipe plugin install ocisteampipe plugin install oci

Table: oci_core_instance_metric_cpu_utilization - Query OCI Core Instance Metrics using SQL

OCI Core Instance Metrics are a part of Oracle Cloud Infrastructure's Monitoring service. These metrics provide real-time data about the performance of your instances. CPU Utilization Metrics specifically provide data about the percentage of total CPU resources that an instance uses.

Table Usage Guide

The oci_core_instance_metric_cpu_utilization table provides insights into CPU Utilization Metrics for OCI Core Instances. As a system administrator or DevOps engineer, you can use this table to monitor and manage the performance of your instances. This table can be particularly useful for identifying instances that are under heavy load or are not utilizing their CPU resources efficiently.

Examples

Basic info

Explore the performance of your virtual machines by analyzing their CPU utilization metrics. This allows you to assess the efficiency of your resources and make informed decisions about scaling or resource allocation.

select
  id,
  timestamp,
  minimum,
  maximum,
  average,
  sample_count
from
  oci_core_instance_metric_cpu_utilization
order by
  id,
  timestamp;

select
  id,
  timestamp,
  minimum,
  maximum,
  average,
  sample_count
from
  oci_core_instance_metric_cpu_utilization
order by
  id,
  timestamp;

CPU Over 80% average

Determine the instances where the CPU utilization exceeds 80% on average. This is useful for identifying potential performance issues and ensuring optimal resource management.

select
  id,
  timestamp,
  round(minimum :: numeric, 2) as min_cpu,
  round(maximum :: numeric, 2) as max_cpu,
  round(average :: numeric, 2) as avg_cpu,
  sample_count
from
  oci_core_instance_metric_cpu_utilization
where
  average > 80
order by
  id,
  timestamp;

select
  id,
  timestamp,
  round(minimum, 2) as min_cpu,
  round(maximum, 2) as max_cpu,
  round(average, 2) as avg_cpu,
  sample_count
from
  oci_core_instance_metric_cpu_utilization
where
  average > 80
order by
  id,
  timestamp;

Schema for oci_core_instance_metric_cpu_utilization

Name	Type	Description
_ctx	jsonb	Steampipe context in JSON form, e.g. connection_name.
average	double precision	The average of the metric values that correspond to the data point.
compartment_id	text	The ID of the compartment.
id	text	The OCID of the instance.
maximum	double precision	The maximum metric value for the data point.
metric_name	text	The name of the metric.
minimum	double precision	The minimum metric value for the data point.
namespace	text	The metric namespace.
region	text	The OCI region in which the resource is located.
sample_count	double precision	The number of metric values that contributed to the aggregate value of this data point.
sum	double precision	The sum of the metric values for the data point.
tenant_id	text	The OCID of the Tenant in which the resource is located.
tenant_name	text	The name of the Tenant in which the resource is located.
timestamp	timestamp with time zone	The time stamp used for the data point.
unit	text	The standard unit for the data point.

Export

This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.

You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh script:

/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- oci

You can pass the configuration to the command with the --config argument:

steampipe_export_oci --config '<your_config>' oci_core_instance_metric_cpu_utilization