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:

  • OKEJ. Entiteten uppfyller hälsoriktlinjerna.
  • Fel. Entiteten uppfyller inte hälsoriktlinjerna.
  • Varning. Entiteten uppfyller hälsoriktlinjerna men har drabbats av 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 programmets hälsoprincip 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 objekt

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

Det här kommandot frågar efter 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 hälsotillståndet för klustret och skickar en hälsoprincipkarta av programtyp. Programtypen CriticalAppType tolererar inte några fel. De återstående programmen utvärderas med hjälp av 20% maximalt antal felfria 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 efter 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 infrastrukturresurser:/Systemprogramstatistik ingår

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

Det här kommandot frågar efter 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 objektet ApplicationHealthPolicyMap 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.

Typ:ApplicationHealthPolicyMap
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 på medlemmar i HealthStateFilter. Endast underordnade som matchar filtret returneras. Alla underordnade används för att utvärdera entitetens aggregerade hälsotillstånd. Om det inte anges returneras alla poster.

Typ:HealthStateFilter
Godkända värden:Default, None, Ok, Warning, Error, All
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ApplicationsHealthStateFilter

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

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 MaxPercentUnhealthyApplications procent.

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 värdet 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 de tusentals programinstanserna.

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

Typ:ApplicationTypeHealthPolicyMap
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 hälsorapporter för kluster.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EventsFilter

Anger filtret för samlingen av HealthEvents som rapporterats på klustret baserat på hälsotillståndet. Värdet kan hämtas från medlemmar eller bitvis åtgärder på 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 det inte anges returneras alla poster.

Typ:HealthStateFilter
Godkända värden:Default, None, Ok, Warning, Error, All
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EventsHealthStateFilter

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

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ExcludeHealthStatistics

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeSystemApplicationHealthStatistics

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxPercentUnhealthyApplications

Anger den maximala tillåtna 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 värdet som anges i klustermanifestet.

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxPercentUnhealthyNodes

Anger den maximala tillåtna procentandelen ej felfria noder. 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 värdet som anges i klustermanifestet.

Typ:Byte
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 på medlemmar i HealthStateFilter. Endast underordnade som matchar filtret returneras. Alla underordnade används för att utvärdera entitetens aggregerade hälsotillstånd. Om det inte anges returneras alla poster.

Typ:HealthStateFilter
Godkända värden:Default, None, Ok, Warning, Error, All
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NodesHealthStateFilter

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

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NodeTypeHealthPolicyMap

Definierar en karta med maximala procentuella noder som inte är felfria för specifika nodtyper.

Mappningen av nodtypens hälsoprincip kan användas under 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 i kartan räknas också mot den globala nodpoolen. de är oberoende kontroller.

Typ:NodeTypeHealthPolicyMap
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

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

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object