Skip to content

[DOC-14397]: DOC: Application Telemetry needs additional info.#4123

Open
RayOffiah wants to merge 2 commits into
release/8.0from
DOC-14397--8.0--Application-Telemetry-needs-additional-info
Open

[DOC-14397]: DOC: Application Telemetry needs additional info.#4123
RayOffiah wants to merge 2 commits into
release/8.0from
DOC-14397--8.0--Application-Telemetry-needs-additional-info

Conversation

@RayOffiah RayOffiah self-assigned this Jun 3, 2026
@RayOffiah RayOffiah added the enhancement New feature or request label Jun 3, 2026
@RayOffiah RayOffiah requested review from Copilot, ggray-cb and hyunjuV June 3, 2026 09:22

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds more guidance on enabling Couchbase Server application telemetry and surfaces a new navigation link from the metrics reference to the application telemetry documentation.

Changes:

  • Added an “Enabling telemetry” IMPORTANT callout with example curl commands and SDK tracing links.
  • Added an “Application Telemetry” link entry to the metrics reference index.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
modules/rest-api/pages/application-telemetry.adoc Adds an IMPORTANT block documenting how to check/enable telemetry and where to find SDK tracing guidance.
modules/metrics-reference/pages/metrics-reference.adoc Adds a new link entry referencing the application telemetry documentation from the metrics reference page.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread modules/rest-api/pages/application-telemetry.adoc Outdated
Comment thread modules/rest-api/pages/application-telemetry.adoc
Comment thread modules/rest-api/pages/application-telemetry.adoc
Comment thread modules/metrics-reference/pages/metrics-reference.adoc

@ggray-cb ggray-cb left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!

@RayOffiah RayOffiah requested review from avsej and programmatix June 10, 2026 11:34

@avsej avsej left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good, only couple of markup fixes. And also I am not sure what is the accepted format for hostname in cURL snippets, personally I like how one of your examples used placeholders which got highlighted with yellow, but maybe the other variant with just localhost:8091 is more copy/paste friendly. But they must be consistent throughout the document, I believe


[source, bash]
----
curl -u Administrator:password -X GET http://localhost:8091/settings/appTelemetry | jq

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
curl -u Administrator:password -X GET http://localhost:8091/settings/appTelemetry | jq
curl -u Administrator:password -X GET http://##{host}##:##{port}##/settings/appTelemetry | jq

[source, bash]
----
curl -u Administrator:password -X POST \
http://localhost:8091/settings/appTelemetry \

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
http://localhost:8091/settings/appTelemetry \
http://##{host}##:##{port}##/settings/appTelemetry \

Comment thread modules/metrics-reference/pages/application-telemetry-metrics.adoc
Comment thread modules/metrics-reference/pages/application-telemetry-metrics.adoc
Comment thread modules/metrics-reference/pages/application-telemetry-metrics.adoc Outdated
Comment thread modules/metrics-reference/pages/application-telemetry-metrics.adoc Outdated
Added diagram and section for the histograms.
Made corrections following the Copilot review
Added more information on application telemetry to application-telemetry.adoc
Added link to the new information on metrics-reference.adoc
@RayOffiah RayOffiah force-pushed the DOC-14397--8.0--Application-Telemetry-needs-additional-info branch from 9dbff60 to 89f1f3b Compare June 12, 2026 10:15
Minor corrections
Moved note on observability tracing to its own section.

Signed-off-by: Ray Offiah <ray.offiah@couchbase.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants