[DOC-14397]: DOC: Application Telemetry needs additional info.#4123
[DOC-14397]: DOC: Application Telemetry needs additional info.#4123RayOffiah wants to merge 2 commits into
Conversation
There was a problem hiding this comment.
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
curlcommands 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.
avsej
left a comment
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
| 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 \ |
There was a problem hiding this comment.
| http://localhost:8091/settings/appTelemetry \ | |
| http://##{host}##:##{port}##/settings/appTelemetry \ |
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
9dbff60 to
89f1f3b
Compare
Minor corrections Moved note on observability tracing to its own section. Signed-off-by: Ray Offiah <ray.offiah@couchbase.com>
Added detailed information on enabling application telemetry.
Added a link for the application telemetry page to the metrics reference.
preview URLs
https://preview.docs-test.couchbase.com/docs-server-DOC-14397--8.0--Application-Telemetry-needs-additional-info/server/current/rest-api/application-telemetry.html
https://preview.docs-test.couchbase.com/docs-server-DOC-14397--8.0--Application-Telemetry-needs-additional-info/server/current/metrics-reference/application-telemetry-metrics.html
https://preview.docs-test.couchbase.com/docs-server-DOC-14397--8.0--Application-Telemetry-needs-additional-info/server/current/metrics-reference/metrics-reference.html