dbXplorer for Oracle DBMS

Supported OS Linux

marketplace
Integration version1.0.0

Overview

dbXplorer enables you to monitor Oracle (19c or later) databases, providing you with real-time analytics and performance metrics available in Datadog. This integration gives deep visibility into the health and performance of your Oracle database instances.

With this integration:

  • Proactively Monitor: Detect potential issues early through real-time alerts on performance bottlenecks, unusual activities, or failures.
  • Optimize Performance: Gather insights into database performance to help tune queries and resources, ensuring optimal utilization and response times.
  • Simplified Management: Centralize monitoring of multiple Oracle databases into a single platform, streamlining the management process and reducing operational overhead.

This integration monitors the following types of data from Oracle databases:

  • Performance Metrics: Includes data on query response times, memory usage (for example, PGA and SGA statistics), and resource bottlenecks. This data helps in identifying performance issues and optimizing database operations.
  • Health Metrics: Tracks critical health indicators such as connection times, user sessions, and system availability, enabling timely intervention to prevent downtimes.

About ITUnified: with more than two decades of expertise, their Oracle-certified database Administrator (DBA) professionals are equipped with the skills required to handle intricate projects and support clients in managing and administering their databases. ITUnified specializes in tailored database support and services through a detailed needs assessment.

Metrics

