Dela via

Get-ServiceFabricClusterHealth

  • Referens
Modul:
ServiceFabric

Hämtar hälsoinformation för ett Service Fabric-kluster.

Syntax

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

Cmdleten Get-ServiceFabricClusterHealth hämtar hälsoinformation för ett Service Fabric-kluster. Service Fabric rapporterar följande hälsotillstånd:

  • OK. Entiteten uppfyller hälsoriktlinjerna.
  • Fel. Entiteten uppfyller inte hälsoriktlinjerna.
  • Varning. Entiteten uppfyller hälsoriktlinjerna men har haft ett visst problem.

Klustrets aggregerade hälsotillstånd tar hänsyn till alla hälsorapporter i klustret samt det aggregerade hälsotillståndet för alla underordnade, rekursivt. Hälsoutvärderingen använder klustrets hälsoprincip och programhälsoprincipen för varje program i klustret.

Innan du utför någon åtgärd i ett Service Fabric-kluster upprättar du en anslutning till klustret med hjälp av cmdleten Connect-ServiceFabricCluster .

Exempel

Exempel 1: Hämta hälsotillståndet för klustret och filtrera returnerade underordnade

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

Det här kommandot frågar hälsotillståndet för klustret. Den anger filter för att endast returnera noder med hälsotillstånd Fel och program med hälsotillstånd Varning eller Fel.

Exempel 2: Hämta hälsotillståndet för klustret med hjälp av anpassade hälsoprinciper

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

Det här kommandot frågar efter klustrets hälsa och skickar anpassade principer.

Exempel 3: Hämta hälsotillståndet för klustret med hjälp av en hälsoprincipkarta för programtyp

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

Det här kommandot frågar efter klustrets hälsa och skickar en hälsoprincipkarta för programtyp. Programtypen CriticalAppType tolererar inga fel. De återstående programmen utvärderas med 20 % maximalt fel i procent.

Exempel 4: Hämta hälsotillståndet för klustret utan hälsohändelser och utan hälsostatistik

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

Det här kommandot frågar hälsotillståndet för klustret. Den anger filter för att undanta hälsohändelser och hälsostatistik.

Exempel 5: Hämta hälsotillståndet för klustret med infrastruktur:/Systemprogramstatistik inkluderad

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

Det här kommandot frågar hälsotillståndet för klustret. Hälsostatistiken som returneras som en del av klusterhälsan innehåller statistik för infrastrukturresurser:/systemprogram utöver statistik för användarprogram.

Parametrar

-ApplicationHealthPolicyMap

Anger ApplicationHealthPolicyMap-objektet som innehåller anpassade hälsoprinciper för vissa eller alla program. Om du inte anger den här parametern använder hälsoutvärderingen de programhälsoprinciper som definierats i programmanifestet eller standardhälsoprincipen.

Type:ApplicationHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationsFilter

Anger filtret för ApplicationHealthState-underordnade baserat på hälsotillståndet. Värdet kan hämtas från medlemmar eller bitvis-åtgärder för medlemmar i HealthStateFilter. Endast underordnade som matchar filtret returneras. Alla underordnade används för att utvärdera entitetens aggregerade hälsotillstånd. Om inget anges returneras alla poster.

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

Den här parametern har blivit inaktuell. Ange parametern ApplicationsFilter i stället.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationTypeHealthPolicyMap

Anger den karta som definierar den maximala procentandelen program med feltillstånd som tillåts per programtyp. Programtyper i den här kartan utvärderas med hjälp av specifika procentandelar i stället för den globala procentandelen MaxPercentUnhealthyApplications .

Om vissa program av en typ till exempel är kritiska kan klusteradministratören lägga till en post på kartan för den programtypen och tilldela den ett värde på 0 % (det vill säga tolerera inte några fel). Alla andra program kan utvärderas med MaxPercentUnhealthyApplications inställt på 20 % för att tolerera vissa fel av tusentals programinstanser.

Programtypens hälsoprincipkarta används endast om klustermanifestet aktiverar hälsoutvärdering av programtyp med hjälp av konfigurationsposten för HealthManager/EnableApplicationTypeHealthEvaluation.

Type:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsiderWarningAsError

Anger om en varningshälsorapport ska behandlas som ett fel under hälsoutvärderingen. Det här värdet används för utvärdering av noder och klusterhälsorapporter.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventsFilter

Anger filtret för den samling HealthEvents som rapporterats i klustret baserat på hälsotillståndet. Värdet kan hämtas från medlemmar eller bitvis-åtgärder för medlemmar i HealthStateFilter. Endast händelser som matchar filtret returneras. Alla händelser används för att utvärdera klustrets aggregerade hälsotillstånd. Om inget anges returneras alla poster.

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

Den här parametern har blivit inaktuell. Ange parametern EventsFilter i stället.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeHealthStatistics

Anger om hälsostatistiken ska ingå i frågeresultatet. Om det anges returneras inte hälsostatistiken som en del av frågeresultatet. Annars innehåller frågeresultatet hälsostatistik för klustret, som innehåller information om hur många entiteter som finns i ok, varnings- och feltillstånd.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeSystemApplicationHealthStatistics

Anger om hälsostatistiken ska innehålla information för infrastrukturresursen:/systemprogrammet. Om det anges omfattar antalet program, tjänster, partitioner, repliker, distribuerade program och distribuerade tjänstpaket systementiteter. Om det inte anges räknas hälsostatistiken endast för användarprogram.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyApplications

Anger den maximala tolererade procentandelen program som inte är felfria. Om det finns fler program med aggregerat hälsotillstånd för fel än vad som tolereras är klustrets hälsotillstånd fel. Om du inte anger den här parametern använder hälsoutvärderingen det värde som anges i klustermanifestet.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxPercentUnhealthyNodes

Anger den maximala tolererade procentandelen noder som inte är felfria. Om det finns fler noder med aggregerat hälsotillstånd för fel än vad som tolereras utvärderas klustret som ett fel. Om du inte anger den här parametern använder hälsoutvärderingen det värde som anges i klustermanifestet.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodesFilter

Anger filtret för NodeHealthState-underordnade baserat på hälsotillståndet. Värdet kan hämtas från medlemmar eller bitvis-åtgärder för medlemmar i HealthStateFilter. Endast underordnade som matchar filtret returneras. Alla underordnade används för att utvärdera entitetens aggregerade hälsotillstånd. Om inget anges returneras alla poster.

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

Den här parametern har blivit inaktuell. Ange parametern NodesFilter i stället.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeTypeHealthPolicyMap

Definierar en karta med maximala procentandelar ej felfria noder för specifika nodtyper.

Mappningen av nodtypens hälsoprincip kan användas vid utvärdering av klusterhälsa för att beskriva särskilda nodtyper. Nodtyperna som ingår i kartan utvärderas mot procentandelen som ingår i kartan och även med den globala (se System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Noderna för nodtyper som anges på kartan räknas också mot den globala poolen med noder. de är oberoende kontroller.

Type:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

None

Utdata

System.Object