Udostępnij przez

Get-ServiceFabricClusterHealth

  • Odwołanie
Moduł:
ServiceFabric

Pobiera informacje o kondycji klastra usługi Service Fabric.

Składnia

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

Opis

Polecenie cmdlet Get-ServiceFabricClusterHealth pobiera informacje o kondycji klastra usługi Service Fabric. Usługa Service Fabric zgłasza następujące stany kondycji:

  • OK. Jednostka spełnia wytyczne dotyczące kondycji.
  • Błąd. Jednostka nie spełnia wytycznych dotyczących kondycji.
  • Ostrzeżenie. Jednostka spełnia wytyczne dotyczące kondycji, ale napotkała jakiś problem.

Zagregowany stan kondycji klastra uwzględnia wszystkie raporty o kondycji klastra, a także zagregowany stan kondycji wszystkich elementów podrzędnych, rekursywnie. Ocena kondycji używa zasad kondycji klastra i zasad kondycji aplikacji każdej aplikacji w klastrze.

Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster .

Przykłady

Przykład 1. Pobieranie kondycji klastra i filtrowanie zwracanych elementów podrzędnych

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

To polecenie wysyła zapytanie do kondycji klastra. Określa filtry, aby zwracać tylko węzły ze stanem kondycji Błąd i aplikacje z ostrzeżeniem lub błędem kondycji.

Przykład 2. Pobieranie kondycji klastra przy użyciu niestandardowych zasad kondycji

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

To polecenie wysyła zapytanie do kondycji klastra i przekazuje je w zasadach niestandardowych.

Przykład 3. Pobieranie kondycji klastra przy użyciu mapy zasad kondycji typu aplikacji

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

To polecenie wykonuje zapytanie o kondycję klastra i przekazuje mapę zasad kondycji typu aplikacji. Typ aplikacji CriticalAppType nie tolerowa żadnych błędów. Pozostałe aplikacje są oceniane przy użyciu 20% maksymalnej kondycji procentu.

Przykład 4. Pobieranie kondycji klastra bez zdarzeń kondycji i bez statystyk kondycji

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

To polecenie wysyła zapytanie do kondycji klastra. Określa filtry, aby wykluczyć wszystkie zdarzenia kondycji i statystyki kondycji.

Przykład 5. Pobieranie kondycji klastra z uwzględnionych statystykami aplikacji fabric:/System

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

To polecenie wysyła zapytanie do kondycji klastra. Statystyki kondycji zwrócone w ramach kondycji klastra zawierają statystyki aplikacji fabric:/System oprócz statystyk aplikacji użytkowników.

Parametry

-ApplicationHealthPolicyMap

Określa obiekt ApplicationHealthPolicyMap , który zawiera niestandardowe zasady kondycji dla niektórych lub wszystkich aplikacji. Jeśli nie określisz tego parametru, ocena kondycji używa zasad kondycji aplikacji zdefiniowanych w manifeście aplikacji lub domyślnych zasad kondycji.

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

-ApplicationsFilter

Określa filtr dla elementów podrzędnych ApplicationHealthState na podstawie stanu kondycji. Wartość można uzyskać z elementów członkowskich lub operacji bitowych na elementach członkowskich HealthStateFilter. Zwracane są tylko elementy podrzędne zgodne z filtrem. Wszystkie elementy podrzędne są używane do oceny zagregowanego stanu kondycji jednostki. Jeśli nie zostanie określony, zwracane są wszystkie wpisy.

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

Ten parametr został przestarzały. Zamiast tego określ parametr ApplicationsFilter .

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

-ApplicationTypeHealthPolicyMap

Określa mapę, która definiuje maksymalny procent aplikacji w złej kondycji dozwolonych dla każdego typu aplikacji. Typy aplikacji na tej mapie są oceniane przy użyciu określonych wartości procentowych, a nie globalnej wartości procentowej MaxPercent W złej kondycjiAplikacje .

Jeśli na przykład niektóre aplikacje typu mają krytyczne znaczenie, administrator klastra może dodać wpis do mapy dla tego typu aplikacji i przypisać mu wartość 0% (czyli nie tolerować żadnych awarii). Wszystkie inne aplikacje można ocenić za pomocą parametru MaxPercentUnhealthyApplications ustawionego na 20%, aby tolerować niektóre błędy z tysięcy wystąpień aplikacji.

Mapa zasad kondycji typu aplikacji jest używana tylko wtedy, gdy manifest klastra umożliwia ocenę kondycji typu aplikacji przy użyciu wpisu konfiguracji healthManager/EnableApplicationTypeHealthEvaluation.

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

-ConsiderWarningAsError

Wskazuje, czy raport kondycji ostrzeżenia ma być traktowany jako błąd podczas oceny kondycji. Ta wartość jest używana do oceny węzłów i raportów kondycji klastra.

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

-EventsFilter

Określa filtr dla kolekcji healthEvents zgłoszonych w klastrze na podstawie stanu kondycji. Wartość można uzyskać z elementów członkowskich lub operacji bitowych na elementach członkowskich HealthStateFilter. Zwracane są tylko zdarzenia zgodne z filtrem. Wszystkie zdarzenia są używane do oceny zagregowanego stanu kondycji klastra. Jeśli nie zostanie określony, zwracane są wszystkie wpisy.

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

Ten parametr został przestarzały. Określ zamiast tego parametr EventsFilter .

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

-ExcludeHealthStatistics

Wskazuje, czy statystyki kondycji powinny być uwzględnione w wyniku zapytania. Jeśli zostanie określony, statystyki kondycji nie zostaną zwrócone w ramach wyniku zapytania. W przeciwnym razie wynik zapytania zawiera statystyki kondycji klastra, które zawierają informacje o liczbą jednostek w stanach Ok, Ostrzeżenie i Błąd.

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

-IncludeSystemApplicationHealthStatistics

Wskazuje, czy statystyki kondycji powinny zawierać informacje dotyczące aplikacji fabric:/System. Jeśli zostanie określona, liczba wdrożonych pakietów usług to aplikacja, usługa, partycja, replika, wdrożona aplikacja i liczba wdrożonych pakietów usług. Jeśli nie zostanie określona, statystyki kondycji zwracają stan kondycji tylko dla aplikacji użytkowników.

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

-MaxPercentUnhealthyApplications

Określa maksymalny tolerowany procent aplikacji w złej kondycji. Jeśli istnieje więcej aplikacji z zagregowanym stanem kondycji błędu niż tolerowane, stan kondycji klastra to błąd. Jeśli nie określisz tego parametru, ocena kondycji używa wartości podanej w manifeście klastra.

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

-MaxPercentUnhealthyNodes

Określa maksymalny tolerowany procent węzłów w złej kondycji. Jeśli istnieje więcej węzłów z zagregowanym stanem kondycji błędu niż tolerowane, klaster jest oceniany jako błąd. Jeśli nie określisz tego parametru, ocena kondycji używa wartości podanej w manifeście klastra.

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

-NodesFilter

Określa filtr dla elementów podrzędnych NodeHealthState na podstawie stanu kondycji. Wartość można uzyskać z elementów członkowskich lub operacji bitowych na elementach członkowskich HealthStateFilter. Zwracane są tylko elementy podrzędne zgodne z filtrem. Wszystkie elementy podrzędne są używane do oceny zagregowanego stanu kondycji jednostki. Jeśli nie zostanie określony, zwracane są wszystkie wpisy.

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

Ten parametr został przestarzały. Zamiast tego określ parametr NodesFilter .

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

-NodeTypeHealthPolicyMap

Definiuje mapę z maksymalnymi wartościami procentowymi węzłów w złej kondycji dla określonych typów węzłów.

Mapa zasad kondycji typu węzła może być używana podczas oceny kondycji klastra w celu opisania specjalnych typów węzłów. Typy węzłów uwzględnione w mapie są oceniane względem wartości procentowej uwzględnionej w mapie, a także z globalnymi (zobacz System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Węzły typów węzłów określonych na mapie są również liczone względem globalnej puli węzłów; są to niezależne kontrole.

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

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

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

Dane wejściowe

None

Dane wyjściowe

System.Object