DOC-14039 flakey node metric documentation for Totoro#4102
Merged
Conversation
* DOC-14105-Update Compatibility matrix to include 8.0 * DOC-13116 Changing installer name caused issues https://jira.issues.couchbase.com/browse/DOC-13116 Adding a note that changing CB installer name can cause issues * Updated non-root.adoc https://jira.issues.couchbase.com/browse/DOC-13116 Added a note that changing the file name will cause errors * Updated non-root.adoc Updated the note * deleted 8.0 which was added by mistake
* Partial drafts of the concecptual and procedural doc pages. * Added screen shots. * Updated metrics to get the new metric. * Forward ported change to the metrics template to add anchors to the entries in the metric reference.
|
@stevewatanabe Can you please review this addition? Thanks |
Member
|
A couple of minor comments. Otherwise looks good. |
* Fixed missing space after a link to the metric that Steve spotted. * Some misc, grammar fixes.
There was a problem hiding this comment.
Pull request overview
This PR adds end-user documentation for detecting and investigating unstable Couchbase nodes using the new cm_node_unreachable_total metric, and wires the new content into the docs nav and metrics reference.
Changes:
- Added new concept + guide docs explaining unstable nodes and how to monitor them via
cm_node_unreachable_total. - Added/updated metrics metadata (including
cm_node_unreachable_total) and adjusted metrics reference rendering to link metric names. - Updated troubleshooting and availability docs to reference the new unstable-node guidance, and updated nav/What’s New content.
Reviewed changes
Copilot reviewed 16 out of 18 changed files in this pull request and generated 15 comments.
Show a summary per file
| File | Description |
|---|---|
| modules/metrics-reference/partials/metrics.hbs | Adds anchors to metric rows so metrics can be deep-linked. |
| modules/metrics-reference/attachments/cm_metrics_metadata.json | Adds cm_node_unreachable_total and additional CM/couch view metrics metadata. |
| modules/manage/pages/troubleshoot/common-errors.adoc | Adds a “Unstable Nodes” common error entry and links to the new concept page. |
| modules/manage/pages/monitor/set-up-prometheus-for-monitoring.adoc | Adds :page-topic-type: metadata. |
| modules/manage/pages/monitor/monitor-node-stability.adoc | New guide describing Prometheus + REST API approaches to monitoring node instability. |
| modules/learn/pages/clusters-and-availability/unstable-nodes.adoc | New concept page defining unstable nodes and explaining metric labels/reasons. |
| modules/learn/pages/clusters-and-availability/failover.adoc | Adds a section explaining unstable nodes in the context of failover expectations. |
| modules/introduction/pages/whats-new.adoc | Updates What’s New page to reference 8.1 content/partials. |
| modules/introduction/partials/new-features-81.adoc | New 8.1 partial including a What’s New entry for the unstable-node metric. |
| modules/introduction/partials/new-features-80.adoc | Removes the 8.0 partial previously included by What’s New. |
| modules/ROOT/nav.adoc | Adds nav entries for the new unstable-node pages and monitor guide. |
| modules/metrics-reference/attachments/kv_metrics_metadata.json | Adds/renames multiple KV metrics and updates some KV metric help text. |
| modules/metrics-reference/attachments/index_metrics_metadata.json | Adds new index metrics for lost replicas. |
| modules/metrics-reference/attachments/n1ql_metrics_metadata.json | Adds a new N1QL metric entry. |
| modules/metrics-reference/attachments/goxdcr_metrics_metadata.json | Adds multiple XDCR metrics entries. |
| modules/metrics-reference/attachments/fts_metrics_metadata.json | Adds multiple FTS runtime metrics entries and updates one help string. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| @@ -1,18 +1,18 @@ | |||
| = What's New in Version 8.0 | |||
| = What's New in Version 8.1 | |||
Contributor
There was a problem hiding this comment.
Shouldn't 8.1 info be merged into release/8.1 branch, @ggray-cb ?
Contributor
Author
There was a problem hiding this comment.
You're right. I retargeted to 8.1.
ggray-cb
added a commit
that referenced
this pull request
Apr 17, 2026
Adds documentation for the cm_node_unreachable_total metric. The following list summarizes the changes, with links to the preview site. You will need the Docs Team credentials on Confluence. * Added a What's New entry. * Added a new conceptual page: Unstable Nodes. * Added a new guide page: Monitor Node Stability. * Added a new entry in the Common Errors page. * Added a new section in Failover that describes unstable nodes. This is more to catch the "why isn't this node failing over?" sort of questions. (cherry picked from commit 27ba654)
ggray-cb
added a commit
that referenced
this pull request
Apr 17, 2026
* DOC-14039 flakey node metric documentation for Totoro (#4102) Adds documentation for the cm_node_unreachable_total metric. The following list summarizes the changes, with links to the preview site. You will need the Docs Team credentials on Confluence. * Added a What's New entry. * Added a new conceptual page: Unstable Nodes. * Added a new guide page: Monitor Node Stability. * Added a new entry in the Common Errors page. * Added a new section in Failover that describes unstable nodes. This is more to catch the "why isn't this node failing over?" sort of questions. (cherry picked from commit 27ba654)
ggray-cb
added a commit
that referenced
this pull request
Apr 21, 2026
) Adds documentation for the cm_node_unreachable_total metric. The following list summarizes the changes, with links to the preview site. You will need the Docs Team credentials on Confluence. * Added a What's New entry. * Added a new conceptual page: Unstable Nodes. * Added a new guide page: Monitor Node Stability. * Added a new entry in the Common Errors page. * Added a new section in Failover that describes unstable nodes. This is more to catch the "why isn't this node failing over?" sort of questions. (cherry picked from commit 27ba654)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds documentation for the
cm_node_unreachable_totalmetric.The following list summarizes the changes, with links to the preview site. You will need the Docs Team credentials on Confluence.
NOTE: These changes will be backported to 7.6.11 and 8.0.2.