dbxplorer.oracle.database.integration.status
(gauge)
Count of unique databases being monitored by the integration
dbxplorer.oracle.database.availability.status
(gauge)
DB availability
dbxplorer.oracle.database.awr.ash.delta_interconnect_io_bytes
(gauge)
Number of I/O bytes sent over the I/O interconnect over the last DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.delta_read_io_bytes
(gauge)
Number of I/O bytes read by this session over the last DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.delta_read_io_requests
(gauge)
Number of read I/O requests made by this session over the last DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.delta_time
(gauge)
Time interval (in microseconds) since the last time this session was sampled or created over which the next five statistics are accumulated
dbxplorer.oracle.database.awr.ash.delta_write_io_bytes
(gauge)
Number of I/O bytes written by this session over the last DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.delta_write_io_requests
(gauge)
Number of write I/O requests made by this session over the last DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.pga_allocated_in_bytes
(gauge)
Amount of PGA memory (in bytes) consumed by this session at the time this sample was taken
dbxplorer.oracle.database.awr.ash.temp_space_allocated_in_bytes
(gauge)
Amount of TEMP memory (in bytes) consumed by this session at the time this sample was taken
dbxplorer.oracle.database.awr.ash.tm_delta_cpu_time
(gauge)
Amount of time this session spent on CPU over the last TM_DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.tm_delta_db_time
(gauge)
Amount of time spent by this session in database calls over the last TM_DELTA_TIME microseconds
dbxplorer.oracle.database.awr.ash.tm_delta_time
(gauge)
Time interval (in microseconds) over which TM_DELTA_CPU_TIME and TM_DELTA_DB_TIME are accumulated
dbxplorer.oracle.database.awr.dba_hist_sqlstat.apwait_delta
(gauge)
Delta value of application wait time (in microseconds)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.buffer_gets_delta
(gauge)
Delta number of buffer gets for this child cursor
dbxplorer.oracle.database.awr.dba_hist_sqlstat.ccwait_delta
(gauge)
Delta value of concurrency wait time (in microseconds)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.cell_uncompressed_bytes_delta
(gauge)
Delta value of number of uncompressed bytes (that is size after decompression) that are offloaded to the Exadata cells
dbxplorer.oracle.database.awr.dba_hist_sqlstat.clwait_delta
(gauge)
Delta value of cluster wait time (in microseconds)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.cpu_time_delta
(gauge)
Delta value of CPU time (in microseconds) used by this cursor for parsing/executing/fetching
dbxplorer.oracle.database.awr.dba_hist_sqlstat.direct_writes_delta
(gauge)
Delta value of direct writes
dbxplorer.oracle.database.awr.dba_hist_sqlstat.disk_reads_delta
(gauge)
Delta number of disk reads for this child cursor
dbxplorer.oracle.database.awr.dba_hist_sqlstat.elapsed_time_delta
(gauge)
Delta value of elapsed time (in microseconds) used by this cursor for parsing/executing/fetching
dbxplorer.oracle.database.awr.dba_hist_sqlstat.executions_delta
(gauge)
Delta number of executions that took place on this object since it was brought into the library cache
dbxplorer.oracle.database.awr.dba_hist_sqlstat.fetches_delta
(gauge)
Delta number of fetches associated with the SQL statement
dbxplorer.oracle.database.awr.dba_hist_sqlstat.invalidations_delta
(gauge)
Delta number of times this child cursor has been invalidated
dbxplorer.oracle.database.awr.dba_hist_sqlstat.io_interconnect_bytes_delta
(gauge)
Delta value of number of I/O bytes exchanged between Oracle Database and the storage system
dbxplorer.oracle.database.awr.dba_hist_sqlstat.io_offload_elig_bytes_delta
(gauge)
Delta value of the bytes eligible for IO offload
dbxplorer.oracle.database.awr.dba_hist_sqlstat.io_offload_return_bytes_delta
(gauge)
Delta value of the bytes returned from IO offload
dbxplorer.oracle.database.awr.dba_hist_sqlstat.iowait_delta
(gauge)
Delta value of user I/O wait time (in microseconds)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.javexec_time_delta
(gauge)
Delta value of Java Execution Time (in microseconds)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.loaded_versions
(gauge)
Indicates whether the context heap is loaded (1) or not (0)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.loads_delta
(gauge)
Deltanumber of times the object was either loaded or reloaded
dbxplorer.oracle.database.awr.dba_hist_sqlstat.parse_calls_delta
(gauge)
Delta number of parse calls for this child cursor
dbxplorer.oracle.database.awr.dba_hist_sqlstat.physical_read_bytes_delta
(gauge)
Delta value of physical read bytes
dbxplorer.oracle.database.awr.dba_hist_sqlstat.physical_write_bytes_delta
(gauge)
Delta value of physical write bytes
dbxplorer.oracle.database.awr.dba_hist_sqlstat.plsexec_time_delta
(gauge)
Delta value of PL/SQL Execution Time (in microseconds)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.px_servers_execs_delta
(gauge)
Delta number of PX server executions
dbxplorer.oracle.database.awr.dba_hist_sqlstat.rows_processed_delta
(gauge)
Delta number of rows the parsed SQL statement returns
dbxplorer.oracle.database.awr.dba_hist_sqlstat.sharable_mem
(gauge)
Amount of shared memory used by the child cursor (in bytes)
dbxplorer.oracle.database.awr.dba_hist_sqlstat.sorts_delta
(gauge)
Delta number of sorts that were done for this child cursor
dbxplorer.oracle.database.awr.dba_hist_sqlstat.version_count
(gauge)
Number of children associated with the cursor
dbxplorer.oracle.database.health.osstat.busy_time_in_seconds
(gauge)
Total busy time of processors executing user or kernel code in seconds
dbxplorer.oracle.database.health.osstat.free_memory_bytes
(gauge)
Total available physical memory in bytes
dbxplorer.oracle.database.health.osstat.idle_time_in_seconds
(gauge)
Total idle time of processors in seconds
dbxplorer.oracle.database.health.osstat.iowait_time_in_seconds
(gauge)
Total time processors have been waiting for I/O to complete in seconds
dbxplorer.oracle.database.health.osstat.load
(gauge)
Average system load over the past minute
dbxplorer.oracle.database.health.osstat.num_cpus
(gauge)
Number of CPUs or processors available
dbxplorer.oracle.database.health.osstat.physical_memory_bytes
(gauge)
Total number of bytes of physical memory
dbxplorer.oracle.database.health.osstat.sys_time_in_seconds
(gauge)
Total time processors have been executing kernel code in seconds
dbxplorer.oracle.database.health.osstat.user_time_in_seconds
(gauge)
Total time processors have been executing user code in seconds
dbxplorer.oracle.database.health.osstat.vm_in_bytes
(gauge)
Total number of bytes of data that have been paged in due to virtual memory paging
dbxplorer.oracle.database.health.osstat.vm_out_bytes
(gauge)
Total number of bytes of data that have been paged out due to virtual memory paging
dbxplorer.oracle.database.health.pga.value
(gauge)
Statistic value
dbxplorer.oracle.database.health.session_event.time_waited_micro
(gauge)
Total amount of time waited for the event by the session (in microseconds)
dbxplorer.oracle.database.health.session_event.total_waits
(gauge)
Total number of waits for the event by the session
dbxplorer.oracle.database.health.session_wait.seconds_in_wait
(gauge)
How long (in seconds) the session has been waiting for the current event
dbxplorer.oracle.database.health.session_wait.wait_time
(gauge)
Session wait time
dbxplorer.oracle.database.health.sysstat.value
(gauge)
Statistics value
dbxplorer.oracle.database.health.system_event.average_wait_in_seconds
(gauge)
Average wait time for events in seconds
dbxplorer.oracle.database.health.system_event.time_waited_fg_in_seconds
(gauge)
Total foreground session wait time in seconds
dbxplorer.oracle.database.health.system_event.time_waited_in_seconds
(gauge)
Total wait time for events in seconds
dbxplorer.oracle.database.health.system_event.time_waited_micro_fg
(gauge)
Total foreground session wait time in microseconds
dbxplorer.oracle.database.health.system_event.total_timeouts
(gauge)
Total number of timeouts for events
dbxplorer.oracle.database.health.system_event.total_waits
(gauge)
Total number of waits for events
dbxplorer.oracle.database.health.system_event.total_waits_fg
(gauge)
Total number of waits for events from foreground sessions
dbxplorer.oracle.database.space.recovery_area.percent_reclaimable
(gauge)
Total amount of disk space (in bytes) that can be created by deleting obsolete redundant and other low priority files from the fast recovery area
dbxplorer.oracle.database.space.recovery_area.percent_used
(gauge)
Percentage of used disk space
dbxplorer.oracle.database.space.recovery_area.reclaimable_bytes
(gauge)
Total amount of disk space (in bytes) that can be created by deleting obsolete redundant and other low priority files from the fast recovery area
dbxplorer.oracle.database.space.recovery_area.total_bytes
(gauge)
Maximum amount of disk space (in bytes) that the database can use for the fast recovery area. This is the value specified in the DB_RECOVERY_FILE_DEST_SIZE initialization parameter.
dbxplorer.oracle.database.space.recovery_area.used_bytes
(gauge)
Amount of disk space (in bytes) used by fast recovery area files created in current and all previous fast recovery areas. Changing fast recovery areas does not reset SPACE_USED to 0.
dbxplorer.oracle.database.space.tablespace.allocated_size_bytes
(gauge)
Tablespace allocated bytes
dbxplorer.oracle.database.space.tablespace.data_file_count
(gauge)
Count of datafiles in tablespace
dbxplorer.oracle.database.space.tablespace.fragmentation
(gauge)
Tablespace fragmentation
dbxplorer.oracle.database.space.tablespace.free_bytes
(gauge)
Tablespace free bytes
dbxplorer.oracle.database.space.tablespace.max_free_bytes
(gauge)
Tablespace max free bytes
dbxplorer.oracle.database.space.tablespace.max_ts_size_bytes
(gauge)
Tablespace max size in bytes
dbxplorer.oracle.database.space.tablespace.ts_segment_size_bytes
(gauge)
Tablespace segment size in bytes
dbxplorer.oracle.database.space.tablespace.used_size_bytes
(gauge)
Tablespace used size in bytes

