add RavenDB integration by TheGoldenPlatypus · Pull Request #2960 · DataDog/integrations-extras

TheGoldenPlatypus · 2026-04-06T09:19:08Z

What does this PR do?

Adds a new integration for RavenDB using the OpenMetrics endpoint.
The integration collects server, cluster, database, index, and GC metrics from RavenDB and exposes them to Datadog. It also includes configurable filtering to control metric cardinality and a sample dashboard for visualization.

Motivation

RavenDB exposes Prometheus/OpenMetrics metrics, but there is currently no official Datadog integration.
This integration allows users to monitor RavenDB instances directly through Datadog without needing custom metric pipelines, while also providing controls to avoid high-cardinality metric ingestion.

Review checklist

PR has a meaningful title or PR has the no-changelog label attached
Feature or bugfix has tests
Git history is clean
If PR impacts documentation, docs team has been notified or an issue has been opened on the documentation repo
If this PR includes a log pipeline, please add a description describing the remappers and processors.

Additional Notes

--

TheGoldenPlatypus · 2026-04-09T10:45:09Z

the manifest validation is failing because source_type_id is required and must be unique
I don't have it, assumed the scaffolding should take care of assigning one.
Could you reviewers assign the correct source_type_id ?

{'assets': {'integration': {'source_type_id': ['Missing data for required field.']}}}

github-actions · 2026-05-05T21:39:37Z

This pull request has not been updated for more than 21 days. If there are no updates to this PR within 7 days, it will be closed. If you'd like to re-open this PR after it's been closed, you can start from the latest master branch or pull the latest changes into your branch and create a new pull request.

TheGoldenPlatypus · 2026-05-07T10:09:23Z

hey, following up on this PR as it's close to becoming stale. Any update or feedback from the team?

github-actions · 2026-05-28T21:59:01Z

This pull request has not been updated for more than 21 days. If there are no updates to this PR within 7 days, it will be closed. If you'd like to re-open this PR after it's been closed, you can start from the latest master branch or pull the latest changes into your branch and create a new pull request.

TheGoldenPlatypus · 2026-06-02T12:34:33Z

hey, following up on this PR as it's close to becoming stale. Any update or feedback from the team?

github-actions · 2026-06-24T21:49:16Z

This pull request has not been updated for more than 21 days. If there are no updates to this PR within 7 days, it will be closed. If you'd like to re-open this PR after it's been closed, you can start from the latest master branch or pull the latest changes into your branch and create a new pull request.

TheGoldenPlatypus · 2026-06-25T09:21:28Z

hey, following up on this PR as it's close to becoming stale. Any update or feedback from the team?

github-actions · 2026-07-17T21:35:29Z

This pull request has not been updated for more than 21 days. If there are no updates to this PR within 7 days, it will be closed. If you'd like to re-open this PR after it's been closed, you can start from the latest master branch or pull the latest changes into your branch and create a new pull request.

TheGoldenPlatypus · 2026-07-19T20:28:35Z

hey, following up on this PR as it's close to becoming stale. Any update or feedback from the team?

estherk15

Can you take another look at the link references? There were a few orphaned links and some inline reference links that don't match formatting.

estherk15 · 2026-07-28T20:13:27Z

