Instance Pool Metrics
You can monitor the health, capacity, and performance of your Compute instance pools by using metrics, alarms, and notifications.
This topic describes the metrics emitted by the metric namespace oci_instancepools
.
Resources: Compute instance pools.
Overview of Metrics: oci_instancepools
The instance pool metrics help you monitor the lifecycle state of instances in your instance pools.
Required IAM Policy
To monitor resources, you must be given 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've been granted and which compartment you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.
Available Metrics: oci_instancepools
The metrics listed in the following table are automatically available for each instance pool that you create. You do not need to enable monitoring on the instances in the pool to get these metrics.
You also can use the Monitoring service to create custom queries.
Depending on the metric, the following dimensions are available:
- AvailabilityDomain
- The availability domain where the instance pool resides.
- DisplayName
- The friendly name of the instance pool.
- FaultDomain
- The fault domain where the instance pool resides.
- region
- The region where the instance pool resides.
- resourceId
- The OCID of the instance pool.
Metric | Metric Display Name | Unit | Description | Dimensions |
---|---|---|---|---|
InstancePoolSize
|
Instance Pool Size | instances | Number of instances in the pool. |
|
ProvisioningInstances
|
Instances Provisioning | instances | Number of instances in the pool that are provisioning. |
|
RunningInstances
|
Instances Running | instances | Number of running instances in the pool. |
|
TerminatedInstances
|
Instances Terminated | instances | Number of instances in the pool that are terminating or terminated. |
|
Using the Console
- Open the navigation menu. Under Core Infrastructure, go to Compute and click Instance Pools.
- Click the instance pool that you're interested in.
- Under Resources, click Metrics.
-
In the Metric Namespace list, select oci_instancepools.
The Metrics page displays a default set of charts for the current instance pool.
For more information about monitoring metrics and using alarms, see Monitoring Overview. For information about notifications for alarms, see Notifications Overview.
- Open the navigation menu. Under Solutions and Platform, go to Monitoring and click Service Metrics.
- Select a compartment.
-
For Metric Namespace, select
oci_instancepools
.The Service Metrics page dynamically updates the page to show charts for each metric that is emitted by the selected metric namespace.
For more information about monitoring metrics and using alarms, see Monitoring Overview. For information about notifications for alarms, see Notifications Overview.
Using the API
For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.
Use the following APIs for monitoring:
- Monitoring API for metrics and alarms
- Notifications API for notifications (used with alarms)