Oracle database insights

Early Adopter

Database insights adds an infrastructure perspective to your database monitoring. With additional data fetched from the database layer, you're able to resolve performance problems that are rooted deep in the database.

How it works

Database insights runs on an Environment ActiveGate and connects remotely to Oracle databases. With this approach, the database system platform can be of any type—Dynatrace supports all operating systems using the JDBC driver to connect to databases.

Oracle insights architecture


You need the following to start using database insights with your Oracle database:

  • Environment ActiveGate version 1.173+ installed in the default mode. Database insights doesn't support an ActiveGate that's configured for multi-environment support.
  • Database insights requires 2.5 MB of RAM per Oracle database endpoint, which translates to a capability to monitor a few hundred databases with ActiveGate installed on the EC2 micro instance.
  • Dynatrace Server version 1.173+.
  • Network communication between the ActiveGate and the Oracle Server.
  • Oracle version 11g to 19c, including the support for:
    • Oracle Multitenant
      Monitoring results may vary between the SID-based and ServiceName-based endpoints. For SID-based endpoints, Dynatrace monitors connections to the multitenant container database (CDB). For ServiceName-based endpoints, Dynatrace monitors connections to associated pluggable databases (PDBs).
    • Oracle RAC
      Dynatrace monitors individual nodes only, not the cluster.
    • AWS Oracle RDS
  • Optional OneAgent installed on the Oracle host.
  • An Oracle database user with the permissions listed below.

Oracle permissions

You need to satisfy the following permissions on the Oracle server for Oracle database insights:

  • The user that connects to the DB instance needs to be granted the CREATE SESSION and SELECT_CATALOG_ROLE permissions. This also means the access to Dynamic Performance Views, which is a part of the SELECT_CATALOG_ROLE permission.
  • DBMS_XPLAN package with granted EXECUTE permission is required to fetch execution plans.

To create a user for Oracle database insights:

CREATE USER oracleinsights IDENTIFIED BY password
default tablespace users
temporary tablespace temp;


Setting up Oracle database insights

Setting up Oracle database insights is straightforward. All you have to do is to define an endpoint—the Oracle database that the ActiveGate will connect to. You can add as many databases from a single Oracle server as necessary.

  1. Optional Install OneAgent on the Oracle host.
  2. Select or install and Environment ActiveGate version 1.173+ that will fetch the data from your Oracle server. You can use this ActiveGate for other purposes as well. Go to Settings > Deployment status to verify if your ActiveGate is up and running. Database insights is enabled by default.
  3. Go to Settings > Monitoring > Monitored Technologies.
  4. Find the Database Insights: Oracle row and click the pen icon to edit it.
  5. Define your Oracle database endpoint. All fields are mandatory:
    • Oracle host
    • Port: default = 1521
    • Connection type: Service or SID
    • Service/SID: database identifier
    • Database user and Database password: For details, see the Oracle permissions section.
    • Monitored database name: name of the database you want to monitor
  6. Select the check box to accept the redistribution license agreement for the Oracle JDBC driver. Dynatrace uses this to fetch the data from your Oracle server. Your data is secure.
  7. Click Add database. If Dynatrace can establish the connection using the details you've provided, Dynatrace will start monitoring your Oracle database.

Enabling and disabling Oracle database insights

To disable or enable Oracle database insights per monitored database

  1. Go to Settings > Monitoring > Monitored Technologies.
  2. Find the Database Insights: Oracle row and click the pen icon to edit it.
  3. Set the Monitoring off/on switch per database.

Oracle database insights monitoring model

Installing OneAgent on the Oracle host is optional for database insights. Whether it is installed or not, all metrics are reported under Custom device to reflect the logical structure of your DB server instance, running services, containers, and plugged databases.

However, installing OneAgent on the Oracle host supplements the performance analysis of the server with all the OS process metrics reported to the process group and their instances split by the server instances (SIDs) and listener processes.

Oracle database insights capabilities

Most time-consuming Oracle statements

To understand and analyze which Oracle statements are the most expensive and most frequently called, click View statements in the Most time-consuming Oracle statements section. The page lists the 100 most time consuming statements. With a single click, you can see the statements that consume the most CPU, memory, or disk storage, or that generate the most wait time. You can customize your analysis using up to three metrics available for TopN analysis.

Download execution plans

When analyzing the performance characteristics of a SQL statement, you often find yourself in need of generating and displaying the execution plan of the SQL statement. You can download the Oracle execution plan right from the Dynatrace UI.

Memory and cache metrics

Oracle database insights provide you with additional Oracle metrics related to memory and caches, which enables you to pinpoint the RAM-heavy statements.

Custom charts

All the Oracle-native metrics fetched by Oracle database insights are available for custom charts.

Wait and tablespace metrics

You can also refer to the wait and tablespace metrics, which are available to be used in your custom charts

Oracle process groups

Dynatrace binds the data fetched by Oracle database insights with the Oracle processes detected by OneAgent. Starting with OneAgent version 1.173, each Oracle process group represents a single Oracle SID (unique identifier for every Oracle DB instance). The SID is part of the process group name and is extracted from process names (Unix) or service description (Windows). Oracle processes not associated with any SID form an Oracle other processes group. This includes the TNS Listener communication process, so all incoming and outgoing traffic is associated with the group.


Do I need a plugin to use Oracle database insights?
No, database insights is a default Dynatrace feature starting with version 1.173.

What is the license model?
The current Early Adopter release of database insights is free, available with every ActiveGate and Dynatrace server version 1.173+. In the future, the price will be based on the number of consumed metrics.

Can I use a Cluster ActiveGate for Oracle database insight?
No. You can only use an Environment ActiveGate that remotely connects to your Oracle server and fetches metrics and properties every minute. As Environment ActiveGate is installed in your local environment, this strengthens the security and minimizes the traffic load in your network. Note that the main purpose of the Cluster ActiveGate is OneAgent traffic routing.

Do I need to install OneAgent on the Oracle host?
No, but we recommend it, because doing so gives you a better overall picture of your database, the server, and all the processes running on it, and even log monitoring. This way you’ll be able to react to potential issues quicker, and you'll have a better understanding of the root cause.