+1. Install the [developer toolkit]
+(https://docs.datadoghq.com/developers/integrations/python/)


Can you format this as a reference link at the bottom of the file?

Suggested change

1. Install the [developer toolkit]

(https://docs.datadoghq.com/developers/integrations/python/)

1. Install the [developer toolkit](https://docs.datadoghq.com/developers/integrations/python/)

estherk15 · 2026-07-28T20:16:57Z

+Run the Agent's status subcommand and look for 'ravendb' under the Checks section.
+
+
+## Data Collected


This is missing a Logs subsection describing what log types are collected, and a Service checks subsection linking to service_checks.json.

estherk15 · 2026-07-29T14:14:51Z

+
+## Troubleshooting
+
+Need help? Contact the support@ravendb.net of this integration.


Suggested change

Need help? Contact the support@ravendb.net of this integration.

Need help? Contact [RavenDB's support team][10].

estherk15 · 2026-07-29T14:15:47Z

+
+### Validation
+
+Run the Agent's status subcommand and look for 'ravendb' under the Checks section.


Suggested change

Run the Agent's status subcommand and look for 'ravendb' under the Checks section.

Run the [Agent's status subcommand][6] and look for `ravendb` under the Checks section.

estherk15 · 2026-07-29T14:16:55Z

+- [A running RavenDB server (single node or cluster)](https://docs.ravendb.net/start/getting-started)
+- [A valid RavenDB license](https://ravendb.net/buy)


Can you move these links to the bottom of the page and use reference link format?

estherk15 · 2026-07-29T14:21:18Z

+[6]: https://docs.datadoghq.com/agent/configuration/agent-commands/#agent-status-and-information
+[7]: https://github.com/DataDog/integrations-extras/blob/master/ravendb/metadata.csv
+[9]: https://docs.datadoghq.com/help/
+


Suggested change

[10]: mailto:support@ravendb.net

estherk15 · 2026-07-29T14:22:41Z

+
+To collect RavenDB logs, enable log collection in datadog.yaml:
+
+logs_enabled: true


Suggested change

logs_enabled: true

```yaml

logs_enabled: true

```

estherk15 · 2026-07-29T14:26:17Z

+
+## Overview
+
+[RavenDB][1] is a NoSQL document-oriented database designed for high performance, scalability, and ease of use. It is optimized for handling JSON-based documents and supports advanced features like ACID transactions, full-text search, and automatic indexing. 


Suggested change

[RavenDB][1] is a NoSQL document-oriented database designed for high performance, scalability, and ease of use. It is optimized for handling JSON-based documents and supports advanced features like ACID transactions, full-text search, and automatic indexing.

[RavenDB][1] is a NoSQL document-oriented database designed for high performance, scalability, and ease of use. It is optimized for handling JSON-based documents and supports advanced features such as ACID transactions, full-text search, and automatic indexing.

estherk15 · 2026-07-29T14:28:22Z

+
+#### Metric collection
+
+1. RavenDB is exposing metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format  at an administrative endpoint: `/admin/monitoring/v1/prometheus`.


Suggested change

1. RavenDB is exposing metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format at an administrative endpoint: `/admin/monitoring/v1/prometheus`.

1. RavenDB exposes metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format at an administrative endpoint: `/admin/monitoring/v1/prometheus`.

estherk15 · 2026-07-29T14:29:08Z

+
+1. RavenDB is exposing metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format  at an administrative endpoint: `/admin/monitoring/v1/prometheus`.
+
+2. Edit the `ravendb/conf.yaml` file in the `conf.d/` directory of the Datadog Agent. See the [sample ravendb/conf.yaml][4] for all available configuration options.


Suggested change

2. Edit the `ravendb/conf.yaml` file in the `conf.d/` directory of the Datadog Agent. See the [sample ravendb/conf.yaml][4] for all available configuration options.

2. Edit the `ravendb/conf.yaml` file in the `conf.d/` directory of the Datadog Agent. For all available configuration option, see the [sample ravendb/conf.yaml][4].

add ravendb integration

1ecec1c

TheGoldenPlatypus requested review from a team as code owners April 6, 2026 09:19

TheGoldenPlatypus added 2 commits April 6, 2026 17:16

linting, updating manifest.json and README.md

f1b9fe2

update CODEOWNERS and CI codecov

1b1d6e6

TheGoldenPlatypus requested a review from a team as a code owner April 6, 2026 14:18

TheGoldenPlatypus added 2 commits April 6, 2026 17:42

linting, update image aspect ratio and metadata.csv

493d370

fix typo in CODEOWNERS

6aa74e0

estherk15 added the editorial review Waiting on a more in-depth review from a docs team editor label Apr 6, 2026

TheGoldenPlatypus added 4 commits April 9, 2026 10:36

update py target on hatch.toml

1f77c1a

restore CI workflow to upstream state

9091e99

sync RavenDB config example

b4dbb9e

sync RavenDB config models

76195ae

TheGoldenPlatypus changed the title ~~add ravendb integration~~ add RavenDB integration Apr 14, 2026

github-actions Bot added the stale label May 5, 2026

github-actions Bot removed the stale label May 7, 2026

github-actions Bot added the stale label May 28, 2026

github-actions Bot removed the stale label Jun 2, 2026

github-actions Bot added the stale label Jun 24, 2026

github-actions Bot removed the stale label Jun 25, 2026

github-actions Bot added the stale label Jul 17, 2026

github-actions Bot removed the stale label Jul 19, 2026

estherk15 reviewed Jul 29, 2026

View reviewed changes

		1. Install the [developer toolkit]
		(https://docs.datadoghq.com/developers/integrations/python/)

	1. Install the [developer toolkit]
	(https://docs.datadoghq.com/developers/integrations/python/)
	1. Install the [developer toolkit](https://docs.datadoghq.com/developers/integrations/python/)

		Run the Agent's status subcommand and look for 'ravendb' under the Checks section.


		## Data Collected


		## Troubleshooting

		Need help? Contact the support@ravendb.net of this integration.

	Need help? Contact the support@ravendb.net of this integration.
	Need help? Contact [RavenDB's support team][10].


		### Validation

		Run the Agent's status subcommand and look for 'ravendb' under the Checks section.

	Run the Agent's status subcommand and look for 'ravendb' under the Checks section.
	Run the [Agent's status subcommand][6] and look for `ravendb` under the Checks section.

		- [A running RavenDB server (single node or cluster)](https://docs.ravendb.net/start/getting-started)
		- [A valid RavenDB license](https://ravendb.net/buy)


		To collect RavenDB logs, enable log collection in datadog.yaml:

		logs_enabled: true


		## Overview

		[RavenDB][1] is a NoSQL document-oriented database designed for high performance, scalability, and ease of use. It is optimized for handling JSON-based documents and supports advanced features like ACID transactions, full-text search, and automatic indexing.


		#### Metric collection

		1. RavenDB is exposing metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format at an administrative endpoint: `/admin/monitoring/v1/prometheus`.

	1. RavenDB is exposing metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format at an administrative endpoint: `/admin/monitoring/v1/prometheus`.
	1. RavenDB exposes metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format at an administrative endpoint: `/admin/monitoring/v1/prometheus`.


		1. RavenDB is exposing metrics in [Prometheus/OpenMetrics](https://docs.ravendb.net/server/administration/monitoring/prometheus/) format at an administrative endpoint: `/admin/monitoring/v1/prometheus`.

		2. Edit the `ravendb/conf.yaml` file in the `conf.d/` directory of the Datadog Agent. See the [sample ravendb/conf.yaml][4] for all available configuration options.

Uh oh!

Conversation

TheGoldenPlatypus commented Apr 6, 2026

What does this PR do?

Motivation

Review checklist

Additional Notes

Uh oh!

TheGoldenPlatypus commented Apr 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

TheGoldenPlatypus commented May 7, 2026

Uh oh!

github-actions Bot commented May 28, 2026

Uh oh!

TheGoldenPlatypus commented Jun 2, 2026

Uh oh!

github-actions Bot commented Jun 24, 2026

Uh oh!

TheGoldenPlatypus commented Jun 25, 2026

Uh oh!

github-actions Bot commented Jul 17, 2026

Uh oh!

TheGoldenPlatypus commented Jul 19, 2026

Uh oh!

estherk15 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

estherk15 Jul 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

TheGoldenPlatypus commented Apr 9, 2026 •

edited

Loading

estherk15 Jul 29, 2026 •

edited

Loading