Condividi tramite

Get-ServiceFabricClusterHealth

  • Riferimento
Modulo:
ServiceFabric

Ottiene informazioni sull'integrità per un cluster di Service Fabric.

Sintassi

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>]

Descrizione

Il cmdlet Get-ServiceFabricClusterHealth ottiene informazioni sull'integrità per un cluster di Service Fabric. Service Fabric segnala gli stati di integrità seguenti:

  • OK. L'entità soddisfa le linee guida per l'integrità.
  • Errore. L'entità non soddisfa le linee guida sull'integrità.
  • Avvertimento. L'entità soddisfa le linee guida sull'integrità, ma ha riscontrato un problema.

Lo stato di integrità aggregato del cluster prende in considerazione tutti i report sull'integrità del cluster, nonché lo stato di integrità aggregato di tutti gli elementi figlio, in modo ricorsivo. La valutazione dell'integrità usa i criteri di integrità del cluster e i criteri di integrità dell'applicazione di ogni applicazione nel cluster.

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster.

Esempio

Esempio 1: Ottenere l'integrità del cluster e filtrare gli elementi figlio restituiti

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

Questo comando esegue una query sull'integrità del cluster. Specifica i filtri per restituire solo i nodi con stato di integrità Errore e applicazioni con avviso dello stato di integrità o errore.

Esempio 2: Ottenere l'integrità del cluster usando criteri di integrità personalizzati

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

Questo comando esegue una query sull'integrità del cluster e passa i criteri personalizzati.

Esempio 3: Ottenere l'integrità del cluster usando una mappa dei criteri di integrità del tipo di applicazione

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

Questo comando esegue una query sull'integrità del cluster e passa una mappa dei criteri di integrità del tipo di applicazione. Il tipo di applicazione CriticalAppType non tollera errori. Le applicazioni rimanenti vengono valutate usando 20% percentuale massima di non integrità.

Esempio 4: Ottenere l'integrità del cluster senza eventi di integrità e senza statistiche di integrità

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

Questo comando esegue una query sull'integrità del cluster. Specifica i filtri per escludere gli eventi di integrità e le statistiche di integrità.

Esempio 5: Ottenere l'integrità del cluster con le statistiche dell'applicazione fabric:/System incluse

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

Questo comando esegue una query sull'integrità del cluster. Le statistiche di integrità restituite come parte dell'integrità del cluster contengono le statistiche dell'applicazione fabric:/System, oltre alle statistiche delle applicazioni utente.

Parametri

-ApplicationHealthPolicyMap

Specifica l'oggetto ApplicationHealthPolicyMap che include criteri di integrità personalizzati per alcune o tutte le applicazioni. Se non si specifica questo parametro, la valutazione dell'integrità usa i criteri di integrità dell'applicazione definiti nel manifesto dell'applicazione o i criteri di integrità predefiniti.

Tipo:ApplicationHealthPolicyMap
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationsFilter

Specifica il filtro per ApplicationHealthState elementi figlio in base allo stato di integrità. Il valore può essere ottenuto dai membri o dalle operazioni bit per bit sui membri di HealthStateFilter. Vengono restituiti solo elementi figlio che corrispondono al filtro. Tutti gli elementi figlio vengono usati per valutare lo stato di integrità aggregato dell'entità. Se non specificato, vengono restituite tutte le voci.

Tipo:HealthStateFilter
Valori accettati:Default, None, Ok, Warning, Error, All
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationsHealthStateFilter

Questo parametro è stato deprecato. Specificare invece il parametro ApplicationsFilter.

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationTypeHealthPolicyMap

Specifica la mappa che definisce la percentuale massima di applicazioni non integre consentite per ogni tipo di applicazione. I tipi di applicazione in questa mappa vengono valutati usando percentuali specifiche anziché il globale MaxPercentUnhealthyApplications percentuale.

Ad esempio, se alcune applicazioni di un tipo sono critiche, l'amministratore del cluster può aggiungere una voce alla mappa per tale tipo di applicazione e assegnargli un valore pari a 0%( ovvero non tollerare errori). Tutte le altre applicazioni possono essere valutate con MaxPercentUnhealthyApplications impostata su 20% per tollerare alcuni errori dalle migliaia di istanze dell'applicazione.

