Get-ServiceFabricClusterHealth

  • Référence
Module:
ServiceFabric

Obtient des informations d’intégrité pour un cluster Service Fabric.

Syntaxe

Get-ServiceFabricClusterHealth
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyApplications <Byte>]
   [-MaxPercentUnhealthyNodes <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ApplicationsHealthStateFilter <Int64>]
   [-ApplicationsFilter <HealthStateFilter>]
   [-NodesHealthStateFilter <Int64>]
   [-NodesFilter <HealthStateFilter>]
   [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
   [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
   [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
   [-IncludeSystemApplicationHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]
Get-ServiceFabricClusterHealth
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyApplications <Byte>]
   [-MaxPercentUnhealthyNodes <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ApplicationsHealthStateFilter <Int64>]
   [-ApplicationsFilter <HealthStateFilter>]
   [-NodesHealthStateFilter <Int64>]
   [-NodesFilter <HealthStateFilter>]
   [-ApplicationHealthPolicyMap <ApplicationHealthPolicyMap>]
   [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
   [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

L’applet de commande Get-ServiceFabricClusterHealth obtient des informations d’intégrité pour un cluster Service Fabric. Service Fabric signale les états d’intégrité suivants :

  • OK. L’entité répond aux instructions d’intégrité.
  • Erreur. L’entité ne répond pas aux instructions d’intégrité.
  • Avertissement. L’entité répond aux instructions d’intégrité, mais a rencontré un problème.

L’état d’intégrité agrégé du cluster prend en compte tous les rapports d’intégrité sur le cluster ainsi que l’état d’intégrité agrégé de tous les enfants, récursivement. L’évaluation d’intégrité utilise la stratégie d’intégrité du cluster et la stratégie d’intégrité de l’application de chaque application du cluster.

Avant d’effectuer une opération sur un cluster Service Fabric, établissez une connexion au cluster à l’aide de l’applet de commande Connect-ServiceFabricCluster .

Exemples

Exemple 1 : Obtenir l’intégrité du cluster et filtrer les enfants retournés

PS C:\> Get-ServiceFabricClusterHealth -NodesFilter Error -ApplicationsFilter 'Warning,Error'

Cette commande interroge l’intégrité du cluster. Il spécifie des filtres pour renvoyer uniquement les nœuds avec l’état d’intégrité Erreur et les applications avec avertissement ou erreur d’état d’intégrité.

Exemple 2 : Obtenir l’intégrité du cluster à l’aide de stratégies d’intégrité personnalisées

PS C:\> $defaultServiceTypeHealthPolicy = new-object -TypeName System.Fabric.Health.ServiceTypeHealthPolicy
$defaultServiceTypeHealthPolicy.MaxPercentUnhealthyPartitionsPerService = 20
$defaultServiceTypeHealthPolicy.MaxPercentUnhealthyServices = 10
$appHealthPolicy = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicy
$appHealthPolicy.ConsiderWarningAsError = $True
$appHealthPolicy.MaxPercentUnhealthyDeployedApplications = 20
$appHealthPolicy.DefaultServiceTypeHealthPolicy = $defaultServiceTypeHealthPolicy
$appHealthPolicyMap = New-Object -TypeName System.Fabric.Health.ApplicationHealthPolicyMap
$appUri1 = New-Object -TypeName System.Uri -ArgumentList "fabric:/app1"
$appHealthPolicyMap.Add($appUri1, $appHealthPolicy)
Get-ServiceFabricClusterHealth -ConsiderWarningAsError $True -MaxPercentUnhealthyNodes 10 -ApplicationHealthPolicyMap $appHealthPolicyMap

Cette commande interroge l’intégrité du cluster et passe dans des stratégies personnalisées.

Exemple 3 : Obtenir l’intégrité du cluster à l’aide d’une carte de stratégie d’intégrité de type d’application

PS C:\> $AppTypeHealthPolicyMap = New-Object -TypeName "System.Fabric.Health.ApplicationTypeHealthPolicyMap"
PS C:\> $AppTypeHealthPolicyMap.Add("CriticalAppType", 0)
PS C:\> Get-ServiceFabricClusterHealth -ApplicationTypeHealthPolicyMap $AppTypeHealthPolicyMap -MaxPercentUnhealthyApplications 20

Cette commande interroge l’intégrité du cluster et passe dans une carte de stratégie d’intégrité de type d’application. Le type d’application CriticalAppType ne tolère aucun échec. Les applications restantes sont évaluées à l’aide de 20 % maximum de pourcentage non sain.

Exemple 4 : Obtenir l’intégrité du cluster sans événements d’intégrité et sans statistiques d’intégrité

PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -ExcludeHealthStatistics

Cette commande interroge l’intégrité du cluster. Il spécifie des filtres pour exclure tous les événements d’intégrité et les statistiques d’intégrité.

Exemple 5 : Obtenir l’intégrité du cluster avec les statistiques d’application fabric:/Système incluses

PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -IncludeSystemApplicationHealthStatistics

Cette commande interroge l’intégrité du cluster. Les statistiques d’intégrité retournées dans le cadre de l’intégrité du cluster contiennent les statistiques d’application fabric:/Système, en plus des statistiques des applications utilisateur.

Paramètres

-ApplicationHealthPolicyMap

Spécifie l’objet ApplicationHealthPolicyMap qui inclut des stratégies d’intégrité personnalisées pour certaines ou toutes les applications. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise les stratégies d’intégrité d’application définies dans le manifeste de l’application ou la stratégie d’intégrité par défaut.

Type:ApplicationHealthPolicyMap
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationsFilter

Spécifie le filtre pour les enfants ApplicationHealthState en fonction de l’état d’intégrité. La valeur peut être obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de HealthStateFilter. Seuls les enfants qui correspondent au filtre sont retournés. Tous les enfants sont utilisés pour évaluer l’état d’intégrité agrégé de l’entité. Si cet argument n’est pas spécifié, toutes les entrées sont retournées.

Type:HealthStateFilter
Valeurs acceptées:Default, None, Ok, Warning, Error, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationsHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez plutôt le paramètre ApplicationsFilter .

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationTypeHealthPolicyMap

Spécifie la carte qui définit le pourcentage maximal d’applications non saines autorisées par type d’application. Les types d’applications de cette carte sont évalués à l’aide de pourcentages spécifiques plutôt que du pourcentage global MaxPercentUnhealthyApplications .

Par exemple, si certaines applications d’un type sont critiques, l’administrateur du cluster peut ajouter une entrée dans le mappage pour ce type d’application et lui attribuer une valeur de 0 % (autrement dit, aucun échec n’est toléré). Toutes les autres applications peuvent être évaluées avec MaxPercentUnhealthyApplications défini sur 20 % pour tolérer certains échecs des milliers d’instances d’application.

La carte de stratégie d’intégrité du type d’application est utilisée uniquement si le manifeste de cluster active l’évaluation d’intégrité du type d’application à l’aide de l’entrée de configuration pour HealthManager/EnableApplicationTypeHealthEvaluation.

Type:ApplicationTypeHealthPolicyMap
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ConsiderWarningAsError

Indique s’il faut traiter un rapport d’intégrité d’avertissement comme erreur lors de l’évaluation de l’intégrité. Cette valeur est utilisée pour l’évaluation des nœuds et des rapports d’intégrité de cluster.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EventsFilter

Spécifie le filtre pour la collection d’HealthEvents signalée sur le cluster en fonction de l’état d’intégrité. La valeur peut être obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de HealthStateFilter. Seuls les événements qui correspondent au filtre sont renvoyés. Tous les événements sont utilisés pour évaluer l’état d’intégrité agrégé du cluster. Si cet argument n’est pas spécifié, toutes les entrées sont retournées.

Type:HealthStateFilter
Valeurs acceptées:Default, None, Ok, Warning, Error, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EventsHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez plutôt le paramètre EventsFilter .

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ExcludeHealthStatistics

Indique si les statistiques d’intégrité doivent être incluses dans le résultat de la requête. Si elle est spécifiée, les statistiques d’intégrité ne sont pas retournées dans le cadre du résultat de la requête. Dans le cas contraire, le résultat de la requête inclut les statistiques d’intégrité du cluster, qui contiennent des informations sur le nombre d’entités dans Ok, Avertissement et États d’erreur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IncludeSystemApplicationHealthStatistics

Indique si les statistiques d’intégrité doivent inclure des informations pour l’application fabric:/System. Si spécifié, l’application, le service, la partition, le réplica, l’application déployée et le nombre de packages de service déployés incluent les entités système. Si elle n’est pas spécifiée, les statistiques d’intégrité retournent le nombre d’états d’intégrité uniquement pour les applications utilisateur.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxPercentUnhealthyApplications

Spécifie le pourcentage maximal toléré d’applications non saines. S’il existe plus d’applications avec un état d’intégrité agrégé d’erreur que toléré, l’état d’intégrité du cluster est une erreur. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise la valeur fournie dans le manifeste du cluster.

Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MaxPercentUnhealthyNodes

Spécifie le pourcentage maximal toléré de nœuds non sains. S’il existe plus de nœuds avec l’état d’intégrité agrégé de l’erreur que toléré, le cluster est évalué comme une erreur. Si vous ne spécifiez pas ce paramètre, l’évaluation d’intégrité utilise la valeur fournie dans le manifeste du cluster.

Type:Byte
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NodesFilter

Spécifie le filtre pour les enfants NodeHealthState en fonction de l’état d’intégrité. La valeur peut être obtenue à partir de membres ou d’opérations au niveau du bit sur les membres de HealthStateFilter. Seuls les enfants qui correspondent au filtre sont retournés. Tous les enfants sont utilisés pour évaluer l’état d’intégrité agrégé d’entité. Si cet argument n’est pas spécifié, toutes les entrées sont retournées.

Type:HealthStateFilter
Valeurs acceptées:Default, None, Ok, Warning, Error, All
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NodesHealthStateFilter

Ce paramètre a été déconseillé. Spécifiez plutôt le paramètre NodeFilter .

Type:Int64
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NodeTypeHealthPolicyMap

Définit une carte avec des pourcentages maximal de nœuds non sains pour des types de nœuds spécifiques.

Le mappage de stratégie d’intégrité de type de nœud peut être utilisé lors de l’évaluation de l’intégrité du cluster pour décrire les types de nœuds particuliers. Les types de nœuds inclus dans la carte sont évalués par rapport au pourcentage inclus dans la carte, ainsi qu’avec le global (voir System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Les nœuds des types de nœuds spécifiés dans la carte sont également comptabilisés par rapport au pool global de nœuds ; ils sont des vérifications indépendantes.

Type:NodeTypeHealthPolicyMap
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TimeoutSec

Spécifie la période d’expiration, en secondes, pour l’opération.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

System.Object