Monitors

With 12 included monitors, get notified with:

  • Anomaly detection for SQL executions based on CPU and elapsed times.
  • Database health alerts for load and wait events
  • General database availability
  • Predictive alerts for tablespace usage of undo, temporary and permanent tablespaces
  • Predictive alerts for recovery area usage
  • Predictive alerts for ASM disk usage

Dashboards

The dbXplorer integration contains 4 dashboards:

dbXplorer - ASH Monitoring

The “dbXplorer - ASH Monitoring” dashboard is designed to provide a comprehensive performance analysis of Oracle Databases, leveraging SQLSTAT and ACTIVE SESSION HISTORY (ASH) data. The dashboard combines SQL execution metrics from SQLSTAT with session-level activity insights from ASH, enabling a holistic view of database performance and opportunities for optimization. It features multiple widgets including detailed timeseries graphs and query tables that monitor and analyze various performance metrics such as elapsed time, CPU time, and I/O operations. Key features include anomaly detection for specific SQL identifiers, historical performance analysis, and trend monitoring to diagnose performance issues and optimize database operations.

dbXplorer - DB Performance Health

The “dbXplorer - DB Performance Health” dashboard is tailored for comprehensive monitoring of Oracle Database performance, focusing on various critical aspects such as load anomalies, session wait anomalies, CPU usage, and memory usage. It employs multiple widgets that visually display data using graphs and tables, helping database administrators quickly identify and address performance bottlenecks. Key features include detailed analysis of session wait events through the v$session_event and v$session_wait views, which offer insights into specific wait events and their impact on database sessions. Additionally, the dashboard provides tools to monitor and analyze system-wide performance metrics via the v$system_event and v$osstat views, covering system-level waits and operating system interactions that affect database operations.

