Get-ServiceFabricClusterHealth
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 sull'integrità.
- Errore. L'entità non soddisfa le linee guida per l'integrità.
- Avviso. 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 e 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 i figli 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 nodi con errore di stato di integrità e applicazioni con avviso di 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 $appHealthPolicyMapQuesto 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à dei tipi 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 20Questo comando esegue una query sull'integrità del cluster e passa in una mappa dei criteri di integrità dei tipi di applicazione. Il tipo di applicazione CriticalAppType non tollera errori. Le applicazioni rimanenti vengono valutate usando il 20% massimo percentuale non integra.
Esempio 4: ottenere l'integrità del cluster senza eventi di integrità e senza statistiche di integrità
PS C:\> Get-ServiceFabricClusterHealth -EventsFilter None -ExcludeHealthStatisticsQuesto comando esegue una query sull'integrità del cluster. Specifica i filtri per escludere eventuali 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 -IncludeSystemApplicationHealthStatisticsQuesto 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.
| Type: | ApplicationHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationsFilter
Specifica il filtro per i figli ApplicationHealthState 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 diversamente, vengono restituite tutte le voci.
| Type: | HealthStateFilter |
| Accepted values: | Default, None, Ok, Warning, Error, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationsHealthStateFilter
Questo parametro è stato deprecato. Specificare invece il parametro ApplicationsFilter .
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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é la percentuale globale MaxPercentUnhealthyApplications .
Ad esempio, se alcune applicazioni di un tipo sono di importanza critica, l'amministratore del cluster può aggiungere una voce alla mappa per tale tipo di applicazioni e assegnarle un valore pari a 0% (ovvero, non tollerare alcun errore). Tutte le altre applicazioni possono essere valutate con MaxPercentUnhealthyApplications impostata sul 20% per tollerare alcuni errori fuori dalle migliaia di istanze dell'applicazione.
La mappa dei criteri di integrità dei tipi 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.
| Type: | ApplicationTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsiderWarningAsError
Indica se considerare un report di integrità degli avvisi come errore durante la valutazione dell'integrità. Questo valore viene usato per la valutazione dei nodi e dei report di integrità del cluster.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventsFilter
Specifica il filtro per la raccolta di HealthEvents segnalate 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 diversamente, vengono restituite tutte le voci.
| Type: | HealthStateFilter |
| Accepted values: | Default, None, Ok, Warning, Error, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventsHealthStateFilter
Questo parametro è stato deprecato. Specificare invece il parametro EventsFilter .
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 sull'integrità del cluster, che contengono informazioni sul numero di entità in Stati Ok, Avviso e Errore.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 di 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Byte |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodesFilter
Specifica il filtro per i figli NodeHealthState 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 diversamente, vengono restituite tutte le voci.
| Type: | HealthStateFilter |
| Accepted values: | Default, None, Ok, Warning, Error, All |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NodesHealthStateFilter
Questo parametro è stato deprecato. Specificare invece il parametro NodeFilter .
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 tipi di nodi speciali. I tipi di nodo inclusi nella mappa vengono valutati rispetto alla percentuale inclusa nella mappa e anche con il globale (vedere System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). I nodi dei tipi di nodo specificati nella mappa vengono conteggiati anche nel pool globale di nodi; sono controlli indipendenti.
| Type: | NodeTypeHealthPolicyMap |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Specifica il periodo di timeout, in secondi, per l'operazione.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
None
Output
System.Object