OCI Instances are virtual machines, it is a “computers made of software” that you can use to run any software you’d run on a physical computer. Like a physical machine, a virtual machine has its own operating system (Windows, Linux, etc.), storage, networking, configuration settings, and software, and it is fully isolated from other VMs running on that host.

Use the Oracle Cloud integration to discover and collect metrics against the OCI Instances.

Setup

To set up the Oracle Cloud integration and discover the OCI Instances service, do the following:

  1. Create a Oracle Cloud (OCI) integration if not available in your installed integrations.

  2. You can select OCI Instances during integration or you can edit the existing integration and select OCI Instances.

  3. Scan to discover the resources at any time independent of the predefined schedule.

  4. Once the scan is completed, you can view the OCI Instances resource under Infrastructure > Resources > Oracle Cloud category.

  5. Create a template. See Create a Template for more information on how to create a template.

  6. Refer to Assign a Template on how to assign a template to a resource.

  7. Click the Metrics tab to view the monitoring data of OCI Instances as shown below:

Supported metrics

OpsRamp MetricOracle Cloud MetricMetric Display NameUnitDescriptionAggregation Type
oci_instance_CpuUtilizationCpuUtilizationCPU UtilizationpercentageActivity level from CPU. Expressed as a percentage of total time. For instance pools, the value is averaged across all instances in the pool.mean
oci_instance_DiskBytesReadDiskBytesReadDisk Read BytesbytesRead throughput. Expressed as bytes read per interval.rate
oci_instance_DiskBytesWrittenDiskBytesWrittenDisk Write BytesbytesWrite throughput. Expressed as bytes written per interval.rate
oci_instance_DiskIopsReadDiskIopsReadDisk Read I/OoperationsActivity level from I/O reads. Expressed as reads per interval.rate
oci_instance_DiskIopsWrittenDiskIopsWrittenDisk Write I/OoperationsActivity level from I/O writes. Expressed as written per interval.rate
oci_instance_LoadAverageLoadAverageLoad AveragecountAverage system load calculated over a 1-minute period.mean
oci_instance_MemoryAllocationStallsMemoryAllocationStallsMemory Allocation StallscountNumber of times page reclaim was called directly.mean
oci_instance_MemoryUtilizationMemoryUtilizationMemory UtilizationpercentageSpace currently in use. Measured by pages. Expressed as a percentage of used pages. For instance pools, the value is averaged across all instances in the pool.mean
oci_instance_NetworksBytesInNetworksBytesInNetwork Receive BytesbytesNetwork receipt throughput. Expressed as bytes received.rate
oci_instance_NetworksBytesOutNetworksBytesOutNetwork Transmit BytesbytesNetwork transmission throughput. Expressed as bytes transmitted.rate
oci_instance_instance_accessibility_statusInstanceAccessibilityStatusInstance accessibility statuscountThe accessibility status of a VM instance. A value of 1 indicates that the instance is unresponsive due to an issue with the infrastructure or the instance itself. A value of 0 indicates that an accessibility issue has not been detected. If the instance is stopped, then the metric does not have a value.max
oci_instance_instance_statusinstance_statusInstance StatuscountThe status of a running VM or bare metal instance. A value of 0 indicates that the instance is available (up). A value of 1 indicates that the instance is not available (down) due to an infrastructure issue. If the instance is stopped, then the metric does not have a value. This metric is available for both VM and bare metal instances.mean
oci_instance_maintenance_statusmaintenance_statusMaintenance StatuscountThe maintenance status of a VM or bare metal instance. A value of 0 indicates that the instance is not scheduled for an infrastructure maintenance event. A value of 1 indicates that the instance is scheduled for an infrastructure maintenance event. This metric is available for both VM and bare metal instances.mean