Database Observability with Autonomous Database Metrics
You can observe the health, capacity, and performance of your Autonomous Databases with metrics, alarms, and notifications. You can use Oracle Cloud Infrastructure console or observability APIs to view metrics.
The Autonomous Database metrics help you measure useful quantitative data, such as CPU and storage utilization, the number of successful and failed database logon and connection attempts, database operations, SQL queries, and transactions, and so on. You can use metrics data to diagnose and troubleshoot problems with your Autonomous Database resources.
- Prerequisites
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 another tool. - Using the Console
- Using the API
- Available Metrics: oci_autonomous_database
This topic describes the metrics emitted by the Database service in theoci_autonomous_databasenamespace.
Parent topic: Observability
Prerequisites
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 another tool.
Allow group <Group_Name>
to read metrics
in compartment <Compartment_Name>Allow group <Group_Name>
to inspect work-requests
in compartment <Compartment_Name>Tip:
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 common policies that give groups access to metrics, see Let users view metric definitions in a compartment and Restrict user access to a specific metric namespace.
For common policies that give groups access to Notifications, see Allow a group to manage topics, Allow a group to manage topic subscriptions, and Allow a group to publish messages to topics.
Parent topic: Database Observability with Autonomous Database Metrics
Using the Console
Parent topic: Database Observability with Autonomous Database Metrics
Using the API
-
Monitoring API for metrics and alarms.
-
Notifications API for notifications (used with alarms).
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.
Parent topic: Database Observability with Autonomous Database Metrics
Available Metrics: oci_autonomous_database
This topic describes the metrics emitted by the Database service in the oci_autonomous_database namespace.
- AUTONOMOUSDBTYPE
The type of Autonomous Database, Autonomous Data Warehouse (ADW) or Autonomous Transaction Processing (ATP).
- deploymentType
The Exadata infrastructure type, shared or dedicated. When using the Console to view default metric charts for multiple Autonomous Databases, you must specify this dimension.
- DISPLAYNAME
The friendly name of the Autonomous Database.
- REGION
The region in which the Autonomous Database resides.
- RESOURCEID
The OCID of the Autonomous Database.
- RESOURCENAME
The name of the Autonomous Database.
The metrics listed in the following table are automatically available for any Autonomous Database that you create. You do not need to enable monitoring on the resource to get these metrics.
Valid alarm intervals are 5 minutes or greater due to the frequency at which these metrics are emitted. See To create an alarm for details on creating alarms.
In the following table, metrics that are marked with an asterisk (*) can be viewed only on the Service Metrics page of the Oracle Cloud Infrastructure console. All metrics can be filtered by the dimensions described in this topic.
| Metric | Metric Display Name | Unit | Description | Collection Frequency |
|---|---|---|---|---|
ApplyLag |
Apply Lag |
seconds |
This metric displays (in seconds) how far the standby database is behind the primary database as of the time sampled. |
NA |
BlockChanges |
DB Block Changes |
changes per second |
The average number of blocks changed per second. |
NA |
CpuTime*
|
CPU Time |
seconds per second |
Average rate of accumulation of CPU time by foreground sessions in the database over the time interval. Statistic: Mean Interval: 1 minute |
NA |
CpuUtilization |
CPU Utilization |
percent |
The CPU usage expressed as a percentage, aggregated across all consumer groups. The utilization percentage is reported with respect to the number of CPUs the database is allowed to use. Statistic: Mean Interval: 1 minute |
NA |
CurrentLogons*
|
Current Logons |
count |
The number of successful logons during the selected interval. Statistic: Count Interval: 1 minute |
1 minute |
DBTime*
|
DB Time |
seconds per second |
The amount of time database user sessions spend executing database code (CPU Time + WaitTime). DB Time is used to infer database call latency, because DB Time increases in direct proportion to both database call latency (response time) and call volume. It is calculated as the average rate of accumulation of database time by foreground sessions in the database over the time interval. Statistic: Mean Interval: 1 minute |
NA |
ECPUsAllocated |
ECPU Allocated |
integer |
The actual number of ECPUs allocated by the service during the selected interval of time. |
NA |
ExecuteCount |
Execute Count |
count |
The number of user and recursive calls that executed SQL statements during the selected interval. Statistic: Sum Interval: 1 minute |
NA |
IOPS |
IOPS |
operations per second |
The average number of I/O operations per second. |
NA |
IOThroughput |
IO Throughput |
MB per second |
The average throughput in MB per second. |
NA |
LogicalBlocksRead |
Logical Reads |
reads per second |
The average number of logical block reads ("db block gets" plus "consistent gets") per second. Includes buffered and direct I/O. Statistic: Sum Interval: 1 minute |
NA |
OCPUsAllocated |
OCPU Allocated |
integer |
The actual number of OCPUs allocated by the service during the selected interval of time. |
NA |
ParsesByType |
Parses By Type |
parses per second |
The number of hard or soft parses per second. |
NA |
ParseCount*
|
Parse Count (Total) |
count |
The number of hard and soft parses during the selected interval. Statistic: Sum Interval: 1 minute |
1 minute |
QueuedStatements |
Queued Statements |
count |
The number of queued SQL statements, aggregated across all consumer groups, during the selected interval. Statistic: Sum Interval: 1 minute |
NA |
RedoSize |
Redo Generated |
MB per second |
The Average amount of redo generated in MB per second. |
NA |
RunningStatements |
Running Statements |
count |
The number of running SQL statements, aggregated across all consumer groups, during the selected interval. Statistic: Mean Interval: 1 minute |
1 minute |
Sessions |
Sessions |
count |
The number of sessions in the database. Statistic: Sum Interval: 1 minute |
1 minute |
StorageAllocated*
|
Storage Space Allocated |
GB |
Maximum amount of space allocated to the database during the interval. Statistic: Max Interval: 1 hour |
1 hour |
StorageAllocatedByTablespace*
|
Allocated Storage Space By Tablespace |
GB |
Maximum amount of space allocated for each tablespace during the interval. |
NA |
StorageUsed*
|
Maximum Storage Space |
GB |
Maximum amount of space used during the interval. Statistic: Max Interval: 1 hour |
1 hour |
StorageUsedByTablespace*
|
Storage Space Used By Tablespace |
GB |
Maximum amount of space used by each tablespace during the interval. |
NA |
StorageUtilization |
Storage Utilization |
percent |
The percentage of provisioned storage capacity currently in use. Represents the total allocated space for all tablespaces. Statistic: Mean Interval: 1 hour |
1 hour |
StorageUtilizationByTablespace*
|
Storage Space Utilization By Tablespace |
percent |
The percentage of space utilized by each tablespace. |
NA |
TransactionsByStatus |
Transactions By Status |
transactions per second |
The number of committed or rolled back transactions per second. |
NA |
TransactionCount*
|
Transaction Count |
count |
The combined number of user commits and user rollbacks during the selected interval. Statistic: Sum Interval: 1 minute |
1 minute |
TransportLag |
Transport Lag |
seconds |
The approximate number of seconds of redo not yet available on the standby database as of the time sampled. |
1 minute |
UserCalls*
|
User Calls |
count |
The combined number of logons, parses, and execute calls during the selected interval. Statistic: Sum Interval: 1 minute |
1 minute |
WaitTime*
|
Wait Time |
seconds per second |
Average rate of accumulation of non-idle wait time by foreground sessions in the database over the time interval. Statistic: Mean Interval: 1 minute |
1 minute |
Parent topic: Database Observability with Autonomous Database Metrics