ClusterHealthPolicy.NodeTypeHealthPolicyMap Property

Definition

Namespace:

System.Fabric.Health

Assembly:

System.Fabric.dll

Package:

Microsoft.ServiceFabric v9.1.1833

Gets the map with MaxPercentUnhealthyNodes per node type name.

public System.Fabric.Health.NodeTypeHealthPolicyMap NodeTypeHealthPolicyMap { get; set; }

member this.NodeTypeHealthPolicyMap : System.Fabric.Health.NodeTypeHealthPolicyMap with get, set

Public Property NodeTypeHealthPolicyMap As NodeTypeHealthPolicyMap

Property Value

NodeTypeHealthPolicyMap

The node type health policy map with MaxPercentUnhealthyNodes per node type name.

Remarks

The node type health policy map can be used during cluster health evaluation to describe special node types. For example, in a cluster there are hundreds of nodes of different types, and a few control node instances of a special node type. The control nodes should never be in error. So users can specify global MaxPercentUnhealthyNodes to 20% to tolerate some failures, but for the node type "ControlNodeType" set the MaxPercentUnhealthyNodes to 0. This way, if some of the many nodes are unhealthy, but below the global unhealthy percentage, the cluster would be evaluated to Warning. A warning health state does not impact cluster upgrade or other monitoring triggered by Error health state. But even one control node in error would make cluster health error, which can rollback or prevent a cluster upgrade.

>

To define entries for the specific node types in the cluster manifest, inside FabricSettings add entries for parameters with name formed by prefix "NodeTypeMaxPercentUnhealthyNodes-" followed by node type name.

If no policy is specified for an node type, the default MaxPercentUnhealthyNodes is used for evaluation.

The node type health evaluation is done only when the cluster is configured with EnableNodeTypeHealthEvaluation true. The setting is disabled by default.

Please note that defining node type specific health policies do not impact the evaluation of MaxPercentUnhealthyNodes; no nodes are taken out of the global evaluation pool, and they are health checks run independently of each other.