# Couchbase extension v2.2.0 versus oneagent

**URL:** <https://community.dynatrace.com/t/couchbase-extension-v2-2-0-versus-oneagent/52670>\
**Category:** Extensions\
**Tags:** extensions\
**Created:** [July 28, 2025, 12:24pm UTC](https://community.dynatrace.com/t/couchbase-extension-v2-2-0-versus-oneagent/52670 "2025-07-28T12:24:55Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![tesp11331](https://avatars.discourse-cdn.com/v4/letter/t/919ad9/32.png) [@tesp11331](https://community.dynatrace.com/u/tesp11331)\
**Post date:** [July 28, 2025, 12:24pm UTC](https://community.dynatrace.com/t/couchbase-extension-v2-2-0-versus-oneagent/52670/1 "2025-07-28T12:24:55Z")

</div>

Hi All,

we are monitoring our Cuchbase cluster with the extension v2.2.0 by using an active gate.

Do we need also the oneagent installed on all the machines of the cluster or only on one ?

Thanks

Regards

Pasquale

---

<div class="post-metadata">

**Author:** ![ben\_davidson](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/ben_davidson/32/20391_2.png) [@ben\_davidson](https://community.dynatrace.com/u/ben_davidson)\
**Post date:** [July 29, 2025, 1:10am UTC](https://community.dynatrace.com/t/couchbase-extension-v2-2-0-versus-oneagent/52670/2 "2025-07-29T01:10:37Z")

</div>

If you are using the remote configuration of the extension (on an ActiveGate), a OneAgent is not required on the hosts. However, adding the OneAgent does have benefits. Besides all the regular benefits of having the OneAgent installed, the extension will add links and Couchbase specific metrics to the Couchbase processes.

---

<div class="post-metadata">

**Author:** ![khaled\_beshir](https://avatars.discourse-cdn.com/v4/letter/k/9de0a6/32.png) [@khaled\_beshir](https://community.dynatrace.com/u/khaled_beshir)\
**Post date:** [July 29, 2025, 12:18pm UTC](https://community.dynatrace.com/t/couchbase-extension-v2-2-0-versus-oneagent/52670/3 "2025-07-29T12:18:50Z")

</div>

### Set up monitoring

#### Virtual machine

If your Couchbase is running on a virtual machine directly, you will need to&nbsp;[install OneAgent](https://www.dynatrace.com/support/help/shortlink/oneagent-installation-subsection)&nbsp;on that virtual machine to get started.

#### Kubernetes workload

If your Couchbase is running as a workload in Kubernetes, please refer to the&nbsp;[Kubernetes deployment start guide](https://www.dynatrace.com/support/help/shortlink/kubernetes-hub).

#### Openshift workload

If your Couchbase is running as a workload in OpenShift, please refer to the&nbsp;[OpenShift deployment start guide](https://www.dynatrace.com/support/help/shortlink/openshift-hub).

#### OpenTelemetry

If you are instrumenting Couchbase with OpenTelemetry then:

1. Ensure that the OneAgent feature “OpenTelemetry Java Instrumentation agent support” is activated to get full tracing and metric insight (OneAgent version 1.237 or newer needed).
2. Instrument the java client with&nbsp;[OpenTelemetry](https://www.dynatrace.com/support/help/extend-dynatrace/opentelemetry/opentelemetry-traces/opentelemetry-ingest/opent-java-auto).
3. Ensure to store the&nbsp;[span attributes.](https://www.dynatrace.com/support/help/extend-dynatrace/extend-tracing/span-settings)
