Freigeben über

Get-ServiceFabricClusterHealth

  • Referenz
Modul:
ServiceFabric

Ruft Integritätsinformationen für einen Service Fabric-Cluster ab.

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

Beschreibung

Das cmdlet Get-ServiceFabricClusterHealth ruft Integritätsinformationen für einen Service Fabric-Cluster ab. Service Fabric meldet die folgenden Integritätszustände:

  • OKAY. Die Entität erfüllt Integritätsrichtlinien.
  • Fehler. Die Entität erfüllt keine Integritätsrichtlinien.
  • Warnung. Die Entität erfüllt Integritätsrichtlinien, aber es gab ein Problem.

Der aggregierte Integritätszustand des Clusters berücksichtigt alle Integritätsberichte des Clusters sowie den aggregierten Integritätszustand aller untergeordneten Elemente rekursiv. Die Integritätsauswertung verwendet die Clusterintegritätsrichtlinie und die Anwendungsintegritätsrichtlinie jeder Anwendung im Cluster.

Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Abrufen der Integrität des Clusters und Filtern zurückgegebener untergeordneter Elemente

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

Dieser Befehl fragt die Integrität des Clusters ab. Es gibt Filter an, die nur Knoten mit Integritätsstatusfehler und Anwendungen mit Integritätszustandswarnung oder -fehler zurückgeben.

Beispiel 2: Abrufen der Integrität des Clusters mithilfe von benutzerdefinierten Integritätsrichtlinien

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

Dieser Befehl fragt die Integrität des Clusters ab und übergibt benutzerdefinierte Richtlinien.

Beispiel 3: Abrufen der Integrität des Clusters mithilfe einer Anwendungstyp-Integritätsrichtlinienzuordnung

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

Dieser Befehl fragt die Integrität des Clusters ab und übergibt eine Integritätsrichtlinienzuordnung des Anwendungstyps. Der Anwendungstyp CriticalAppType toleriert keine Fehler. Die restlichen Anwendungen werden mit 20% maximal fehlerhaften Prozent ausgewertet.

Beispiel 4: Abrufen der Integrität des Clusters ohne Integritätsereignisse und ohne Integritätsstatistiken

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

Dieser Befehl fragt die Integrität des Clusters ab. Es gibt Filter an, um alle Integritätsereignisse und die Integritätsstatistiken auszuschließen.

Beispiel 5: Abrufen der Integrität des Clusters mit Fabric:/Systemanwendungsstatistiken

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

Dieser Befehl fragt die Integrität des Clusters ab. Die im Rahmen der Clusterintegrität zurückgegebenen Integritätsstatistiken enthalten zusätzlich zu den Benutzeranwendungen statistiken die Fabric:/System-Anwendungsstatistiken.

Parameter

-ApplicationHealthPolicyMap

Gibt das ApplicationHealthPolicyMap- -Objekt an, das benutzerdefinierte Integritätsrichtlinien für einige oder alle Anwendungen enthält. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung die im Anwendungsmanifest oder in der Standardintegritätsrichtlinie definierten Anwendungsintegritätsrichtlinien.

Typ:ApplicationHealthPolicyMap
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationsFilter

Gibt den Filter für ApplicationHealthState- untergeordneten Elemente basierend auf dem Integritätszustand an. Der Wert kann aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen werden. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Aggregierten Integritätsstatus der Entität auszuwerten. Wenn nicht angegeben, werden alle Einträge zurückgegeben.

Typ:HealthStateFilter
Zulässige Werte:Default, None, Ok, Warning, Error, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationsHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den ApplicationsFilter Parameter an.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationTypeHealthPolicyMap

Gibt die Zuordnung an, die den maximalen Prozentsatz von fehlerhaften Anwendungen definiert, die pro Anwendungstyp zulässig sind. Anwendungstypen in dieser Zuordnung werden mithilfe bestimmter Prozentsätze und nicht mit dem globalen MaxPercentUnhealthyApplications Prozentsatz ausgewertet.

Wenn beispielsweise einige Anwendungen eines Typs kritisch sind, kann der Clusteradministrator der Zuordnung für diesen Anwendungstyp einen Eintrag hinzufügen und ihm den Wert 0% zuweisen (d. h. keine Fehler tolerieren). Alle anderen Anwendungen können mit MaxPercentUnhealthyApplications ausgewertet werden, auf 20% festgelegt sind, um einige Fehler aus den Tausenden von Anwendungsinstanzen zu tolerieren.

