topic Re: Couchbase extension v2.2.0 versus oneagent in Extensions

Couchbase extension v2.2.0 versus oneagent

tesp11331 — Mon, 28 Jul 2025 12:24:55 GMT

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

Re: Couchbase extension v2.2.0 versus oneagent

ben_davidson — Tue, 29 Jul 2025 01:10:37 GMT

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.

Re: Couchbase extension v2.2.0 versus oneagent

khaled_beshir — Tue, 29 Jul 2025 12:18:50 GMT

Set up monitoring

Virtual machine

If your Couchbase is running on a virtual machine directly, you will need to install OneAgent on that virtual machine to get started.

Kubernetes workload

If your Couchbase is running as a workload in Kubernetes, please refer to the Kubernetes deployment start guide.

Openshift workload

If your Couchbase is running as a workload in OpenShift, please refer to the OpenShift deployment start guide.

OpenTelemetry

If you are instrumenting Couchbase with OpenTelemetry then:

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).
Instrument the java client with OpenTelemetry.
Ensure to store the span attributes.