Get-ServiceFabricClusterHealth

Získá informace o stavu clusteru Service Fabric.

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

Rutina Get-ServiceFabricClusterHealth získá informace o stavu clusteru Service Fabric. Service Fabric hlásí následující stavy stavu:

  • OK. Entita splňuje pokyny pro stav.
  • Chyba Entita nesplňuje pokyny pro stav.
  • Upozornění: Entita splňuje pokyny ke stavu, ale došlo k nějakému problému.

Agregovaný stav clusteru bere v úvahu všechny sestavy stavu clusteru a také agregovaný stav všech podřízených objektů rekurzivně. Vyhodnocení stavu používá zásady stavu clusteru a zásady stavu aplikace každé aplikace v clusteru.

Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .

Příklady

Příklad 1: Získání stavu clusteru a filtrování vrácených podřízených položek

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

Tento příkaz dotazuje stav clusteru. Určuje filtry, které mají vrátit pouze uzly s chybou stavu a aplikacemi se stavovým upozorněním nebo chybou.

Příklad 2: Získání stavu clusteru pomocí vlastních zásad stavu

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

Tento příkaz dotazuje stav clusteru a předává vlastní zásady.

Příklad 3: Získání stavu clusteru pomocí mapy zásad stavu typu aplikace

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

Tento příkaz dotazuje stav clusteru a předává mapu zásad stavu typu aplikace. Typ aplikace CriticalAppType netoleruje žádné chyby. Zbývající aplikace se vyhodnocují pomocí 20 % maximálního počtu v pořádku.

Příklad 4: Získání stavu clusteru bez událostí stavu a bez statistik stavu

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

Tento příkaz dotazuje stav clusteru. Určuje filtry pro vyloučení všech událostí stavu a statistiky stavu.

Příklad 5: Získání stavu clusteru s prostředky infrastruktury:/Statistika systémové aplikace zahrnutá

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

Tento příkaz dotazuje stav clusteru. Statistiky stavu vrácené jako součást stavu clusteru obsahují kromě statistik uživatelských aplikací také statistiku prostředků infrastruktury:/Systémové aplikace.

Parametry

-ApplicationHealthPolicyMap

Určuje objekt ApplicationHealthPolicyMap , který obsahuje vlastní zásady stavu pro některé nebo všechny aplikace. Pokud tento parametr nezadáte, použije vyhodnocení stavu zásady stavu aplikace definované v manifestu aplikace nebo výchozí zásady stavu.

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

-ApplicationsFilter

Určuje filtr pro podřízené objekty ApplicationHealthState na základě stavu. Hodnotu lze získat ze členů nebo bitové operace na členech HealthStateFilter. Vrátí se pouze podřízené položky, které odpovídají filtru. Všechny podřízené položky se používají k vyhodnocení stavu agregovaného stavu entity. Pokud není zadáno, vrátí se všechny položky.

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

Tento parametr je zastaralý. Místo toho zadejte parametr ApplicationsFilter .

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

-ApplicationTypeHealthPolicyMap

Určuje mapu, která definuje maximální procento aplikací, které nejsou v pořádku, které jsou povolené pro jednotlivé typy aplikací. Typy aplikací v této mapě se vyhodnocují pomocí konkrétních procent místo globálního procenta MaxPercentUnhealthyApplications .

Pokud jsou například některé aplikace typu kritické, může správce clusteru přidat položku do mapy pro tento typ aplikace a přiřadit ji hodnotu 0 % (to znamená, že tolerovat žádné chyby). Všechny ostatní aplikace je možné vyhodnotit pomocí MaxPercentUnhealthyApplications nastavené na 20 % pro tolerování některých selhání z tisíců instancí aplikace.

Mapa zásad stavu typu aplikace se používá pouze v případě, že manifest clusteru povolí vyhodnocení stavu typu aplikace pomocí položky konfigurace pro HealthManager/EnableApplicationTypeHealthEvaluation.

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

-ConsiderWarningAsError

Označuje, jestli se má zpráva o stavu upozornění považovat za chybu během vyhodnocení stavu. Tato hodnota se používá pro vyhodnocení uzlů a sestav stavu clusteru.

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

-EventsFilter

Určuje filtr pro kolekci HealthEvents hlášené v clusteru na základě stavu. Hodnotu lze získat ze členů nebo bitové operace na členech HealthStateFilter. Vrátí se pouze události, které odpovídají filtru. Všechny události slouží k vyhodnocení souhrnného stavu clusteru. Pokud není zadáno, vrátí se všechny položky.

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

Tento parametr je zastaralý. Místo toho zadejte parametr EventsFilter .

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

-ExcludeHealthStatistics

Určuje, jestli by měly být do výsledku dotazu zahrnuty statistiky stavu. Pokud je zadáno, statistika stavu se nevrátí jako součást výsledku dotazu. Jinak výsledek dotazu obsahuje statistiku stavu clusteru, která obsahuje informace o tom, kolik entit je ve stavu OK, Upozornění a Chyba.

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

-IncludeSystemApplicationHealthStatistics

Určuje, jestli by statistika stavu měla obsahovat informace pro aplikaci fabric:/System. Pokud je tato možnost zadaná, aplikace, služba, oddíl, replika, nasazená aplikace a počet nasazených balíčků služeb, zahrnují entity systému. Pokud není zadáno, statistika stavu vrací stav pouze pro uživatelské aplikace.

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

-MaxPercentUnhealthyApplications

Určuje maximální tolerované procento aplikací, které nejsou v pořádku. Pokud existuje více aplikací s agregovaným stavem chyby, než je tolerováno, je stav clusteru chybový. Pokud tento parametr nezadáte, použije vyhodnocení stavu hodnotu uvedenou v manifestu clusteru.

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

-MaxPercentUnhealthyNodes

Určuje maximální tolerované procento uzlů, které nejsou v pořádku. Pokud existuje více uzlů s agregovaným stavem chyby, než je tolerováno, cluster se vyhodnotí jako chyba. Pokud tento parametr nezadáte, použije vyhodnocení stavu hodnotu uvedenou v manifestu clusteru.

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

-NodesFilter

Určuje filtr pro podřízené položky NodeHealthState na základě stavu. Hodnotu lze získat ze členů nebo bitové operace na členech HealthStateFilter. Vrátí se pouze podřízené položky, které odpovídají filtru. Všechny podřízené položky slouží k vyhodnocení agregovaného stavu entity. Pokud není zadáno, vrátí se všechny položky.

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

Tento parametr je zastaralý. Místo toho zadejte parametr NodesFilter .

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

-NodeTypeHealthPolicyMap

Definuje mapu s maximálním procentem uzlů, které nejsou v pořádku pro konkrétní typy uzlů.

Mapování zásad stavu uzlu lze použít během vyhodnocení stavu clusteru k popisu speciálních typů uzlů. Typy uzlů zahrnuté v mapě se vyhodnocují v procentech zahrnutých v mapě a také s globálními hodnotami (viz System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNode). Uzly typů uzlů zadaných v mapě se také počítají do globálního fondu uzlů; jsou nezávislé kontroly.

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

-TimeoutSec

Určuje časový limit operace v sekundách.

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

Vstupy

None

Výstupy

System.Object