openapi: 3.2.0 info: description: '
Provides the Oracle REST Data Services (ORDS) users the ability to perform Oracle Database management and monitoring operations through a user-friendly REST API. Depending on the database version and configuration, ORDS database APIs provide services such as manage pluggable databases, export data, and review database performance.
To install and configure Oracle REST Data Services refer to the Oracle® REST Data Services Installation and Configuration Guide.
An OpenAPI V3 document that describes the available ORDS database API services can be retrieved from a running ORDS instance. The API document can be imported into compatible development tools and invoked from there. The URL to retrieve the API document depends on the your configuration.
The pattern for the API document URL is:
https://<server>/<context root>/<my database>/<my schema>/_/db-api/stable/<service path>
Where, the <my database> and <my schema> variables can be optional, depending on the ORDS configuration and the service invoked.'
version: 2026.03.26
title: Oracle REST Data Services Monitoring API
contact:
name: Oracle REST Data Services
url: https://www.oracle.com/database/technologies/appdev/rest.html
x-summary: Provides the Oracle REST Data Services (ORDS) users the ability to perform Oracle Database management and monitoring operations through a user-friendly REST API.
tags:
- name: Monitoring
description: Services related to monitoring the Oracle database instance.
paths:
/database/monitoring/alerts/:
get:
tags:
- Monitoring
summary: Get all alerts
description: Returns records from V$DIAG_ALERT_EXT. In an Oracle RAC environment, data returned by this service may vary according to the instance to which a session is connected. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Returns database alerts.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringAlerts'
x-internal-id: database-monitoring-alerts--get
x-filename-id: database-monitoring-alerts-get
/database/monitoring/alerts/{record_id}:
get:
tags:
- Monitoring
summary: Get an alert record
description: Returns specific alert record from V$DIAG_ALERT_EXT. In an Oracle RAC environment, data returned by this service may vary according to the instance to which a session is connected. A client requires SQL Administrator role to invoke this service.
parameters:
- name: record_id
in: path
description: Identifier for the alert record.
required: true
schema:
type: number
responses:
'200':
description: Information on a specific alert.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringAlertsItem'
x-internal-id: database-monitoring-alerts-{record_id}-get
x-filename-id: database-monitoring-alerts-record_id-get
/database/monitoring/alerts_recent_summaries/by_message_level:
get:
tags:
- Monitoring
summary: Get count of recent alerts by message level
description: Group by message level on V$DIAG_ALERT_EXT originating within the last 7 days. In an Oracle RAC environment, data returned by this service may vary according to the instance to which a session is connected. A client requires SQL Administrator role to invoke this service.
responses:
'200':
description: Summary of alerts from the last 7 days, aggregated by message level.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringAlertsSummaryMessageLevelItem'
x-internal-id: database-monitoring-alerts_recent_summaries-by_message_level-get
x-filename-id: database-monitoring-alerts_recent_summaries-by_message_level-get
/database/monitoring/alerts_recent_summaries/by_message_type:
get:
tags:
- Monitoring
summary: Get count of recent alerts by message type
description: Group by message type on V$DIAG_ALERT_EXT originating within the last 7 days. In an Oracle RAC environment, data returned by this service may vary according to the instance to which a session is connected. A client requires SQL Administrator role to invoke this service.
responses:
'200':
description: Summary of alerts from the last 7 days, aggregated by message type.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringAlertsSummaryMessageTypeItem'
x-internal-id: database-monitoring-alerts_recent_summaries-by_message_type-get
x-filename-id: database-monitoring-alerts_recent_summaries-by_message_type-get
/database/monitoring/alerts_summaries/by_message_level:
get:
tags:
- Monitoring
summary: Get count of alerts by message level
description: Group by message level on V$DIAG_ALERT_EXT. In an Oracle RAC environment, data returned by this service may vary according to the instance to which a session is connected. A client requires SQL Administrator role to invoke this service.
responses:
'200':
description: Summary of alerts, broken down by message level.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringAlertsSummaryMessageLevelItem'
x-internal-id: database-monitoring-alerts_summaries-by_message_level-get
x-filename-id: database-monitoring-alerts_summaries-by_message_level-get
/database/monitoring/alerts_summaries/by_message_type:
get:
tags:
- Monitoring
summary: Get count of alerts by message type
description: Group by message type on V$DIAG_ALERT_EXT. In an Oracle RAC environment, data returned by this service may vary according to the instance to which a session is connected. A client requires SQL Administrator role to invoke this service.
parameters: []
responses:
'200':
description: Summary of alerts broken down by message type.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringAlertsSummaryMessageTypeItem'
x-internal-id: database-monitoring-alerts_summaries-by_message_type-get
x-filename-id: database-monitoring-alerts_summaries-by_message_type-get
/database/monitoring/session_limits:
get:
tags:
- Monitoring
summary: Get all session limits
description: Get all resource limits for sessions using GV$RESOURCE_LIMIT view. Since GV$RESOURCE_LIMIT exposes global level information, it can only be queried from CDB$ROOT or in a non-CDB database. A client requires SQL Administrator role to invoke this service.
parameters: []
responses:
'200':
description: All session limits in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLimitsItem'
x-internal-id: database-monitoring-session_limits-get
x-filename-id: database-monitoring-session_limits-get
/database/monitoring/session_locks/:
get:
tags:
- Monitoring
summary: Get all locks held in the database
description: Get all locks that are held in the database using DBA_LOCK view. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: All locks held in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLocks'
x-internal-id: database-monitoring-session_locks--get
x-filename-id: database-monitoring-session_locks-get
/database/monitoring/session_locks/{session_id},{lock_id1},{lock_id2}:
get:
tags:
- Monitoring
summary: Get a specific session lock record
description: Returns the corresponding record from DBA_LOCK view. A client requires SQL Administrator role to invoke this service.
parameters:
- name: session_id
in: path
description: Session holding or acquiring the lock.
required: true
schema:
type: number
- name: lock_id1
in: path
description: Type-specific lock identifier, part 1.
required: true
schema:
type: string
- name: lock_id2
in: path
description: Type-specific lock identifier, part 2.
required: true
schema:
type: string
responses:
'200':
description: Information on a specific lock.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLocksItem'
x-internal-id: database-monitoring-session_locks-{session_id},{lock_id1},{lock_id2}-get
x-filename-id: database-monitoring-session_locks-session_id-lock_id1-lock_id2-get
/database/monitoring/session_locks/holding/:
get:
tags:
- Monitoring
summary: Get all locks that are blocking other sessions
description: Using DBA_LOCKS and DBA_BLOCKERS views, this service returns a list of DBA_LOCKS records where the session is not waiting for a locked object but is holding a lock on an object for which another session is waiting. In an Oracle RAC environment, this only applies if the blocker is on the same instance. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: All locks that are blocking other sessions.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLocksHolding'
x-internal-id: database-monitoring-session_locks-holding--get
x-filename-id: database-monitoring-session_locks-holding-get
/database/monitoring/session_locks/holding/{session_id},{lock_id1},{lock_id2}:
get:
tags:
- Monitoring
summary: Get a session lock that is blocking other sessions
description: Using DBA_LOCKS and DBA_BLOCKERS views, this service returns a specific DBA_LOCKS record where the session is not waiting for a locked object but is holding a lock on an object for which another session is waiting. In an Oracle RAC environment, this only applies if the blocker is on the same instance. A client requires SQL Administrator role to invoke this service.
parameters:
- name: session_id
in: path
description: Session identifier.
required: true
schema:
type: number
- name: lock_id1
in: path
description: Type-specific lock identifier, part 1.
required: true
schema:
type: string
- name: lock_id2
in: path
description: Type-specific lock identifier, part 2.
required: true
schema:
type: string
responses:
'200':
description: Information on a specific session lock.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLocksItem'
x-internal-id: database-monitoring-session_locks-holding-{session_id},{lock_id1},{lock_id2}-get
x-filename-id: database-monitoring-session_locks-holding-session_id-lock_id1-lock_id2-get
/database/monitoring/session_locks/waiting/:
get:
tags:
- Monitoring
summary: Get all locks that sessions are waiting on
description: Using DBA_LOCKS and DBA_WAITERS views, this service returns a list of DBA_LOCKS records for sessions that are waiting on locks held by other sessions. In an Oracle RAC environment, this only applies if the waiter is on the same instance. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: All locks in the database that sessions are waiting on.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLocksWaiting'
x-internal-id: database-monitoring-session_locks-waiting--get
x-filename-id: database-monitoring-session_locks-waiting-get
/database/monitoring/session_locks/waiting/{session_id},{lock_id1},{lock_id2}:
get:
tags:
- Monitoring
summary: Get a specific lock that a session is waiting on
description: Using DBA_LOCKS and DBA_WAITERS views, this service returns the corresponding DBA_LOCKS records for session that is waiting on locks held by other sessions. In an Oracle RAC environment, this only applies if the waiter is on the same instance. A client requires SQL Administrator role to invoke this service.
parameters:
- name: session_id
in: path
description: Session identifier.
required: true
schema:
type: number
- name: lock_id1
in: path
description: Type-specific lock identifier, part 1.
required: true
schema:
type: string
- name: lock_id2
in: path
description: Type-specific lock identifier, part 2.
required: true
schema:
type: string
responses:
'200':
description: Information on a specific lock that a session is waiting on.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionLocksItem'
x-internal-id: database-monitoring-session_locks-waiting-{session_id},{lock_id1},{lock_id2}-get
x-filename-id: database-monitoring-session_locks-waiting-session_id-lock_id1-lock_id2-get
/database/monitoring/session_summaries/by_type:
get:
tags:
- Monitoring
summary: Get count of different session types
description: Group by session type on GV$SESSION. A client requires SQL Administrator role to invoke this service.
responses:
'200':
description: Summary of different session types in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionTypeSummariesItem'
x-internal-id: database-monitoring-session_summaries-by_type-get
x-filename-id: database-monitoring-session_summaries-by_type-get
/database/monitoring/session_wait_classes/:
get:
tags:
- Monitoring
summary: Get all session wait class records
description: Returns all records from GV$SESSION_WAIT_CLASS. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: Summary of session wait classes in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionWaitClasses'
x-internal-id: database-monitoring-session_wait_classes--get
x-filename-id: database-monitoring-session_wait_classes-get
/database/monitoring/session_wait_classes/{sid},{serial_number},{wait_class_number}:
get:
tags:
- Monitoring
summary: Get a specific session wait class record
description: Returns the corresponding record from GV$SESSION_WAIT_CLASS. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session identifier.
required: true
schema:
type: number
- name: serial_number
in: path
description: Session serial number.
required: true
schema:
type: number
- name: wait_class_number
in: path
description: Number of the wait class.
required: true
schema:
type: number
responses:
'200':
description: Information on the specified session wait class.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionWaitClassesItem'
x-internal-id: database-monitoring-session_wait_classes-{sid},{serial_number},{wait_class_number}-get
x-filename-id: database-monitoring-session_wait_classes-sid-serial_number-wait_class_number-get
/database/monitoring/session_waits/:
get:
tags:
- Monitoring
summary: Get all session waits
description: Returns all records from GV$SESSION_WAIT.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: All session wait records from GV$SESSION_WAIT. A client requires SQL Administrator role to invoke this service.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionWaits'
x-internal-id: database-monitoring-session_waits--get
x-filename-id: database-monitoring-session_waits-get
/database/monitoring/session_waits/{sid},{seq_number}:
get:
tags:
- Monitoring
summary: Get a specific session wait
description: Returns the corresponding record from GV$SESSION_WAIT. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session identifier.
required: true
schema:
type: number
- name: seq_number
in: path
description: Wait sequence number.
required: true
schema:
type: number
responses:
'200':
description: Information on the specified session wait.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionWaitsItem'
x-internal-id: database-monitoring-session_waits-{sid},{seq_number}-get
x-filename-id: database-monitoring-session_waits-sid-seq_number-get
/database/monitoring/sessions/:
get:
tags:
- Monitoring
summary: Get all current sessions
description: Returns all records on GV$SESSION. A client requires SQL Administrator role to invoke this service.
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Filter'
responses:
'200':
description: All current sessions in the database.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessions'
x-internal-id: database-monitoring-sessions--get
x-filename-id: database-monitoring-sessions-get
/database/monitoring/sessions/{sid},{serial_number}/:
get:
tags:
- Monitoring
summary: Get a session
description: Returns the GV$SESSION for the specified Session Identifier and Session Serial Number. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session identifier.
required: true
schema:
type: number
- name: serial_number
in: path
description: Session serial number.
required: true
schema:
type: number
responses:
'200':
description: Information on the specified session.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionsItem'
x-internal-id: database-monitoring-sessions-{sid},{serial_number}--get
x-filename-id: database-monitoring-sessions-sid-serial_number-get
/database/monitoring/sessions/{sid},{serial_number}/long_running_operations:
get:
tags:
- Monitoring
summary: Get all long running operations for a session
description: Returns all records from GV$SESSION_LONGOPS for a specific session. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session identifier.
required: true
schema:
type: number
- name: serial_number
in: path
description: Session serial number.
required: true
schema:
type: number
responses:
'200':
description: Information on long running operations for the session.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionsLongRunningOperationItem'
x-internal-id: database-monitoring-sessions-{sid},{serial_number}-long_running_operations-get
x-filename-id: database-monitoring-sessions-sid-serial_number-long_running_operations-get
/database/monitoring/sessions/{sid},{serial_number}/process:
get:
tags:
- Monitoring
summary: Get current active process for a session
description: Returns all records from GV$PROCESS for a specific session. A client requires SQL Administrator role to invoke this service.
parameters:
- name: sid
in: path
description: Session identifier.
required: true
schema:
type: number
- name: serial_number
in: path
description: Session serial number.
required: true
schema:
type: number
responses:
'200':
description: Description of actives processes for a session.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringSessionsProcessItem'
x-internal-id: database-monitoring-sessions-{sid},{serial_number}-process-get
x-filename-id: database-monitoring-sessions-sid-serial_number-process-get
/database/monitoring/wait_class_totals:
get:
tags:
- Monitoring
summary: Get time totals for all registered wait classes
description: Returns all the records from GV$SYSTEM_WAIT_CLASS, except 'Idle' wait class. A client requires SQL Administrator role to invoke this service.
parameters: []
responses:
'200':
description: Summary information on the wait class time totals.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringWaitClassTotalsItem'
x-internal-id: database-monitoring-wait_class_totals-get
x-filename-id: database-monitoring-wait_class_totals-get
/database/monitoring/waits_recent:
get:
tags:
- Monitoring
summary: Get wait time summary from recent active session history records
description: Oracle Diagnostics Pack licence is required for this service. Group by sample_time and wait_class on GV$ACTIVE_SESSION_HISTORY for records with sample_time within the last 7 days. Note that time waited is in microseconds. A client requires SQL Administrator role to invoke this service.
parameters: []
responses:
'200':
description: Wait time summary from active session history records within the last 7 days.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringWaitsRecentItem'
x-internal-id: database-monitoring-waits_recent-get
x-filename-id: database-monitoring-waits_recent-get
/database/monitoring/wait_class_metrics:
get:
tags:
- Monitoring
summary: Get all wait class metrics
description: Returns all records from GV$WAITCLASSMETRIC for all GV$SYSTEM_WAIT_CLASS records except 'Idle' wait class. A client requires SQL Administrator role to invoke this service.
parameters: []
responses:
'200':
description: Wait class metrics records.
content:
application/json:
schema:
$ref: '#/components/schemas/MonitoringWaitClassMetricsItem'
x-internal-id: database-monitoring-wait_class_metrics-get
x-filename-id: database-monitoring-wait_class_metrics-get
components:
schemas:
MonitoringAlerts:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringAlertsItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionLocksItem:
type: object
description: This object is represents a record on DBA_LOCK view. DBA_LOCK lists all locks or latches held in the database, and all outstanding requests for a lock or latch. The list of attributes may vary depending on database version.
properties:
session_id:
type: integer
description: Session holding or acquiring the lock.
lock_type:
type: string
description: Lock type.
mode_held:
type: string
description: Lock mode.
mode_requested:
type: string
description: Lock mode requested.
lock_id1:
type: string
description: Type-specific lock identifier, part 1.
lock_id2:
type: string
description: Type-specific lock identifier, part 2.
last_convert:
type: integer
description: The last convert.
blocking_others:
type: string
description: Whether the lock is currently blocking others.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringWaitsRecentItem:
type: object
description: A summary of time waited for each wait class in GV$ACTIVE_SESSION_HISTORY.
properties:
items:
type: array
items:
type: object
properties:
sample_time:
type: string
description: Time at which the sample was taken.
wait_class:
type: string
description: Wait class name of the event for which the session was waiting at the time of sampling.
time_waited:
type: integer
description: Amount of time (in microseconds) spent in waits from this wait class at the time of sampling.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionWaitClassesItem:
type: object
description: This object represents a record from GV$SESSION_WAIT_CLASS view. GV$SESSION_WAIT_CLASS displays the time spent in various wait event operations on a per-session basis. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
sid:
type: integer
description: Session identifier.
serial#:
type: integer
description: Serial number.
wait_class_id:
type: integer
description: Identifier of the wait class.
wait_class#:
type: integer
description: Number of the wait class.
wait_class:
type: string
description: Name of the wait class.
total_waits:
type: integer
description: Number of times waits of the class occurred for the session.
time_waited:
type: integer
description: Amount of time spent in the wait class by the session.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringWaitClassTotalsItem:
type: object
description: Time totals for each registered wait class
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
wait_class_id:
type: integer
description: Identifier of the wait class.
wait_class#:
type: integer
description: Number of the wait class.
wait_class:
type: string
description: Name of the wait class.
total_waits:
type: integer
description: Number of times waits of the class occurred.
time_waited:
type: integer
description: Amount of time (in hundredths of a second) spent in the wait by all sessions in the instance.
total_waits_fg:
type: integer
description: Number of times waits from this wait class occurred in foreground sessions.
time_waited_fg:
type: integer
description: Amount of time (in hundredths of a second) spent in waits from this wait class in foreground sessions.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionLocksHolding:
type: object
description: This collection represents database locks held by sessions that are blocking other sessions. The list of attributes may vary depending on database version.
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringSessionLocksItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionLocks:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringSessionLocksItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringAlertsSummaryMessageLevelItem:
type: object
description: This object represents a summary of V$DIAG_ALERT_EXT records by message level. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
con_id:
type: integer
description: The ID of the container to which the data pertains.
message_level:
type: integer
description: Level the message belongs to. Lower level values imply higher severity for errors.
message_level_name:
type: string
description: A text description of the corresponding message level value.
number_of_messages:
type: integer
description: The count of records that have this message level.
latest_messages:
type: string
description: The text of the last 5 messages at this message level.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
LinkRelation:
type: object
properties:
rel:
type: string
href:
type: string
required:
- rel
- href
MonitoringSessionWaits:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringSessionWaitsItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringAlertsSummaryMessageTypeItem:
type: object
description: This object represents a summary of V$DIAG_ALERT_EXT records by message type. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
con_id:
type: integer
description: The ID of the container to which the data pertains.
message_type:
type: integer
description: Type of the message, indicating that a different type of response is required.
message_type_name:
type: string
description: A text description of the corresponding message type value.
number_of_messages:
type: integer
description: The count of records that have this message type.
latest_messages:
type: string
description: The text of the last 5 messages at this message type.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionWaitClasses:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringSessionWaitClassesItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionsLongRunningOperationItem:
type: object
description: This object represents operations for a specific session that run for longer than 6 seconds (in absolute time).
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
sid:
type: integer
description: Identifier of the session processing the long-running operation. If multiple sessions are cooperating in the long-running operation, then SID corresponds to the main or master session.
serial#:
type: integer
description: Serial number of the session processing the long-running operation. If multiple sessions are cooperating in the long-running operation, then SERIAL# corresponds to the main or master session. SERIAL# is used to uniquely identify a session's objects. Guarantees that session-level commands are applied to the correct session objects if the session ends and another session begins with the same session ID.
opname:
type: string
description: Brief description of the operation.
target:
type: string
description: Object on which the operation is carried out.
target_desc:
type: string
description: Description of the target.
sofar:
type: integer
description: Units of work done so far for the operation specified in the OPNAME column.
totalwork:
type: integer
description: Total units of work for the operation specified in the OPNAME column.
units:
type: string
description: Units of measurement.
start_time:
type: string
description: Starting time of the operation.
last_update_time:
type: string
description: Time when statistics were last updated for the operation.
timestamp:
type: string
description: Timestamp specific to the operation.
time_remaining:
type: integer
description: Estimate (in seconds) of time remaining for the operation to complete.
elapsed_seconds:
type: integer
description: Number of elapsed seconds from the start of the operations.
context:
type: integer
description: Context.
message:
type: string
description: Statistics summary message.
username:
type: string
description: User ID of the user performing the operation.
sql_address:
type: string
description: Used with sql_hash_value to identify the SQL statement that is currently being executed.
sql_hash_value:
type: integer
description: Used with SQL_ADDRESS to identify the SQL statement that is currently being executed.
sql_id:
type: string
description: SQL identifier of the SQL statement that is currently being executed.
sql_plan_hash_value:
type: integer
description: Used with the value of the SQL_ADDRESS column to identify the SQL statement associated with the operation.
sql_exec_start:
type: string
description: Time when the execution of the SQL currently executed by this session started; NULL if SQL_ID is NULL.
sql_exec_id:
type: integer
description: SQL execution identifier; NULL if SQL_ID is NULL or if the execution of that SQL has not yet started.
sql_plan_line_id:
type: integer
description: SQL plan line ID corresponding to the long operation; NULL if the long operation is not associated with a line of the execution plan.
sql_plan_operation:
type: string
description: Plan operation name; NULL if SQL_PLAN_LINE_ID is NULL.
sql_plan_options:
type: string
description: Plan operation options; NULL if SQL_PLAN_LINE_ID is NULL.
qcsid:
type: integer
description: Session identifier of the parallel coordinator.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
Filter:
type: object
description: See Oracle REST Data Services production documentation 'Filtering in Queries' section.
externalDocs:
url: https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/
anyOf:
- type: object
description: Any key / value pair for specifying a Filter Criteria.
- type: object
properties:
$orderby:
description: Specify which properties to order the result set by.
type: object
$asof:
description: Specify a time related query parameter to limit the results. Parameter value can be a System Change Number or a Date.
type: object
MonitoringSessionsProcessItem:
type: object
description: This object represents information about the currently active processes for a specific session. Data is retrieved from GV$PROCESS view.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
addr:
type: string
description: Address of the process state object.
pid:
type: integer
description: Oracle process identifier.
sosid:
type: string
description: Operating system (process, thread) identifier.
spid:
type: string
description: Operating system process identifier.
stid:
type: string
description: Operating system thread identifier.
execution_type:
type: string
description: Operating system execution type.
pname:
type: string
description: Name of this process.
username:
type: string
description: Operating system process username.
serial#:
type: integer
description: Process serial number.
terminal:
type: string
description: Operating system terminal identifier.
program:
type: string
description: Program in progress.
traceid:
type: string
description: Trace file identifier.
tracefile:
type: string
description: Trace file name of the process.
background:
type: string
description: 1 for a SYSTEM background process; NULL for foreground processes or non-SYSTEM background processes.
latchwait:
type: string
description: Address of the latch the process is waiting for; NULL if none.
latchspin:
type: string
description: This column is obsolete.
pga_used_mem:
type: integer
description: PGA memory currently used by the process (in bytes).
pga_alloc_mem:
type: integer
description: PGA memory currently allocated by the process (including free PGA memory not yet released to the operating system by the server process), in bytes.
pga_freeable_mem:
type: integer
description: Allocated PGA memory which can be freed (in bytes).
pga_max_mem:
type: integer
description: Maximum PGA memory ever allocated by the process (in bytes).
numa_default:
type: integer
description: The NUMA processor group of this process at initialization time.
numa_curr:
type: integer
description: The NUMA processor group of this process currently.
cpu_used:
type: integer
description: Tracks the CPU used by this process (in microseconds) from the time it was spawned.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionLimitsItem:
type: object
description: This object is used to monitor the consumption of session resources in the database. Since GV$RESOURCE_LIMIT exposes global/ CDB level information, it can only be queried from CDB$ROOT or in a non-CDB database. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
resource_name:
type: string
description: Name of the resource. This will always be session in this case.
current_utilization:
type: integer
description: Number of (resources, locks, or processes) currently being used.
max_utilization:
type: integer
description: Maximum consumption of this resource since the last instance start-up.
initial_allocation:
type: string
description: Initial allocation. This will be equal to the value specified for the resource in the initialization parameter file (UNLIMITED for infinite allocation).
limit_value:
type: string
description: The maximum value of utilization that will be allowed.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringAlertsItem:
type: object
description: This object represents an alert log record from V$DIAG_ALERT_EXT. V$DIAG_ALERT_EXT shows the contents of the XML-based alert log in the Automatic Diagnostic Repository (ADR). The list of attributes may vary depending on database version.
properties:
con_id:
type: integer
description: The ID of the container to which the data pertains.
adr_home:
type: string
description: Directory location of the Automatic Diagnostic Repository (ADR).
originating_timestamp:
type: string
description: Date and time when the message was generated.
normalized_timestamp:
type: string
description: Date and time when the message originated, normalized for clock drift to the Oracle Enterprise Manager repository time.
organization_id:
type: string
description: ID of the organization that wrote the originating component, usually the domain of the organization.
component_id:
type: string
description: ID of the product or component that originated the message.
host_id:
type: string
description: DNS hostname of originating host.
host_address:
type: string
description: IP of other network address of the originating host for the message.
message_type:
type: integer
description: Type of the message, indicating that a different type of response is required.
message_type_name:
type: string
description: A text description of the corresponding message type value.
message_level:
type: integer
description: Level the message belongs to. Lower level values imply higher severity for errors.
message_level_name:
type: string
description: A text description of the corresponding message level value.
message_id:
type: string
description: ID of the message.
message_group:
type: string
description: Name of the group to which the message belongs.
client_id:
type: string
description: ID of the client or security group that the message relates to.
module_id:
type: string
description: ID of the module that originated the message. This value is unique within a component.
process_id:
type: string
description: ID of the process that originated the message.
thread_id:
type: string
description: ID of the thread of the process that originated the message.
user_id:
type: string
description: ID of the user that originated the message.
detailed_location:
type: string
description: Absolute pathname of supplemental detail file on the originating host.
upstream_comp_id:
type: string
description: ID of a component that the originating component is working with on the upstream (client) side.
downstream_comp_id:
type: string
description: ID of a component that the originating component is working with on the downstream (server) side.
execution_context_id:
type: string
description: Identifies the thread of execution that the originating component participates in.
execution_context_sequence:
type: integer
description: Execution sequence of the thread that the originating component participates in.
error_instance_id:
type: integer
description: ID of the instance where error occurred.
error_instance_sequence:
type: integer
description: Instance sequence where error occurred.
message_text:
type: string
description: Fully formed and localized text of the message.
message_arguments:
type: string
description: Arguments to be bound with the generic text of the message.
supplemental_attributes:
type: string
description: Supplemental attributes that are specific to a message. This field contains the impacts for an incident type error message.
supplemental_details:
type: string
description: Supplemental data that is specific to a particular program and error message required to complete the diagnosis.
partition:
type: integer
description: Segment number of physical file.
record_id:
type: integer
description: Record number for the message (this value is same as the row number).
filename:
type: string
description: Physical file on disk.
problem_key:
type: string
description: Describes the key for the current problem that the message is associated with.
version:
type: integer
description: Oracle ARB logging standard version number for the message.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionWaitsItem:
type: object
description: This object represents a record from GV$SESSION_WAIT view. GV$SESSION_WAIT displays the current or last wait for each session. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
sid:
type: integer
description: Session identifier.
seq#:
type: integer
description: A number that uniquely identifies the current or last wait (incremented for each wait).
event:
type: string
description: If the session is currently waiting, then the resource or event for which the session is waiting. If the session is not in a wait, then the resource or event for which the session most recently waited.
p1text:
type: string
description: Description of the first wait event parameter.
p1:
type: integer
description: First wait event parameter (in decimal).
p1raw:
type: string
description: First wait event parameter (in hexadecimal).
p2text:
type: string
description: Description of the second wait event parameter.
p2:
type: integer
description: Second wait event parameter (in decimal).
p2raw:
type: string
description: Second wait event parameter (in hexadecimal).
p3text:
type: string
description: Description of the third wait event parameter.
p3:
type: integer
description: Third wait event parameter (in decimal).
p3raw:
type: string
description: Third wait event parameter (in hexadecimal).
wait_class_id:
type: integer
description: Identifier of the class of the wait event.
wait_class#:
type: integer
description: Number of the class of the wait event.
wait_class:
type: string
description: Name of the class of the wait event.
wait_time:
type: integer
description: If the session is currently waiting, then the value is 0. If the session is not in a wait, then the value indicates the duration of the last wait.
seconds_in_wait:
type: integer
description: If the session is currently waiting, then the value is the amount of time waited for the current wait. If the session is not in a wait, then the value is the amount of time since the start of the last wait.
state:
type: string
description: Wait state.
wait_time_micro:
type: integer
description: Amount of time waited (in microseconds). If the session is currently waiting, then the value is the time spent in the current wait. If the session is currently not in a wait, then the value is the amount of time waited in the last wait.
time_remaining_micro:
type: integer
description: Amount of time remaining remaining before a timeout. This field may indicate that a timeout has occurred, or that no timeout will occur.
time_since_last_wait_micro:
type: integer
description: Time elapsed since the end of the last wait (in microseconds). If the session is currently in a wait, then the value is 0.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessions:
type: object
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringSessionsItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionsItem:
type: object
description: This object represents a record from GV$SESSION view. GV$SESSION displays session information for each current session. The list of attributes may vary depending on database version.
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
saddr:
type: string
description: Session address.
sid:
type: integer
description: Session identifier.
serial#:
type: integer
description: Session serial number. Used to uniquely identify a session's objects. Guarantees that session-level commands are applied to the correct session objects if the session ends and another session begins with the same session ID.
audsid:
type: integer
description: Auditing session ID.
paddr:
type: string
description: Address of the process that owns the session.
user#:
type: integer
description: Oracle user identifier.
username:
type: string
description: Oracle username.
command:
type: integer
description: Command in progress (last statement parsed).
ownerid:
type: integer
description: Identifier of the user who owns the migratable session.
taddr:
type: string
description: Address of the transaction state object.
lockwait:
type: string
description: Address of the lock the session is waiting for; NULL if none.
status:
type: string
description: Status of the session.
server:
type: string
description: Server type.
schema#:
type: integer
description: Schema user identifier.
schemaname:
type: string
description: Schema user name.
osuser:
type: string
description: Operating system client user name.
process:
type: string
description: Operating system client process ID.
machine:
type: string
description: Operating system machine name.
port:
type: integer
description: Client port number.
terminal:
type: string
description: Operating system terminal name.
program:
type: string
description: Operating system program name.
type:
type: string
description: Session type.
sql_address:
type: string
description: Used with sql_hash_value to identify the SQL statement that is currently being executed.
sql_hash_value:
type: integer
description: Used with SQL_ADDRESS to identify the SQL statement that is currently being executed.
sql_id:
type: string
description: SQL identifier of the SQL statement that is currently being executed.
sql_child_number:
type: integer
description: Child number of the SQL statement that is currently being executed.
sql_exec_start:
type: string
description: Time when the execution of the SQL currently executed by this session started; NULL if SQL_ID is NULL.
sql_exec_id:
type: integer
description: SQL execution identifier; NULL if SQL_ID is NULL or if the execution of that SQL has not yet started.
prev_sql_addr:
type: string
description: Used with PREV_HASH_VALUE to identify the last SQL statement executed.
prev_hash_value:
type: integer
description: Used with SQL_HASH_VALUE to identify the last SQL statement executed.
prev_sql_id:
type: string
description: SQL identifier of the last SQL statement executed.
prev_child_number:
type: integer
description: Child number of the last SQL statement executed.
prev_exec_start:
type: string
description: SQL execution start of the last executed SQL statement.
prev_exec_id:
type: integer
description: SQL execution identifier of the last executed SQL statement.
plsql_entry_object_id:
type: integer
description: Object ID of the top-most PL/SQL subprogram on the stack; NULL if there is no PL/SQL subprogram on the stack.
plsql_entry_subprogram_id:
type: integer
description: Subprogram ID of the top-most PL/SQL subprogram on the stack; NULL if there is no PL/SQL subprogram on the stack.
plsql_object_id:
type: integer
description: Object ID of the currently executing PL/SQL subprogram; NULL if executing SQL.
plsql_subprogram_id:
type: integer
description: Subprogram ID of the currently executing PL/SQL object; NULL if executing SQL.
module:
type: string
description: Name of the currently executing module as set by calling the DBMS_APPLICATION_INFO.SET_MODULE procedure.
module_hash:
type: integer
description: Hash value of the MODULE column.
action:
type: string
description: Name of the currently executing action as set by calling the DBMS_APPLICATION_INFO.SET_ACTION procedure.
action_hash:
type: integer
description: Hash value of the ACTION column.
client_info:
type: string
description: Information set by the DBMS_APPLICATION_INFO.SET_CLIENT_INFO procedure.
fixed_table_sequence:
type: integer
description: This contains a number that increases every time the session completes a call to the database and there has been an intervening select from a dynamic performance table. This column can be used by performance monitors to monitor statistics in the database.
row_wait_obj#:
type: integer
description: Object ID for the table containing the row specified in row_wait_row#.
row_wait_file#:
type: integer
description: Identifier for the data file containing the row specified in row_wait_row#. This property is valid only if the session is currently waiting for another transaction to commit and the value of row_wait_obj# is not -1.
row_wait_block#:
type: integer
description: Identifier for the block containing the row specified in row_wait_row#. This property is valid only if the session is currently waiting for another transaction to commit and the value of row_wait_obj# is not -1.
row_wait_row#:
type: integer
description: Current row being locked. This property is valid only if the session is currently waiting for another transaction to commit and the value of row_wait_obj# is not -1.
top_level_call#:
type: integer
description: Oracle top level call number.
logon_time:
type: string
description: Time of logon.
last_call_et:
type: integer
description: If the session STATUS is currently ACTIVE, then the value represents the elapsed time (in seconds) since the session has become active. If the session STATUS is currently INACTIVE, then the value represents the elapsed time (in seconds) since the session has become inactive.
pdml_enabled:
type: string
description: This column has been replaced by the PDML_STATUS column.
failover_type:
type: string
description: Indicates whether and to what extent transparent application failover (TAF) is enabled for the session.
failover_method:
type: string
description: Indicates the transparent application failover method for the session.
failed_over:
type: string
description: Indicates whether the session is running in failover mode and failover has occurred (YES) or not (NO).
resource_consumer_group:
type: string
description: Name of the session's current resource consumer group.
pdml_status:
type: string
description: If ENABLED, the session is in a PARALLEL DML enabled mode. If DISABLED, PARALLEL DML enabled mode is not supported for the session. If FORCED, the session has been altered to force PARALLEL DML.
pddl_status:
type: string
description: If ENABLED, the session is in a PARALLEL DDL enabled mode. If DISABLED, PARALLEL DDL enabled mode is not supported for the session. If FORCED, the session has been altered to force PARALLEL DDL.
pq_status:
type: string
description: If ENABLED, the session is in a PARALLEL QUERY enabled mode. If DISABLED, PARALLEL QUERY enabled mode is not supported for the session. If FORCED, the session has been altered to force PARALLEL QUERY.
current_queue_duration:
type: integer
description: If queued (1), the current amount of time the session has been queued. If not currently queued, the value is 0.
client_identifier:
type: string
description: Client identifier of the session.
blocking_session_status:
type: string
description: This column provides details on whether there is a blocking session.
blocking_instance:
type: integer
description: Instance identifier of the blocking session. This column is valid only if BLOCKING_SESSION_STATUS has the value VALID.
blocking_session:
type: integer
description: Session identifier of the blocking session. This column is valid only if BLOCKING_SESSION_STATUS has the value VALID.
final_blocking_session_status:
type: string
description: The final blocking session is the final element in the wait chain constructed by following the sessions that are blocked by one another starting with this session. In the case of a cyclical wait chain, one of the sessions in the wait chain will be chosen as the final blocker.
final_blocking_instance:
type: integer
description: Instance identifier of the final blocking session. This column is valid only if FINAL_BLOCKING_SESSION_STATUS has the value VALID.
final_blocking_session:
type: integer
description: Session identifier of the blocking session. This column is valid only if FINAL_BLOCKING_SESSION_STATUS has the value VALID.
seq#:
type: integer
description: A number that uniquely identifies the current or last wait (incremented for each wait).
event#:
type: integer
description: If the session is currently waiting, then the number of the resource or event for which the session is waiting. If the session is not in a wait, then the number of the resource or event for which the session most recently waited.
event:
type: string
description: If the session is currently waiting, then the resource or event for which the session is waiting. If the session is not in a wait, then the resource or event for which the session most recently waited.
p1text:
type: string
description: Description of the first wait event parameter.
p1:
type: integer
description: First wait event parameter (in decimal).
p1raw:
type: string
description: First wait event parameter (in hexadecimal).
p2text:
type: string
description: Description of the second wait event parameter.
p2:
type: integer
description: Second wait event parameter (in decimal).
p2raw:
type: string
description: Second wait event parameter (in hexadecimal).
p3text:
type: string
description: Description of the third wait event parameter.
p3:
type: integer
description: Third wait event parameter (in decimal).
p3raw:
type: string
description: Third wait event parameter (in hexadecimal).
wait_class_id:
type: integer
description: Identifier of the class of the wait event.
wait_class#:
type: integer
description: Number of the class of the wait event.
wait_class:
type: string
description: Name of the class of the wait event.
wait_time:
type: integer
description: If the session is currently waiting, then the value is 0. If the session is not in a wait, then the value indicates the duration of the last wait.
seconds_in_wait:
type: integer
description: If the session is currently waiting, then the value is the amount of time waited for the current wait. If the session is not in a wait, then the value is the amount of time since the start of the last wait.
state:
type: string
description: Wait state.
wait_time_micro:
type: integer
description: Amount of time waited (in microseconds). If the session is currently waiting, then the value is the time spent in the current wait. If the session is currently not in a wait, then the value is the amount of time waited in the last wait.
time_remaining_micro:
type: integer
description: Amount of time remaining remaining before a timeout. This field may indicate that a timeout has occurred, or that no timeout will occur.
time_since_last_wait_micro:
type: integer
description: Time elapsed since the end of the last wait (in microseconds). If the session is currently in a wait, then the value is 0.
service_name:
type: string
description: Service name of the session.
sql_trace:
type: string
description: Indicates whether SQL tracing is enabled (ENABLED) or disabled (DISABLED).
sql_trace_waits:
type: string
description: Indicates whether wait tracing is enabled (TRUE) or not (FALSE).
sql_trace_binds:
type: string
description: Indicates whether bind tracing is enabled (TRUE) or not (FALSE).
sql_trace_plan_stats:
type: string
description: Frequency at which row source statistics are dumped in the trace files for each cursor.
session_edition_id:
type: integer
description: Shows the value that, in the session, would be reported by sys_context('USERENV', 'SESSION_EDITION_ID').
creator_addr:
type: string
description: Address of the creating process or circuit.
creator_serial#:
type: integer
description: Serial number of the creating process or circuit.
ecid:
type: string
description: Execution context identifier (sent by Application Server).
sql_translation_profile_id:
type: integer
description: Object number of the SQL translation profile.
pga_tunable_mem:
type: integer
description: The amount of tunable PGA memory (in bytes).
shard_ddl_status:
type: string
description: Indicates whether shard DDL is enabled in the current session (ENABLED) or not (DISABLED). This value is only relevant for the shard catalog database.
con_id:
type: integer
description: The ID of the container to which the data pertains.
external_name:
type: string
description: External name of the database user. For enterprise users, returns the Oracle Internet Directory DN.
plsql_debugger_connected:
type: string
description: Indicates whether the session is connected to a PL/SQL debugger.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionLocksWaiting:
type: object
description: This collection represents database locks held by sessions that are waiting on other sessions. The list of attributes may vary depending on database version.
properties:
items:
type: array
items:
$ref: '#/components/schemas/MonitoringSessionLocksItem'
hasMore:
type: boolean
description: Indicates if there are more records to be retrieved.
limit:
type: integer
description: The actual page size limit on number of records applied by the server.
offset:
type: integer
description: The actual index from which the item resources are returned.
count:
type: integer
description: Total number of records in the current response.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringWaitClassMetricsItem:
type: object
description: This object combines data from GV$WAITCLASSMETRIC and GV$SYSTEM_WAIT_CLASS views to represent metric values of wait classes for the most recent 60-second interval.
properties:
items:
type: array
items:
type: object
properties:
begin_time:
type: string
description: Begin time of the interval.
end_time:
type: string
description: End time of the interval.
intsize_csec:
type: integer
description: Interval size (in hundredths of a second).
average_waiter_count:
type: integer
description: Average waiter count.
dbtime_in_wait:
type: integer
description: Percent of database time spent in the wait.
wait_count:
type: integer
description: Number of times waited.
wait_count_fg:
type: integer
description: Number of times foreground processes waited.
wait_class_id:
type: integer
description: Identifier of the wait class.
wait_class#:
type: integer
description: Number of the wait class.
wait_class:
type: string
description: Name of the wait class.
total_waits:
type: integer
description: Number of times waits of the class occurred.
time_waited:
type: integer
description: Amount of time (in hundredths of a second) spent in the wait by all sessions in the instance.
total_waits_fg:
type: integer
description: Number of times waits from this wait class occurred in foreground sessions.
time_waited_fg:
type: integer
description: Amount of time (in hundredths of a second) spent in waits from this wait class in foreground sessions.
con_id:
type: integer
description: The ID of the container to which the data pertains.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
MonitoringSessionTypeSummariesItem:
type: object
description: Using data from GV$SESSION this object represents a summary of the number of sessions in different states aggregated across different session types (BACKGROUND and USER).
properties:
items:
type: array
items:
type: object
properties:
inst_id:
type: integer
description: Oracle Real Application Clusters instance number for which this data relates to. In a non-RAC database this number will be 1.
type:
type: string
description: Session type.
number_of_sessions:
type: integer
description: Total number of sessions of this type.
number_of_active_sessions:
type: integer
description: Total number of active sessions of this type.
number_of_inactive_sessions:
type: integer
description: Total number of inactive sessions of this type.
number_of_active_blocking_sess:
type: integer
description: Total number of active blocking sessions of this type.
number_of_act_non_blocking_ses:
type: integer
description: Total number of active non-blocking sessions of this type.
links:
type: array
items:
$ref: '#/components/schemas/LinkRelation'
examples:
FilterCriteria:
summary: Implicit EQUALS operator for a number. Supports String and Dates too.
value:
SALARY: 1000
OrderByProperty:
summary: Order by with literals.
value:
$orderby:
SALARY: ASC
ENAME: DESC
FilterAndOrder:
summary: Filter criteria supports a wide range of operators. In this example LIKE operator ($like) is used. See Oracle REST Data Services production documentation 'Filtering in Queries' section for further information on the operators available.
value:
ENAME:
$like: AX%
$orderby:
ENAME: ASC
parameters:
Filter:
name: q
in: query
description: Filtering is the process of limiting a collection resource by using a per-request dynamic filter definition across multiple page resources, where each page contains a subset of items found in the complete collection. Filtering enables efficient traversal of large collections.
required: false
schema:
$ref: '#/components/schemas/Filter'
examples:
FilterCriteriaExample:
$ref: '#/components/examples/FilterCriteria'
OrderByPropertyExample:
$ref: '#/components/examples/OrderByProperty'
FilterAndOrderExample:
$ref: '#/components/examples/FilterAndOrder'
Limit:
name: limit
in: query
description: The maximum number of records to return.
required: false
schema:
type: integer
format: int32
securitySchemes:
BasicAuth:
type: http
scheme: basic
BearerAuth:
type: http
scheme: bearer
OAuth2:
type: oauth2
flows:
implicit:
authorizationUrl: /oauth/auth
scopes: {}
authorizationCode:
authorizationUrl: /oauth/auth
tokenUrl: /oauth/token
scopes: {}
clientCredentials:
tokenUrl: /oauth/token
scopes: {}
externalDocs:
description: Oracle REST Data Services product documentation.
url: https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/