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:

  • OK. 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 wurden einige Probleme aufgetreten.

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

Bevor Sie einen Vorgang in 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 von zurückgegebenen untergeordneten Elementen

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

Dieser Befehl ruft die Integrität des Clusters ab. Es gibt Filter an, um nur Knoten mit Integritätsstatusfehler und Anwendungen mit Integritätsstatuswarnung oder Fehler zurückzugeben.

Beispiel 2: Abrufen der Integrität des Clusters mithilfe benutzerdefinierter 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

In diesem Befehl wird die Integrität des Clusters abfragt und in benutzerdefinierten Richtlinien übergeben.

Beispiel 3: Abrufen der Integrität des Clusters mithilfe einer Anwendungstypintegritä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

In diesem Befehl wird die Integrität des Clusters abfragt und in einer Integritätsrichtlinie des Anwendungstyps übergeben. Der Anwendungstyp CriticalAppType toleriert keine Fehler. Die restlichen Anwendungen werden mit maximal 20 % ungesunden 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 ruft die Integrität des Clusters ab. Es gibt Filter an, um Integritätsereignisse und Integritätsstatistiken auszuschließen.

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

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

Dieser Befehl ruft die Integrität des Clusters ab. Die Integritätsstatistiken, die als Teil der Clusterintegrität zurückgegeben werden, enthalten die Fabric:/Systemanwendungsstatistiken, zusätzlich zu den Benutzeranwendungen statistiken.

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ätsbewertung 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-Untergeordnete basierend auf dem Integritätszustand an. Der Wert kann von Mitgliedern oder Bitzeigervorgängen auf Mitgliedern von HealthStateFilter abgerufen werden. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Integritätszustand der Entität zu bewerten. Ist kein Filter 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 wurde 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 ungesunden Anwendungen definiert, die pro Anwendungstyp zulässig sind. Anwendungstypen in dieser Karte werden mithilfe bestimmter Prozentsätze und nicht mit dem globalen MaxPercentUnhealthyApplications-Prozentsatz ausgewertet.

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

Die Zuordnung der Anwendungstyp-Integritätsrichtlinie wird nur verwendet, wenn das Clustermanifest die Integritätsbewertung des Anwendungstyps mithilfe des Konfigurationseintrags für HealthManager/EnableApplicationTypeHealthValuierung ermö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ätsbewertung 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, die auf dem Cluster basierend auf dem Integritätszustand gemeldet wurden. Der Wert kann von Mitgliedern oder Bitzeigervorgängen auf Mitgliedern von HealthStateFilter abgerufen werden. Es werden nur Ereignisse zurückgegeben, die dem Filter entsprechen. Alle Ereignisse werden verwendet, um den aggregierten Integritätszustand des Clusters zu bewerten. Ist kein Filter 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 wurde veraltet. Geben Sie stattdessen den Parameter "EventsFilter " 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 Abfrageergebniss zurückgegeben. Andernfalls enthält das Abfrageergebnis die Clusterintegritätsstatistiken, die Informationen darüber enthalten, wie viele Entitäten in "Ok", "Warnung" und "Fehlerzustände" 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:/Systemanwendung enthalten sollten. Wenn angegeben, umfassen die Anwendungs-, Dienst-, Partitions-, Replikat-, bereitstellungsanwendungs- und bereitgestellten Dienstpaketanzahlen die System-Entitäten. Wenn nicht angegeben, gibt die Integritätsstatistik nur für Benutzeranwendungen den Integritätsstatus zurück.

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

-MaxPercentUnhealthyApplications

Gibt den maximal zulässigen Prozentsatz von ungesunden Anwendungen an. Wenn mehr Anwendungen mit dem aggregierten Integritätszustand des Fehlers vorhanden sind als toleriert, ist der Integritätszustand des Clusters Fehler. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsbewertung den wert, der im Clustermanifest bereitgestellt wird.

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

-MaxPercentUnhealthyNodes

Gibt den maximal zulässigen Prozentsatz von ungesunden Knoten an. Wenn mehr Knoten mit dem aggregierten Integritätszustand des Fehlers vorhanden sind als zulässig, wird der Cluster als Fehler ausgewertet. Wenn Sie diesen Parameter nicht angeben, verwendet die Integritätsbewertung den wert, der im Clustermanifest bereitgestellt wird.

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

-NodesFilter

Gibt den Filter für KnotenHealthState-Untergeordnete basierend auf dem Integritätszustand an. Der Wert kann von Mitgliedern oder Bitzeigervorgängen auf Mitgliedern von HealthStateFilter abgerufen werden. Nur untergeordnete Elemente, die dem Filter entsprechen, werden zurückgegeben. Alle untergeordneten Elemente werden verwendet, um den Status der entitätsaggregaten Integrität zu bewerten. Ist kein Filter 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 wurde veraltet. Geben Sie stattdessen den KnotenFilter-Parameter an.

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

-NodeTypeHealthPolicyMap

Definiert eine Karte mit maximalen Prozentsätzen für ungesunde Knoten für bestimmte Knotentypen.

Die Zuordnung der Knotentyp-Integritätsrichtlinie kann während der Clusterintegritätsevaluierung verwendet werden, um spezielle Knotentypen zu beschreiben. Die in der Karte enthaltenen Knotentypen werden mit dem Prozentsatz 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 in Sekunden für den Vorgang an.

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

Eingaben

None

Ausgaben

System.Object