La mappa dei criteri di integrità del tipo di applicazione viene usata solo se il manifesto del cluster abilita la valutazione dell'integrità del tipo di applicazione usando la voce di configurazione per HealthManager/EnableApplicationTypeHealthEvaluation.

Tipo:ApplicationTypeHealthPolicyMap
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConsiderWarningAsError

Indica se considerare un report sull'integrità degli avvisi come errore durante la valutazione dell'integrità. Questo valore viene usato per la valutazione dei nodi e dei report sull'integrità del cluster.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EventsFilter

Specifica il filtro per la raccolta di HealthEvents segnalato nel cluster in base allo stato di integrità. Il valore può essere ottenuto dai membri o dalle operazioni bit per bit sui membri di HealthStateFilter. Vengono restituiti solo gli eventi che corrispondono al filtro. Tutti gli eventi vengono usati per valutare lo stato di integrità aggregato del cluster. Se non specificato, vengono restituite tutte le voci.

Tipo:HealthStateFilter
Valori accettati:Default, None, Ok, Warning, Error, All
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EventsHealthStateFilter

Questo parametro è stato deprecato. Specificare invece il parametro EventsFilter .

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExcludeHealthStatistics

Indica se le statistiche di integrità devono essere incluse nel risultato della query. Se specificato, le statistiche di integrità non vengono restituite come parte del risultato della query. In caso contrario, il risultato della query include le statistiche di integrità del cluster, che contengono informazioni sul numero di entità in stati Ok, Avviso e Errore.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IncludeSystemApplicationHealthStatistics

Indica se le statistiche di integrità devono includere informazioni per l'applicazione fabric:/System. Se specificato, l'applicazione, il servizio, la partizione, la replica, l'applicazione distribuita e i conteggi dei pacchetti del servizio distribuiti includono le entità di sistema. Se non specificato, le statistiche di integrità restituiscono il conteggio dello stato di integrità solo per le applicazioni utente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxPercentUnhealthyApplications

Specifica la percentuale massima tollerata di applicazioni non integre. Se sono presenti più applicazioni con stato di integrità aggregato di errore che tollerato, lo stato di integrità del cluster è errore. Se non si specifica questo parametro, la valutazione dell'integrità usa il valore fornito nel manifesto del cluster.

Tipo:Byte
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxPercentUnhealthyNodes

Specifica la percentuale massima tollerata di nodi non integri. Se sono presenti più nodi con stato di integrità aggregato di errore che tollerato, il cluster viene valutato come errore. Se non si specifica questo parametro, la valutazione dell'integrità usa il valore fornito nel manifesto del cluster.

Tipo:Byte
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NodesFilter

Specifica il filtro per NodeHealthState elementi figlio in base allo stato di integrità. Il valore può essere ottenuto dai membri o dalle operazioni bit per bit sui membri di HealthStateFilter. Vengono restituiti solo elementi figlio che corrispondono al filtro. Tutti gli elementi figlio vengono usati per valutare lo stato di integrità aggregato dell'entità. Se non specificato, vengono restituite tutte le voci.

Tipo:HealthStateFilter
Valori accettati:Default, None, Ok, Warning, Error, All
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NodesHealthStateFilter

Questo parametro è stato deprecato. Specificare invece il parametro nodesFilter .

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NodeTypeHealthPolicyMap

Definisce una mappa con percentuali massime di nodi non integri per tipi di nodo specifici.

La mappa dei criteri di integrità dei tipi di nodo può essere usata durante la valutazione dell'integrità del cluster per descrivere i tipi di nodo speciali. I tipi di nodo inclusi nella mappa vengono valutati rispetto alla percentuale inclusa nella mappa e anche con il valore globale (vedere System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Anche i nodi dei tipi di nodo specificati nella mappa vengono conteggiati rispetto al pool globale di nodi; sono controlli indipendenti.

Tipo:NodeTypeHealthPolicyMap
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeoutSec

Specifica il periodo di timeout, espresso in secondi, per l'operazione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object