Compute Management Metrics
You can monitor requests to the instance metadata service on compute virtual machine (VM) and bare metal instances by using metrics, alarms, and notifications.
This topic describes the metrics emitted by the metric namespace
oci_compute
.
Resources: compute instances.
Overview of Metrics: oci_compute
The instance metadata service (IMDS) provides metadata about an instance, its attached VNICs, and custom metadata that you supply. IMDS is available in two versions, version 1 and version 2. IMDSv2 offers increased security compared to the legacy v1.
Use the Compute management metric to identify requests to the legacy v1 endpoints. After you migrate any applications to support the v2 endpoints, you can disable all requests to the legacy v1 endpoints.
Required IAM Policy
To monitor resources, you must be granted 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, contact the administrator to find out what type of access you were granted and which compartment you need to work in. For more information about user authorizations for monitoring, see IAM Policies.
Available Metrics: oci_compute
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 this metric.
You also can use the Monitoring service to create custom queries. See Building Metric Queries.
The metric includes the following dimensions :
- metadataVersion
- The version of the instance metadata service that requests were made to.
- path
- The URL path that instance metadata requests were made to.
- resourceId
- The OCID of the instance.
- userAgent
- The source of the instance metadata request.
- status
- The HTTP response code for requests to instance metadata service.
Metric | Metric Display Name | Unit | Description | Dimensions |
---|---|---|---|---|
InstanceMetadataRequests
|
Instance Metadata Requests V1 Versus V2 | Sum | The number of requests to the instance metadata service, comparing the version 1 and version 2 endpoints. |
|
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.
The Metrics page displays a default set of charts for the current instance.
For more information about monitoring metrics and using alarms, see Overview of Monitoring. For information about notifications for alarms, see Overview of Notifications.
- Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.
- Select a compartment.
-
For Metric namespace, select oci_compute.
The Service Metrics page dynamically updates to show charts for each metric that is emitted by the selected metric namespace.
For more information about monitoring metrics and using alarms, see Overview of Monitoring. For information about notifications for alarms, see Overview of Notifications.
Using the API
For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.
- Monitoring API for metrics and alarms
- Notifications API for notifications (used with alarms)