Dela via

Get-ServiceFabricClusterHealth

Modul:
ServiceFabric Module

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

Syntax

IncludeStats (Standard) 

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>]

ExcludeStats 

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.

Parameteregenskaper

Typ:ApplicationHealthPolicyMap
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:HealthStateFilter
Standardvärde:None
Godkända värden:Default, None, Ok, Warning, Error, All
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-ApplicationsHealthStateFilter

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

Parameteregenskaper

Typ:Int64
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:ApplicationTypeHealthPolicyMap
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:HealthStateFilter
Standardvärde:None
Godkända värden:Default, None, Ok, Warning, Error, All
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EventsHealthStateFilter

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

Parameteregenskaper

Typ:Int64
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

ExcludeStats
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

IncludeStats
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:Byte
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:Byte
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:HealthStateFilter
Standardvärde:None
Godkända värden:Default, None, Ok, Warning, Error, All
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NodesHealthStateFilter

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

Parameteregenskaper

Typ:Int64
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:NodeTypeHealthPolicyMap
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TimeoutSec

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

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

None

Utdata

System.Object