Die Zuordnung der Anwendungstypintegritätsrichtlinien wird nur verwendet, wenn das Clustermanifest die Bewertung des Anwendungstyps mithilfe des Konfigurationseintrags für HealthManager/EnableApplicationTypeHealthEvaluationermöglicht.

Typ:ApplicationTypeHealthPolicyMap
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConsiderWarningAsError

Gibt an, ob ein Warnungsstatusbericht während der Integritätsauswertung als Fehler behandelt werden soll. Dieser Wert wird für die Auswertung von Knoten- und Clusterintegritätsberichten verwendet.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EventsFilter

Gibt den Filter für die Auflistung von HealthEvents an, basierend auf dem Integritätszustand auf dem Cluster gemeldet wurde. Der Wert kann aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen werden. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den aggregierten Integritätszustand des Clusters auszuwerten. Wenn nicht angegeben, werden alle Einträge zurückgegeben.

Typ:HealthStateFilter
Zulässige Werte:Default, None, Ok, Warning, Error, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EventsHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den EventsFilter Parameter an.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExcludeHealthStatistics

Gibt an, ob die Integritätsstatistiken in das Abfrageergebnis einbezogen werden sollen. Wenn angegeben, werden die Integritätsstatistiken nicht als Teil des Abfrageergebnisses zurückgegeben. Andernfalls enthält das Abfrageergebnis die Clusterintegritätsstatistiken, die Informationen dazu enthalten, wie viele Entitäten in "Ok", "Warnung" und "Fehler" enthalten.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeSystemApplicationHealthStatistics

Gibt an, ob die Integritätsstatistiken Informationen für die Fabric:/System-Anwendung enthalten sollen. Wenn angegeben, umfassen die Anzahl der Anwendungen, Dienste, Partitionen, Replikate, bereitgestellten Anwendungen und bereitgestellten Dienstpaketanzahlen die Systementitäten. Wenn nicht angegeben, gibt die Integritätsstatistik nur für Benutzeranwendungen Integritätsstatus zurück.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxPercentUnhealthyApplications

Gibt den maximalen tolerierten Prozentsatz von fehlerhaften Anwendungen an. Wenn mehr Anwendungen mit einem aggregierten Integritätsstatus als toleriert vorhanden sind, ist der Integritätszustand des Clusters ein Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung den im Clustermanifest bereitgestellten Wert.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxPercentUnhealthyNodes

Gibt den maximal tolerierten Prozentsatz von fehlerhaften Knoten an. Wenn mehr Knoten mit einem aggregierten Integritätsstatus vorhanden sind als toleriert, wird der Cluster als Fehler ausgewertet. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsauswertung den im Clustermanifest bereitgestellten Wert.

Typ:Byte
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodesFilter

Gibt den Filter für NodeHealthState untergeordneten Elemente basierend auf dem Integritätszustand an. Der Wert kann aus Membern oder bitweisen Vorgängen für Elemente von HealthStateFilterabgerufen werden. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Aggregierten Integritätsstatus der Entität auszuwerten. Wenn nicht angegeben, werden alle Einträge zurückgegeben.

Typ:HealthStateFilter
Zulässige Werte:Default, None, Ok, Warning, Error, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodesHealthStateFilter

Dieser Parameter ist veraltet. Geben Sie stattdessen den NodesFilter Parameter an.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NodeTypeHealthPolicyMap

Definiert eine Zuordnung mit maximalen Prozentsätzen für fehlerhafte Knoten für bestimmte Knotentypen.

Die Knotentyp-Integritätsrichtlinienzuordnung kann während der Clusterintegritätsbewertung verwendet werden, um spezielle Knotentypen zu beschreiben. Die knotentypen, die in der Karte enthalten sind, werden anhand des prozentsatzes ausgewertet, der in der Karte enthalten ist, und auch mit der globalen (siehe System.Fabric.Health.ClusterHealthPolicy.MaxPercentUnhealthyNodes). Die Knoten von Knotentypen, die in der Karte angegeben sind, werden auch für den globalen Knotenpool gezählt; sie sind unabhängige Prüfungen.

Typ:NodeTypeHealthPolicyMap
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object