Compute Instance Health Metrics
This topic describes the metrics emitted by the metric namespace
Resources: Compute VM instances.
Overview of Metrics: oci_compute_instance_health
The following compute instance health metric helps you monitor the status, health, and accessibility of compute instances.
Instance accessibility status: The
instance_accessibility_status metric lets you monitor whether a VM instance is unresponsive. Compute sends an Address Resolution Protocol (ARP) request to the instance's virtual network interface card (VNIC). If the ARP ping fails, the metric shows that the instance is unresponsive.
To troubleshoot an unresponsive VM instance:
- Check the infrastructure health metrics to determine whether there is an ongoing infrastructure issue. If there is an ongoing infrastructure issue, then wait until Oracle Cloud Infrastructure resolves the issue, and then check the
- If there isn't an ongoing infrastructure issue, then the instance probably has a software issue or a network misconfiguration that you must resolve yourself. Confirm that the OS and network are configured correctly. See the Compute troubleshooting suggestions and Networking troubleshooting suggestions.
- If the Compute and Networking troubleshooting steps aren't successful, then you can use a diagnostic reboot to rebuild an unreachable instance.
Required IAM Policy
To monitor resources, you must have the required type of access in a policy written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you have and which compartment you should work in. For more information about user authorizations for monitoring, see IAM Policies (Monitoring).
Available Metrics: oci_compute_instance_health
The metric listed in the following table is automatically available for your instances. You do not need to enable monitoring on the instance to get these metrics.
You also can use the Monitoring service to create custom queries.
The metric includes the following dimensions :
- The friendly name of the instance.
- The OCID of the instance.
|Metric||Metric Display Name||Unit||Description||Dimensions|
||Instance accessibility status||Count||The 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.||
Using the Console
- Open the navigation menu and click Compute. Under Compute, click Instances.
- Click the instance that you're interested in.
- Under Resources, click Metrics.
In the Metric namespace list, select oci_compute_instance_health.
The Metrics page displays a default set of charts for the current instance.
- Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.
- Select a compartment.
For Metric namespace, select oci_compute_instance_health.
The Service Metrics page dynamically updates to show charts for each metric that is emitted by the selected metric namespace.