Get-ServiceFabricClusterHealth
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 $appHealthPolicyMapCette 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 20Cette 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 -ExcludeHealthStatisticsCette 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 -IncludeSystemApplicationHealthStatisticsCette 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