dbXplorer - Space Monitoring

The “dbXplorer - Space Monitoring” dashboard provides detailed monitoring and forecasting for Oracle database tablespaces, recovery areas, and Automatic Storage Management (ASM) disk groups. It enables visualization of current and historical data usage, alerts for critical thresholds, and trends in space allocation over various time frames. Widgets within the dashboard include timeseries graphs, query tables, and status summaries that allow users to track metrics like total, used, and available space efficiently. Additionally, the dashboard offers dynamic filtering options through template variables, making it highly customizable for specific database instances or clusters. This tool is essential for database administrators aiming to maintain optimal performance and preempt potential space-related issues in their systems.

dbXplorer - Status Summary

The “dbXplorer - Status Summary” dashboard provides a concise view of status and logs for database operations. It features “Availability Logs” that display events related to database availability, sorted by various parameters such as timestamp and instance name. Another widget, “dbXplorer Logs,” organizes log data from database transactions into a summarized view, grouping by logger name and showing counts of logs by severity. The “Status Summary” widget offers an overview of statuses in a list and count format, prioritizing the data display based on the severity of issues.

dbXplorer - Oracle LMS

The “dbXplorer - Oracle LMS” dashboard focuses on Oracle License Management Services (LMS), and tracks and reports on the usage of database features that are relevant for licensing. It features a visualization of CPU count which helps in understanding the scale of database operations and the potential licensing needs. Additionally, the dashboard includes detailed feature usage statistics, which executes complex queries to map database features to products, classifying the usage into categories like current and past usage, and managing exceptions in feature reporting. While this dashboard is an essential tool for database administrators to ensure compliance with Oracle licensing requirements it should not be relied on exclusively for licensing purposes.

Prerequisites

  • Oracle database versions from 19c EE using Oracle Grid Infrastructure are supported. Collection from earlier database versions or serverless installations are not supported.

  • This integration requires an Oracle Diagnostic and Tuning Pack license. If you do not wish to use or license this pack, be sure to disable the collection of ASH and AWR metrics. An explanation of how to collect or disable these metrics can be found in the setup instructions.

Support

For support or feature requests, reach out to support.datadog@itunified.de.

Further Reading

Additional helpful documentation, links, and articles:


This application is made available through the Marketplace and is supported by a Datadog Technology Partner. Click Here to purchase this application.

PREVIEWING: teddy.gesbert/doc-dora