Get-ServiceFabricClusterHealth

Module:

ServiceFabric

Hiermee haalt u statusinformatie op voor een Service Fabric-cluster.

Syntaxis

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

De cmdlet Get-ServiceFabricClusterHealth haalt statusinformatie op voor een Service Fabric-cluster. Service Fabric rapporteert de volgende statussen:

• OK. De entiteit voldoet aan de statusrichtlijnen.
• Fout. De entiteit voldoet niet aan de statusrichtlijnen.
• Waarschuwing. De entiteit voldoet aan de statusrichtlijnen, maar er is een probleem opgetreden.

De geaggregeerde status van het cluster houdt rekening met alle statusrapporten in het cluster en de geaggregeerde status van alle onderliggende onderliggende items, recursief. De statusevaluatie maakt gebruik van het clusterstatusbeleid en het toepassingsstatusbeleid van elke toepassing in het cluster.

Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .

Voorbeelden

Voorbeeld 1: De status van het cluster ophalen en geretourneerde onderliggende items filteren

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

Met deze opdracht wordt de status van het cluster opgevraagd. Hiermee geeft u filters op om alleen knooppunten met statusfout en toepassingen met statuswaarschuwing of fout te retourneren.

Voorbeeld 2: De status van het cluster ophalen met behulp van aangepast statusbeleid

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

Met deze opdracht wordt de status van het cluster opgevraagd en worden aangepaste beleidsregels doorgegeven.

Voorbeeld 3: De status van het cluster ophalen met behulp van een statusbeleidstoewijzing voor toepassingstypen

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

Met deze opdracht wordt een query uitgevoerd op de status van het cluster en wordt de statusbeleidstoewijzing van het toepassingstype doorgegeven. Het toepassingstype CriticalAppType tolereert geen fouten. De resterende toepassingen worden geëvalueerd met 20% maximumpercentage beschadigd.

Voorbeeld 4: De status van het cluster zonder statusevenementen en zonder statusstatistieken ophalen

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

Met deze opdracht wordt de status van het cluster opgevraagd. Hiermee worden filters opgegeven om status-gebeurtenissen en de statusstatistieken uit te sluiten.

Voorbeeld 5: De status van het cluster ophalen met infrastructuur:/Systeemtoepassingsstatistieken inbegrepen

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

Met deze opdracht wordt de status van het cluster opgevraagd. De statusstatistieken die als onderdeel van de clusterstatus worden geretourneerd, bevatten de infrastructuur-/systeemtoepassingsstatistieken, naast de statistieken van gebruikerstoepassingen.

Parameters

-ApplicationHealthPolicyMap

Hiermee geeft u het ApplicationHealthPolicyMap-object op dat aangepast statusbeleid voor sommige of alle toepassingen bevat. Als u deze parameter niet opgeeft, gebruikt de statusevaluatie het toepassingsstatusbeleid dat is gedefinieerd in het toepassingsmanifest of het standaardstatusbeleid.

Type:	ApplicationHealthPolicyMap
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ApplicationsFilter

Hiermee geeft u het filter voor ApplicationHealthState-kinderen op basis van de status. De waarde kan worden verkregen van leden of bitwise bewerkingen voor leden van HealthStateFilter. Alleen onderliggende items die overeenkomen met het filter worden geretourneerd. Alle onderliggende items worden gebruikt om de geaggregeerde status van de entiteit te evalueren. Als dit niet is opgegeven, worden alle vermeldingen geretourneerd.

Type:	HealthStateFilter
Geaccepteerde waarden:	Default, None, Ok, Warning, Error, All
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ApplicationsHealthStateFilter

Deze parameter is afgeschaft. Geef in plaats daarvan de parameter ApplicationsFilter op.

Type:	Int64
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ApplicationTypeHealthPolicyMap

Hiermee geeft u de kaart op waarmee het maximumpercentage van beschadigde toepassingen wordt gedefinieerd dat per toepassingstype is toegestaan. Toepassingstypen in deze kaart worden geëvalueerd met specifieke percentages in plaats van het globale Percentage MaxPercentUnhealthyApplications .

Als sommige toepassingen van een type bijvoorbeeld kritiek zijn, kan de clusterbeheerder een vermelding toevoegen aan de toewijzing voor dat toepassingstype en deze toewijzen aan een waarde van 0% (dat wil gezegd: geen fouten tolereren). Alle andere toepassingen kunnen worden geëvalueerd met MaxPercentUnhealthyApplications ingesteld op 20% om bepaalde fouten uit de duizenden toepassingsexemplaren te tolereren.

