Container Instance Metrics
You can monitor the health, capacity, and performance of your Oracle Cloud Infrastructure container instances by using metrics.
This topic describes the metrics emitted by the metric namespace oci_computecontainerinstance.
Available Metrics: oci_computecontainerinstance
The metrics listed in the following tables are automatically available for each container and container instance that you create. You do not need to enable monitoring on the container instances to get these metrics.
You also can use the Monitoring service to create custom queries.
Container Instance Metrics
The following dimensions are available:
- availabilityDomain
- The availability domain where the container instance resides.
- faultDomain
-
The fault domain where the instance resides.
- resourceDisplayName
- The friendly name of the container instance.
- resourceId
- The OCID of the container instance.
| Metric | Metric Display Name | Unit | Description | Dimensions |
|---|---|---|---|---|
CpuUtilization |
CPU Utilization | percent | The percent of the container instance's CPU resources that are in use. |
|
MemoryUtilization |
Memory Utilization | percent | The percent of the container instance's memory resources that are in use. |
|
CpuUsed |
CPU Used | core nanoseconds | The cumulative use of the container instance's CPU resources since it was created. |
|
MemoryUsed |
Memory Used | bytes | The amount of the container instance's memory resources that are in use. |
|
EphemeralStorageUsed |
Ephemeral Storage Used | bytes | The amount of the container instance's ephemeral storage that is in use. |
|
Container Metrics
Container metrics are metrics at the container-level and available for new container instances. You must restart existing container instances to enable container metrics.
The following dimensions are available:
- availabilityDomain
- The availability domain where the container instance resides.
- containerDisplayName
- The friendly name of the container.
- containerOCID
- The OCID of the container.
- faultDomain
-
The fault domain where the instance resides.
- resourceDisplayName
- The friendly name of the container instance.
- resourceId
- The OCID of the container instance.
| Metric | Metric Display Name | Unit | Description | Dimensions |
|---|---|---|---|---|
ContainerCpuUsed |
Container CPU Used | core nanoseconds | The cumulative use of the container's CPU resources across all of the container instance's cores resources, since the container was created. |
|
ContainerEphemeralStorageUsed |
Container Ephemeral Storage Used | bytes | The amount of the container instance's ephemeral storage used by the container's writable layers. |
|
ContainerMemoryUsed |
Container Memory Used | bytes | The total amount of memory in use by a container. This includes all memory, regardless of when it was accessed. |
|
Viewing Default Metric Charts
To view default metric charts for a single container instance:
- In the Console, open the navigation menu and click Developer Services. Under Containers & Artifacts, click Container Instances.
- Click the container instance that you're interested in.
- Under Resources, click Metrics.
The Metrics page displays a default set of charts for the current container instance.
To view default metric charts for all container instances in a compartment:
- Open the navigation menu and click Observability & Management. Under Monitoring, click Service Metrics.
- Select a compartment.
-
For Metric namespace, select
oci_computecontainerinstance.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. For information about notifications for alarms, see 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 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)