Udostępnij za pośrednictwem


Get-ServiceFabricApplicationHealth

Pobiera kondycję aplikacji usługi Service Fabric.

Składnia

Get-ServiceFabricApplicationHealth
   [-ApplicationName] <Uri>
   [-ConsiderWarningAsError <Boolean>]
   [-MaxPercentUnhealthyDeployedApplications <Byte>]
   [-MaxPercentUnhealthyServices <Byte>]
   [-MaxPercentUnhealthyPartitionsPerService <Byte>]
   [-MaxPercentUnhealthyReplicasPerPartition <Byte>]
   [-EventsHealthStateFilter <Int64>]
   [-EventsFilter <HealthStateFilter>]
   [-ServicesHealthStateFilter <Int64>]
   [-ServicesFilter <HealthStateFilter>]
   [-DeployedApplicationsHealthStateFilter <Int64>]
   [-DeployedApplicationsFilter <HealthStateFilter>]
   [-ExcludeHealthStatistics]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-ServiceFabricApplicationHealth pobiera stan kondycji aplikacji 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.

Jeśli jednostka nie zostanie znaleziona w magazynie kondycji, to polecenie cmdlet zwróci błąd.

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 aplikacji

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist

To polecenie wykonuje zapytanie dotyczące kondycji nazwanej aplikacji.

Przykład 2. Pobieranie kondycji aplikacji przy użyciu niestandardowych zasad kondycji i zwracanych filtrów

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ConsiderWarningAsError $True -EventsFilter Error -ServicesFilter 'Error,Warning' -DeployedApplicationsFilter 'Warning,Error'

To polecenie wykonuje zapytanie dotyczące kondycji nazwanej aplikacji. Polecenie określa wartości zasad kondycji i używa filtrów do zwracania tylko zdarzeń błędu oraz elementów podrzędnych ze stanami kondycji Błąd lub Ostrzeżenie.

Przykład 3. Pobieranie kondycji aplikacji i wykluczanie statystyk kondycji

PS C:\> Get-ServiceFabricApplicationHealth -ApplicationName fabric:/myapp/persistenttodolist -ExcludeHealthStatistics

To polecenie wykonuje zapytanie dotyczące kondycji nazwanej aplikacji. Zwrócona kondycja aplikacji nie zawiera statystyk kondycji.

Parametry

-ApplicationName

Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric. Polecenie cmdlet pobiera informacje o kondycji dla aplikacji, która ma określony identyfikator URI.

Typ:Uri
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ConsiderWarningAsError

Wskazuje, czy to polecenie cmdlet uwzględnia raport kondycji ostrzeżenia jako błąd podczas oceny kondycji.

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

-DeployedApplicationsFilter

Określa filtr DeployedApplicationHealthState elementów podrzędnych na podstawie stanu kondycji. Wartość jest uzyskiwana 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 aplikacji. 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

-DeployedApplicationsHealthStateFilter

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

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

-EventsFilter

Określa filtr kolekcji obiektów HealthEvent zgłoszonych w aplikacji 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 aplikacji. 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 aplikacji, które zawierają informacje o tylu usługach, partycjach i replikach tej aplikacji są 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

-MaxPercentUnhealthyDeployedApplications

Określa maksymalną tolerowaną wartość procentową wystąpień aplikacji w złej kondycji wdrożonych w węzłach w klastrze. Jeśli istnieje więcej wdrożonych aplikacji z błędem stanu kondycji niż tolerowane, stan kondycji aplikacji to błąd. Jeśli nie określisz tego parametru, ocena kondycji używa wartości podanej w manifeście aplikacji.

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

-MaxPercentUnhealthyPartitionsPerService

Określa maksymalną tolerowaną wartość procentową partycji usługi w złej kondycji. Jeśli występuje więcej partycji z błędem stanu kondycji niż tolerowane, stan kondycji usług to błąd. Jeśli nie określisz tego parametru, ocena kondycji używa wartości podanej w manifeście aplikacji.

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

-MaxPercentUnhealthyReplicasPerPartition

Określa maksymalną tolerowaną wartość procentową replik partycji w złej kondycji. Jeśli istnieje więcej replik z błędem stanu kondycji niż tolerowane, stan kondycji partycji to błąd. Jeśli nie określisz tego parametru, ocena kondycji używa wartości podanej w manifeście aplikacji.

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

-MaxPercentUnhealthyServices

Określa maksymalną tolerowaną wartość procentową usług w złej kondycji w aplikacji. Jeśli istnieje więcej usług z błędem stanu kondycji niż tolerowane, stan kondycji aplikacji to błąd. Jeśli nie określisz tego parametru, ocena kondycji używa wartości podanej w manifeście aplikacji.

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

-ServicesFilter

Określa filtr dla ServiceHealthState elementów podrzędnych 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 aplikacji. 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

-ServicesHealthStateFilter

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

Typ:Int64
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

System.Uri

Dane wyjściowe

System.Object