Skip to content

[Oracle OTel] Add content pack#17874

Merged
muthu-mps merged 6 commits intoelastic:mainfrom
agithomas:issue-integrations-908-oracle-otel-contentpack-v2
Apr 8, 2026
Merged

[Oracle OTel] Add content pack#17874
muthu-mps merged 6 commits intoelastic:mainfrom
agithomas:issue-integrations-908-oracle-otel-contentpack-v2

Conversation

@agithomas
Copy link
Copy Markdown
Contributor

  • Enhancement

Proposed commit message

Add Oracle Database OpenTelemetry content pack providing dashboards,
alert rules, and SLO templates for monitoring Oracle via the
oracledbreceiver.

WHAT:

  • 6 dashboards: Overview, Resource Capacity/Sessions/Locking, SQL Execution/I/O/Cache, Transaction Health/Storage, Active Query Analysis (ASH-equivalent), Query Performance & Plans (AWR-equivalent)
  • 10 alert rule templates covering process/session/tablespace/lock utilisation, buffer cache hit ratio, hard parse ratio, rollback
    ratio, and enqueue deadlocks
  • 6 SLO templates (timeslice-based, 99.5% over rolling 30 days) for process utilisation, session utilisation, buffer cache hit ratio, hard parse ratio, rollback-to-commit ratio, and zero deadlocks
  • Dashboard YAML sources in _dev/shared/kibana
  • Customer-facing README with optional metrics configuration, query event setup, and troubleshooting

WHY:
Oracle Database is widely used in enterprise environments and lacks OTel-native observability content in Elastic. This pack gives SREs immediate visibility into Oracle health using the oracledbreceiver
without requiring manual dashboard/alert creation.

Checklist

  • I have reviewed tips for building integrations and this pull request is aligned with them.
  • I have verified that all data streams collect metrics or logs.
  • I have added an entry to my package's changelog.yml file.
  • I have verified that Kibana version constraints are current according to guidelines.
  • I have verified that any added dashboard complies with Kibana's Dashboard good practices

Author's Checklist

  • Integration tests using Oracledbreceiver

How to test this PR locally

  • elastic-package build && elastic-package stack up -v -d --services package-registry
  • Configure the receiver following the settings mentioned in the README.

Screenshots

Overview dashboard

oracle_otel-overview

SQL Execution dashboard

oracle_otel-sql-execution

Transaction health

oracle_otel-transaction-health

Active query analysis

oracle-otel-active-query-analysis

Query performance

oracle-otel-query-performance

Oracle resource capacity

oracle_otel-resource-capacity

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 18, 2026

Vale Linting Results

Summary: 8 warnings, 7 suggestions found

⚠️ Warnings (8)
File Line Rule Message
packages/oracle_otel/docs/README.md 5 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'using' instead of 'via'.
packages/oracle_otel/docs/README.md 156 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
packages/oracle_otel/docs/README.md 163 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
packages/oracle_otel/docs/README.md 255 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
packages/oracle_otel/docs/README.md 256 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
packages/oracle_otel/docs/README.md 270 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'for example' instead of 'e.g'.
packages/oracle_otel/docs/README.md 274 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'and so on' instead of 'etc'.
packages/oracle_otel/docs/README.md 288 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'and so on' instead of 'etc'.
💡 Suggestions (7)
File Line Rule Message
packages/oracle_otel/docs/README.md 84 Elastic.WordChoice Consider using 'deactivated, deselected, hidden, turned off, unavailable' instead of 'disabled', unless the term is in the UI.
packages/oracle_otel/docs/README.md 201 Elastic.Semicolons Use semicolons judiciously.
packages/oracle_otel/docs/README.md 238 Elastic.WordChoice Consider using 'select, press, visits' instead of 'hit', unless the term is in the UI.
packages/oracle_otel/docs/README.md 257 Elastic.WordChoice Consider using 'select, press, visits' instead of 'hit', unless the term is in the UI.
packages/oracle_otel/docs/README.md 257 Elastic.WordChoice Consider using 'select, press, visits' instead of 'hit', unless the term is in the UI.
packages/oracle_otel/docs/README.md 270 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.
packages/oracle_otel/docs/README.md 288 Elastic.WordChoice Consider using 'can, might' instead of 'may', unless the term is in the UI.

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@andrewkroh andrewkroh added New Integration Issue or pull request for creating a new integration package. dashboard Relates to a Kibana dashboard bug, enhancement, or modification. documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. labels Mar 18, 2026
@elasticmachine
Copy link
Copy Markdown

💚 Build Succeeded

History

@agithomas agithomas marked this pull request as ready for review March 25, 2026 11:37
@agithomas agithomas requested a review from a team as a code owner March 25, 2026 11:37
@muthu-mps muthu-mps merged commit ecf6758 into elastic:main Apr 8, 2026
12 checks passed
@elastic-vault-github-plugin-prod
Copy link
Copy Markdown

Package oracle_otel - 0.1.0 containing this change is available at https://epr.elastic.co/package/oracle_otel/0.1.0/

@andrewkroh andrewkroh added the Integration:oracle_otel Oracle OpenTelemetry Assets label Apr 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dashboard Relates to a Kibana dashboard bug, enhancement, or modification. documentation Improvements or additions to documentation. Applied to PRs that modify *.md files. Integration:oracle_otel Oracle OpenTelemetry Assets New Integration Issue or pull request for creating a new integration package.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants