Udostępnij za pośrednictwem

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 wystąpił 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 dla 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 wykonuje zapytanie dotyczące kondycji klastra. Określa filtry, aby zwracać tylko węzły ze stanem kondycji Błąd i aplikacje ze stanem kondycji Ostrzeżenie lub Błąd.

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 wykonuje zapytanie dotyczące 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 dotyczące kondycji klastra i przekazuje mapę zasad kondycji typu aplikacji. Typ aplikacji CriticalAppType nie toleruje ż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 wykonuje zapytanie dotyczące 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 wykonuje zapytanie dotyczące 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 zawierający 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.

Typ:ApplicationHealthPolicyMap
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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żą do oceny zagregowanego stanu kondycji jednostki. Jeśli nie zostanie określony, zwracane są wszystkie wpisy.

Typ:HealthStateFilter
Dopuszczalne wartości:Default, None, Ok, Warning, Error, All
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationsHealthStateFilter

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

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationTypeHealthPolicyMap

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

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ą MaxPercentUnhealthyApplications ustawioną na 20%, aby tolerować niektóre awarie 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 dla HealthManager/EnableApplicationTypeHealthEvaluation.

Typ:ApplicationTypeHealthPolicyMap
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EventsFilter

Określa filtr dla kolekcji HealthEvents zgłaszane 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.

Typ:HealthStateFilter
Dopuszczalne wartości:Default, None, Ok, Warning, Error, All
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EventsHealthStateFilter

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

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ExcludeHealthStatistics

Wskazuje, czy statystyki kondycji powinny być uwzględnione w wyniku zapytania. Jeśli zostanie określony, statystyki kondycji nie są zwracane 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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IncludeSystemApplicationHealthStatistics

Wskazuje, czy statystyki kondycji powinny zawierać informacje dotyczące aplikacji fabric:/System. W przypadku określenia liczby aplikacji, usługi, partycji, repliki, wdrożonej aplikacji i wdrożonych pakietów usługi obejmują jednostki systemowe. Jeśli nie zostanie określony, statystyki kondycji zwracają stan kondycji tylko dla aplikacji użytkowników.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxPercentUnhealthyApplications

Określa maksymalną tolerowaną wartość procentową aplikacji w złej kondycji. Jeśli istnieje więcej aplikacji ze 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.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxPercentUnhealthyNodes

Określa maksymalną tolerowaną wartość procentową węzłów w złej kondycji. Jeśli istnieje więcej węzłów ze 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.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:HealthStateFilter
Dopuszczalne wartości:Default, None, Ok, Warning, Error, All
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NodesHealthStateFilter

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

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 zawarte w mapie są oceniane względem wartości procentowej uwzględnionej w mapie, a także z globalnym (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.

Typ:NodeTypeHealthPolicyMap
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

System.Object