De statusbeleidstoewijzing van het toepassingstype wordt alleen gebruikt als het clustermanifest statusevaluatie van toepassingstypen inschakelt met behulp van de configuratievermelding voor HealthManager/EnableApplicationTypeHealthEvaluation.

Type:	ApplicationTypeHealthPolicyMap
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ConsiderWarningAsError

Geeft aan of een waarschuwingsstatusrapport moet worden behandeld als fout tijdens de statusevaluatie. Deze waarde wordt gebruikt voor de evaluatie van knooppunten en clusterstatusrapporten.

Type:	Boolean
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-EventsFilter

Hiermee geeft u het filter op voor de verzameling HealthEvents die zijn gerapporteerd op het cluster op basis van de status. De waarde kan worden verkregen van leden of bitwise bewerkingen voor leden van HealthStateFilter. Alleen gebeurtenissen die overeenkomen met het filter worden geretourneerd. Alle gebeurtenissen worden gebruikt om de geaggregeerde status van het cluster te evalueren. Als dit niet is opgegeven, worden alle vermeldingen geretourneerd.

Type:	HealthStateFilter
Geaccepteerde waarden:	Default, None, Ok, Warning, Error, All
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-EventsHealthStateFilter

Deze parameter is afgeschaft. Geef in plaats daarvan de parameter EventsFilter op.

Type:	Int64
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ExcludeHealthStatistics

Geeft aan of de statusstatistieken moeten worden opgenomen in het queryresultaat. Indien opgegeven, worden de statusstatistieken niet geretourneerd als onderdeel van het queryresultaat. Anders bevat het queryresultaat de clusterstatusstatistieken, die informatie bevatten over het aantal entiteiten in ok, waarschuwing en foutstatus.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-IncludeSystemApplicationHealthStatistics

Geeft aan of de statusstatistieken informatie moeten bevatten voor de fabric:/System-toepassing. Indien opgegeven, omvatten de toepassing, service, partitie, replica, geïmplementeerde toepassing en geïmplementeerde servicepakketten de systeementiteiten. Als dit niet is opgegeven, retourneren de statusstatistieken alleen het aantal statussen voor gebruikerstoepassingen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MaxPercentUnhealthyApplications

Hiermee geeft u het maximaal getolereerde percentage van beschadigde toepassingen op. Als er meer toepassingen zijn met een geaggregeerde status van de fout dan getolereerd, is de status van het cluster een fout. Als u deze parameter niet opgeeft, gebruikt de statusevaluatie de waarde die is opgegeven in het clustermanifest.

Type:	Byte
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-MaxPercentUnhealthyNodes

Hiermee geeft u het maximaal toegestane percentage beschadigde knooppunten op. Als er meer knooppunten zijn met de geaggregeerde status van de fout dan getolereerd, wordt het cluster geëvalueerd als fout. Als u deze parameter niet opgeeft, gebruikt de statusevaluatie de waarde die is opgegeven in het clustermanifest.

Type:	Byte
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NodesFilter

Hiermee geeft u het filter op voor NodeHealthState-kinderen op basis van de status. De waarde kan worden verkregen van leden of bitwise bewerkingen voor leden van HealthStateFilter. Alleen onderliggende items die overeenkomen met het filter worden geretourneerd. Alle onderliggende items worden gebruikt om de geaggregeerde status van de entiteit te evalueren. Als dit niet is opgegeven, worden alle vermeldingen geretourneerd.

Type:	HealthStateFilter
Geaccepteerde waarden:	Default, None, Ok, Warning, Error, All
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NodesHealthStateFilter

Deze parameter is afgeschaft. Geef in plaats daarvan de parameter NodesFilter op.

Type:	Int64
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-NodeTypeHealthPolicyMap

Hiermee definieert u een kaart met maximale percentages beschadigde knooppunten voor specifieke knooppunttypen.

De beleidstoewijzing van het knooppunttype kan worden gebruikt tijdens de evaluatie van de clusterstatus om speciale knooppunttypen te beschrijven. De knooppunttypen die zijn opgenomen in de kaart, worden geëvalueerd op basis van het percentage dat is opgenomen in de kaart, en ook met de globale (zie System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). De knooppunten van knooppunttypen die in de kaart zijn opgegeven, worden ook meegeteld bij de globale pool van knooppunten; ze zijn onafhankelijke controles.

Type:	NodeTypeHealthPolicyMap
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

Uitvoerwaarden

System.Object

Verwante koppelingen

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection