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