Oracle data source
Connect Grafana to your Oracle Database to monitor application performance, track business metrics, and build operational dashboards using live SQL queries.
Note
The Oracle data source is an Enterprise plugin. It’s available with a Grafana Cloud Pro or Advanced plan and Grafana Enterprise. For installation instructions, refer to Install and upgrade the Oracle data source plugin.
Supported features
Requirements
To use the Oracle data source, you need:
- An Oracle Database instance with at least one user that has
SELECTpermissions on the tables you want to query. - One of the following licenses:
- A Grafana Cloud Pro or Advanced plan (not available on the free tier).
- An activated self-managed Grafana Enterprise license with the plugin entitlement included.
- Grafana version 11.6.7 or later.
Supported Oracle Database versions
The plugin uses the go-ora driver. Oracle 19c is tested internally.
Verify your license entitlement
If you encounter license errors, refer to Troubleshoot licensing issues.
Known limitations
- The Oracle plugin doesn’t support ARM64 architecture (for example, Apple Silicon M1/M2 Macs).
- TNSNames and Kerberos authentication are not supported in Grafana Cloud.
- Oracle Wallet authentication and LDAP-based TNS resolution are not supported in plugin v3.x. Refer to Upgrade from v2.x to v3.x for migration details.
Get started
The following documents help you set up and use the Oracle data source:
- Get started on Grafana Cloud—install, connect, and query in under 10 minutes.
- Install and upgrade
- Configure the Oracle data source
- Kerberos integration
- Oracle query editor
- Template variables
- Annotations
- Alerting
- Troubleshooting
Additional features
After configuring the data source, you can:
- Use Explore to run ad-hoc queries without building a dashboard.
- Add transformations to manipulate query results.
- Set up alerting rules based on Oracle queries.
Plugin updates
Always ensure that your plugin version is up-to-date so you have access to all current features and improvements. Navigate to Plugins and data > Plugins to check for updates. Grafana recommends upgrading to the latest Grafana version, and this applies to plugins as well. For detailed upgrade steps and version compatibility, refer to Install and upgrade.
Note
Plugins are automatically updated in Grafana Cloud.


