Sdílet prostřednictvím

Get-ServiceFabricClusterHealth

  • Reference
Modul:
ServiceFabric

Získá informace o stavu pro cluster Service Fabric.

Syntaxe

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.
  • Varování. Entita splňuje pokyny pro stav, ale došlo k nějakému problému.

Agregovaný stav clusteru bere v úvahu všechny sestavy o stavu clusteru i 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 se dotazuje na stav clusteru. Určuje filtry tak, aby vracely pouze uzly se stavem Chyba stavu a aplikace s upozorněním stavu 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 se dotazuje na 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 se dotazuje na 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 procenta, které není 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 se dotazuje na stav clusteru. Určuje filtry pro vyloučení všech událostí stavu a statistik stavu.

Příklad 5: Získání stavu clusteru se zahrnutými statistikami prostředků infrastruktury:/Systémové statistiky aplikací

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

Tento příkaz se dotazuje na stav clusteru. Statistiky stavu vrácené jako součást stavu clusteru obsahují kromě statistik uživatelských aplikací také statistiky 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.

Typ:ApplicationHealthPolicyMap
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationsFilter

Určuje filtr pro ApplicationHealthState podřízené položky na základě stavu. Hodnotu lze získat ze členů nebo bitové operace u členů HealthStateFilter. Vrátí se jenom 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.

Typ:HealthStateFilter
Přípustné hodnoty:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationsHealthStateFilter

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

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeHealthPolicyMap

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

Pokud jsou například některé aplikace typu kritické, může správce clusteru přidat položku do mapy pro daný typ aplikace a přiřadit ji hodnotě 0% (to znamená, že netoleruje žádné chyby). Všechny ostatní aplikace je možné vyhodnotit pomocí MaxPercentUnhealthyApplications nastavená na 20%, aby bylo možné tolerovat některá 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.

Typ:ApplicationTypeHealthPolicyMap
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ConsiderWarningAsError

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

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 u členů HealthStateFilter. Vrátí se pouze události, které odpovídají filtru. Všechny události se používají k vyhodnocení agregovaného stavu clusteru. Pokud není zadáno, vrátí se všechny položky.

Typ:HealthStateFilter
Přípustné hodnoty:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EventsHealthStateFilter

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

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ExcludeHealthStatistics

Určuje, jestli se má statistika stavu zahrnout do výsledku dotazu. Pokud je zadáno, statistika stavu se nevrátí jako součást výsledku dotazu. V opačném případě výsledek dotazu obsahuje statistiky stavu clusteru, které obsahují informace o tom, kolik entit je ve stavu OK, Upozornění a Chyba.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-IncludeSystemApplicationHealthStatistics

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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 chybný. Pokud tento parametr nezadáte, použije vyhodnocení stavu hodnotu uvedenou v manifestu clusteru.

Typ:Byte
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Byte
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NodesFilter

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

Typ:HealthStateFilter
Přípustné hodnoty:Default, None, Ok, Warning, Error, All
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NodesHealthStateFilter

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

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NodeTypeHealthPolicyMap

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

Mapu zásad stavu typu uzlu je možné použít při vyhodnocování stavu clusteru k popisu speciálních typů uzlů. Typy uzlů zahrnuté v mapě se vyhodnocují s procentem zahrnutým v mapě a také s globálními hodnotami (viz System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Uzly typů uzlů zadaných v mapě se také počítají do globálního fondu uzlů; jsou nezávislé kontroly.

Typ:NodeTypeHealthPolicyMap
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeoutSec

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

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Object