Delen via

Get-ServiceFabricClusterHealthChunk

  • Referentie
Module:
ServiceFabric

Hiermee haalt u statusinformatie op voor een Service Fabric-cluster en de onderliggende items.

Syntaxis

Get-ServiceFabricClusterHealthChunk
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyApplications <Byte>]
   [-MaxPercentUnhealthyNodes <Byte>]
   [-ApplicationHealthPolicies <ApplicationHealthPolicyMap>]
   [-ApplicationTypeHealthPolicyMap <ApplicationTypeHealthPolicyMap>]
   [-NodeTypeHealthPolicyMap <NodeTypeHealthPolicyMap>]
   [-ApplicationFilters <System.Collections.Generic.List`1[System.Fabric.Health.ApplicationHealthStateFilter]>]
   [-NodeFilters <System.Collections.Generic.List`1[System.Fabric.Health.NodeHealthStateFilter]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

De cmdlet Get-ServiceFabricClusterHealthChunk haalt statusinformatie op voor een Service Fabric-cluster en clusterentiteiten zoals aangevraagd met de geavanceerde invoerfilters. Standaard worden er geen onderliggende entiteiten geretourneerd. Indien opgegeven, worden alle entiteiten die de invoer respecteren, op hiërarchische wijze geretourneerd.

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 ondervindt enkele problemen.

De geaggregeerde status van het cluster houdt rekening met alle statusrapporten in het cluster en de geaggregeerde status van alle onderliggende kinderen, recursief. De statusevaluatie maakt gebruik van het clusterstatusbeleid en het toepassingsstatusbeleid van elke toepassing in het cluster. U kunt het statusbeleid voor het cluster en voor toepassingsevaluatie doorgeven als invoer. Als dit niet is opgegeven, gebruikt de statusevaluatie het toepasselijke statusbeleid van het cluster en het toepassingsmanifest als het manifest is opgegeven of het standaardbeleid anders.

Het segment clusterstatus bevat alleen onderliggende elementen die interessant zijn zoals opgegeven in de invoerfilters. Het filteren wordt uitgevoerd aan de serverzijde, dus de berichtgrootte wordt geminimaliseerd.

Als de aangevraagde uitvoer niet in een bericht past, wordt er geen resultaat geretourneerd.

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 met knooppuntfilters

PS C:\> $ErrorFilter = [System.Fabric.Health.HealthStateFilter]::Error
PS C:\> $AllFilter = [System.Fabric.Health.HealthStateFilter]::All
PS C:\> $NodeFilter1 = New-Object System.Fabric.Health.NodeHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $NodeFilter2 = New-Object System.Fabric.Health.NodeHealthStateFilter -Property @{NodeNameFilter="N0010";HealthStateFilter=$ErrorFilter}
PS C:\> $NodeFilters = New-Object System.Collections.Generic.List[System.Fabric.Health.NodeHealthStateFilter]
PS C:\> $NodeFilters.Add($NodeFilter1)
PS C:\> $NodeFilters.Add($NodeFilter2)
PS C:\> Get-ServiceFabricClusterHealthChunk -NodeFilter $NodeFilters

Met deze opdracht wordt de status van het cluster opgevraagd. Hiermee worden filters opgegeven om alle knooppunten te retourneren, met uitzondering van knooppunt N0010, die alleen moeten worden opgenomen als de status van de samengevoegde status in Fout.

Voorbeeld 2: De status van het cluster ophalen met geïmplementeerde entiteitsfilters

PS C:\> $ErrorFilter = [System.Fabric.Health.HealthStateFilter]::Error
PS C:\> $AllFilter = [System.Fabric.Health.HealthStateFilter]::All
PS C:\> $DspFilter1 = New-Object System.Fabric.Health.DeployedServicePackageHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $DaFilter1 =  New-Object System.Fabric.Health.DeployedApplicationHealthStateFilter -Property @{HealthStateFilter=$AllFilter;NodeNameFilter="N0020"}
PS C:\> $DaFilter1.DeployedServicePackageFilters.Add($DspFilter1)
PS C:\> $AppFilter = New-Object System.Fabric.Health.ApplicationHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $AppFilter.DeployedApplicationFilters.Add($DaFilter1)
PS C:\> $AppFilters = New-Object System.Collections.Generic.List[System.Fabric.Health.ApplicationHealthStateFilter]
PS C:\> $AppFilters.Add($AppFilter)
PS C:\> Get-ServiceFabricClusterHealthChunk -ApplicationFilters $AppFilters

Met deze opdracht wordt de status van het cluster opgevraagd. Hiermee geeft u filters op om alle toepassingen en geïmplementeerde toepassingen en geïmplementeerde servicepakketten op een opgegeven knooppunt (N0020) te retourneren.

Voorbeeld 3: De status van het cluster ophalen met een toepassingsfilter dat recursieve binnenfilters bevat

PS C:\> $ErrorFilter = [System.Fabric.Health.HealthStateFilter]::Error
PS C:\> $AllFilter = [System.Fabric.Health.HealthStateFilter]::All
PS C:\> $ReplicaFilter1 = New-Object System.Fabric.Health.ReplicaHealthStateFilter -Property @{ReplicaOrInstanceIdFilter= 130984777977143495;HealthStateFilter=$ErrorFilter}
PS C:\> $ReplicaFilter2 = New-Object System.Fabric.Health.ReplicaHealthStateFilter -Property @{HealthStateFilter=$AllFilter}

PS C:\> $PartitionFilter = New-Object System.Fabric.Health.PartitionHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $PartitionFilter.ReplicaFilters.Add($ReplicaFilter1)
PS C:\> $PartitionFilter.ReplicaFilters.Add($ReplicaFilter2)

PS C:\> $SvcFilter1 = New-Object System.Fabric.Health.ServiceHealthStateFilter -Property @{HealthStateFilter=$AllFilter}
PS C:\> $SvcFilter1.PartitionFilters.Add($PartitionFilter)

PS C:\> $AppFilter = New-Object System.Fabric.Health.ApplicationHealthStateFilter -Property @{ApplicationNameFilter="fabric:/app1"}
PS C:\> $AppFilter.ServiceFilters.Add($SvcFilter1)

PS C:\> $AppFilters = New-Object System.Collections.Generic.List[System.Fabric.Health.ApplicationHealthStateFilter]
PS C:\> $AppFilters.Add($AppFilter)
PS C:\> Get-ServiceFabricClusterHealthChunk -ApplicationFilters $AppFilters

Met deze opdracht wordt de status van het cluster opgevraagd. Hiermee geeft u filters op om alleen een toepassing te retourneren. Het filter retourneert alle toepassingsservices en voor elke service worden alle partities geretourneerd. Voor elke partitie bevat het alle replica's, met uitzondering van 130984777977143495, die alleen moeten worden geretourneerd als de fout wordt weergegeven.

Parameters

-ApplicationFilters

Hiermee geeft u een Systems.Collections.Generic.List van System.Fabric.Health.ApplicationHealthStateFilter-objecten . Alleen toepassingen die het meest specifieke filter respecteren, worden geretourneerd. U kunt de filters voor afzonderlijke toepassingen of voor alle toepassingen opgeven. Slechts één algemeen filter en één filter per toepassing zijn toegestaan.

Als u deze parameter niet opgeeft, worden er geen toepassingen geretourneerd.

Type:System.Collections.Generic.List`1[System.Fabric.Health.ApplicationHealthStateFilter]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ApplicationHealthPolicies

Hiermee geeft u een System.Fabric.Health.ApplicationHealthPolicyMap op die aangepaste statusbeleidsregels bevat voor sommige of alle toepassingen. Als u deze parameter niet opgeeft of als u geen vermelding in de kaart voor een toepassing opneemt, wordt die toepassing geëvalueerd met het toepassingsstatusbeleid dat is gedefinieerd in het toepassingsmanifest als deze bestaat of het standaardbeleid anders.

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

-ApplicationTypeHealthPolicyMap

Hiermee geeft u de kaart op waarmee het maximale percentage 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 kaart voor dat toepassingstype en deze een waarde van 0% toewijzen (dat wil gezegd, geen fouten tolereren). Alle andere toepassingen kunnen worden geëvalueerd met MaxPercentUnhealthyApplications ingesteld op 20% om enkele fouten van 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 een fout tijdens de statusevaluatie. Deze waarde wordt gebruikt voor de evaluatie van knooppunten en clusterstatusrapporten.

Als geen van de statusbeleidsparameters van het cluster is opgegeven, gebruikt de statusevaluatie het clusterstatusbeleid uit het clustermanifest, indien aanwezig, of het standaardbeleid dat geen fouten tolereert.

Type:Boolean
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 een fout dan getolereerd, is de status van het cluster Fout.

Als geen van de statusbeleidsparameters van het cluster is opgegeven, gebruikt de statusevaluatie het clusterstatusbeleid uit het clustermanifest, indien aanwezig, of het standaardbeleid dat geen fouten tolereert.

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

-MaxPercentUnhealthyNodes

Hiermee geeft u het maximaal getolereerde percentage beschadigde knooppunten. Als er meer knooppunten zijn met een geaggregeerde status van een 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.

Als geen van de statusbeleidsparameters van het cluster is opgegeven, gebruikt de statusevaluatie het clusterstatusbeleid uit het clustermanifest, indien aanwezig, of het standaardbeleid dat geen fouten tolereert.

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

-NodeFilters

Hiermee geeft u een Systems.Collections.Generic.List van System.Fabric.Health.NodeHealthStateFilter-objecten . Alleen knooppunten die het meest specifieke filter respecteren, worden geretourneerd. U kunt de filters voor afzonderlijke knooppunten of voor alle knooppunten opgeven. Er zijn slechts één algemeen filter en één filter per knooppunt toegestaan. Als u deze parameter niet opgeeft, worden er geen knooppunten geretourneerd.

Type:System.Collections.Generic.List`1[System.Fabric.Health.NodeHealthStateFilter]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NodeTypeHealthPolicyMap

Definieert een kaart met maximale percentages beschadigde knooppunten voor specifieke knooppunttypen.

De statusbeleidstoewijzing van het knooppunttype kan worden gebruikt tijdens de evaluatie van de clusterstatus om speciale knooppunttypen te beschrijven. De knooppunttypen die in de kaart zijn opgenomen, worden geëvalueerd op basis van het percentage dat in de kaart is opgenomen, en ook met het algemene (zie System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). De knooppunten van knooppunttypen die in de kaart zijn opgegeven, worden ook meegeteld voor 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, op voor de bewerking.

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

Invoerwaarden

None

Uitvoerwaarden

System.Object