Skip to content

Commit 9df7bd5

Browse files
committed
updated feedback comments and fixed image syntax error
1 parent 0a6e91d commit 9df7bd5

File tree

3 files changed

+17
-16
lines changed

3 files changed

+17
-16
lines changed

articles/operator-nexus/includes/contact-support.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
author: omarrivera
33
ms.author: omarrivera
4-
ms.date: 04/28/2025
4+
ms.date: 07/02/2025
55
ms.topic: include
66
ms.service: azure-operator-nexus
77
---

articles/operator-nexus/troubleshoot-cluster-heartbeat-connection-status-disconnected.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,42 +11,43 @@ author: omarrivera
1111

1212
# Troubleshoot Cluster heartbeat connection status shows disconnected
1313

14-
This guide attempts to provide steps to troubleshoot a Cluster with a `ClusterConnectionStatus` in `Disconnected` state.
14+
This guide describes steps to troubleshoot a Cluster with a `ClusterConnectionStatus` in `Disconnected` state.
1515
For a Cluster, the `ClusterConnectionStatus` represents the stability in the connection between the on-premises Cluster and its ability to reach the Cluster Manager.
1616

1717
> [!IMPORTANT]
1818
> The `ClusterConnectionStatus` **doesn't** represent or is related to the health or connectivity of the Arc Connected Kubernetes Cluster.
1919
> The `ClusterConnectionStatus` indicates that the Cluster is successful in sending heartbeats and receiving acknowledgment from the Cluster Manager.
2020
21-
[!include[prereqAzCLI](./includes/baremetal-machines/prerequisites-azure-cli-bare-metal-machine-actions.md)]
21+
![prereqAzCLI](./includes/baremetal-machines/prerequisites-azure-cli-bare-metal-machine-actions.md)]
2222

2323
## Understanding the Cluster connection status signal
2424

2525
The `ClusterConnectionStatus` represents the ability of the on-premises Cluster to send heartbeats and receive acknowledgments from the Cluster Manager, indicating the health of the network connection between them.
26-
`ClusterConnectionStatus` distinct from the connectivity of the Arc Connected Kubernetes Cluster, though network issues affect both.
26+
`ClusterConnectionStatus` is distinct from the connectivity of the Arc Connected Kubernetes Cluster, though network issues affect both.
2727

28-
A Cluster resource has the property `ClusterConnectionStatus` set to the value `Connected` as the heartbeats are continuously received and acknowledged.
28+
A Cluster resource has the property `ClusterConnectionStatus` set to the value `Connected` if the heartbeats are continuously received and acknowledged.
2929
The `ClusterConnectionStatus` becomes `Connected` once the Cluster is in a healthy state and network connectivity issues are resolved.
3030
The Cluster shows `Timeout` only as a transitional state between `Connected` and `Disconnected`.
31-
The Cluster `ClusterConnectionStatus` value becomes `Disconnected` as Cluster Manager detects continuously missed heartbeats.
32-
Once the cluster is a healthy state and there no network connectivity issues, the `ClusterConnectionStatus` automatically moves to `Connected`
31+
The Cluster `ClusterConnectionStatus` value becomes `Disconnected` if the Cluster Manager detects continuously missed heartbeats.
32+
Heartbeats are considered missed if they aren't received within or beyond the specified time thresholds.
33+
Once the Cluster is a healthy state and there no network connectivity issues, the `ClusterConnectionStatus` automatically moves to `Connected`
3334

34-
During the Cluster deployment process, the Cluster is in `Undefined` state until the Cluster is fully deployed and operational.
35+
During the Cluster deployment process, the Cluster is in an `Undefined` state until the Cluster is fully deployed and operational.
3536

3637
The following table shows the possible values of `ClusterConnectionStatus` and their definitions:
3738

3839
| Status | Definition |
3940
|----------------|-----------------------------------------------------------------------------------------------------------------------|
40-
| `Connected` | Heartbeats received, indicates healthy cluster and cluster manager connectivity |
41+
| `Connected` | Heartbeats received, indicates healthy Cluster and Cluster Manager connectivity |
4142
| `Disconnected` | Heartbeats missed for **over 5 minutes**, indicates likely connectivity issue between Cluster Manager and Cluster |
42-
| `Timeout` | Heartbeats missed for **over 2 minutes but less than 5 minutes**, cluster connectivity is uncertain possibly degraded |
43+
| `Timeout` | Heartbeats missed for **over 2 minutes but less than 5 minutes**, Cluster connectivity is uncertain possibly degraded |
4344
| `Undefined` | Cluster not yet deployed or running a version without the heartbeats feature |
4445

4546
## Check the value of the Cluster's ClusterConnectionStatus property
4647

4748
The value of `ClusterConnectionStatus` is visible in the Azure portal in the Cluster resource view.
4849

49-
[!include[ClusterConnectionStatus](./media/troubleshoot-cluster-heartbeat-connection-status/az-portal-cluster-connection-status.png)]
50+
![ClusterConnectionStatus](./media/troubleshoot-cluster-heartbeat-connection-status/az-portal-cluster-connection-status.png)
5051

5152
Or, you can use the Azure CLI to see the value of `ClusterConnectionStatus`:
5253

@@ -65,7 +66,7 @@ Connected
6566

6667
## Understanding the NexusClusterConnectionStatus metric
6768

68-
Use Azure Resource Health to build alerts for cluster health, as it provides a comprehensive and supported view of resource status.
69+
Use Azure Resource Health to build alerts for Cluster health, as it provides a comprehensive and supported view of resource status.
6970
The `NexusClusterConnectionStatus` metric integrates into the Cluster's Azure Resource Health.
7071
If you use the `NexusClusterConnectionStatus` metric directly, understand how it functions and what it represents.
7172

@@ -76,13 +77,13 @@ The metric emitting process never sends "0" values. Any "0" values seen in graph
7677
The detection of state changes requires the Cluster Manager's reconciliation process to update the Cluster resource's `ClusterConnectionStatus` property accordingly.
7778

7879
There might be a delay between the actual loss of heartbeats and the metric reflecting the `Disconnected` state, due to the reconciliation loop and other operational factors.
79-
The `NexusClusterConnectionStatus` metric is used as a health indicator for the cluster, but delays in status changes can occur due to reconciliation timing and operational constraints.
80+
The `NexusClusterConnectionStatus` metric is used as a health indicator for the Cluster, but delays in status changes can occur due to reconciliation timing and operational constraints.
8081
Timeout events can occur if heartbeats aren't received within a 2-minute threshold, but a single successful heartbeat resets the timer.
8182
The status can transition between Connected, Timeout, and `Disconnected` based on heartbeat activity.
8283

8384
The image shows a general representation of the components responsible for emitting the `NexusClusterConnectionStatus` metric.
8485

85-
[!include[ClusterHeartbeatComponents](./media/troubleshoot-cluster-heartbeat-connection-status/cluster-connection-status-components-for-metric.png)]
86+
![ClusterHeartbeatComponents](./media/troubleshoot-Cluster-heartbeat-connection-status/cluster-connection-status-components-for-metric.png)
8687

8788
### ClusterConnectionStatus isn't the same as Arc Connected Cluster status
8889

articles/operator-nexus/troubleshoot-control-plane-quorum.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
title: Troubleshoot control plane quorum loss when multiple nodes are offline
33
description: Learn how to restore control plane quorum loss when multiple nodes are offline.
44
ms.topic: article
5-
ms.date: 01/18/2024
6-
author: matthewernst
5+
ms.date: 07/02/2025
76
ms.author: matthewernst
7+
author: matternst7258
88
ms.service: azure-operator-nexus
99
---
1010

0 commit comments

Comments
 (0)