---
title: "Oracle Database integration | Grafana Labs"
description: "Set up Oracle Database monitoring with Grafana Cloud integrations"
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

## Oracle Database integration

Oracle Database is a multi-model relational database management system used widely in enterprise environments. The Oracle Database integration monitors session and process activity, tablespace utilization, and wait events.

|                      |                                                                                                                                               |
|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| **What it monitors** | Sessions, processes, tablespace usage, wait times, resource limits, and `oracledb_up` availability                                            |
| **How it works**     | Grafana Alloy’s built-in OracleDB exporter scrapes metrics from your Oracle instance using Oracle Instant Client                              |
| **What you get**     | 3 alerts + 1 dashboard (OracleDB Overview) + log collection (alert log)                                                                       |
| **Prerequisites**    | Oracle Instant Client installed on the Alloy host with `ORACLE_HOME` set (Alloy 1.9.0+), plus a monitoring user with specific `SELECT` grants |

## What you’ll see in the dashboard

- **Sessions and processes** — Active sessions, process counts, and how close you are to configured limits
- **Tablespace utilization** — Used vs. allocated space across tablespaces
- **Wait events** — Which categories of waits are consuming time inside the database
- **Resource limits** — Current values against `v$resource_limit` thresholds
- **Availability** — `oracledb_up` for at-a-glance health

## Key alerts

| Alert                               | Severity |
|-------------------------------------|----------|
| OracleSessionLimitApproaching       | Warning  |
| OracleProcessLimitApproaching       | Warning  |
| OracleTablespaceCapacityApproaching | Warning  |

## Trade-offs

| Strengths                                                                                   | Considerations                                                                 |
|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
| Covers the metrics Oracle DBAs watch most closely — sessions, processes, tablespaces, waits | Requires Oracle Instant Client on the Alloy host with `ORACLE_HOME` configured |
| Log collection for the Oracle alert log alongside metrics                                   | Single dashboard with three alerts — leaner than other integrations            |
| Works against self-managed Oracle and Oracle on cloud-hosted VMs                            | No query-level analysis; Database Observability doesn’t yet support Oracle     |

* * *

## Documentation

View the full documentation. *Learning path coming soon!*

[Oracle Database integration](https://grafana.com/docs/grafana-cloud/monitor-infrastructure/integrations/integration-reference/integration-oracledb/)
