Freigeben über

Send-ServiceFabricNodeHealthReport

  • Referenz
Modul:
ServiceFabric

Sendet einen Integritätsbericht auf einem Service Fabric-Knoten.

Syntax

Send-ServiceFabricNodeHealthReport
    [-NodeName] <String>
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Send-ServiceFabricNodeHealthReport sendet einen Integritätsbericht auf einem Service Fabric-Knoten.

Der Knoten muss bereits im Integritätsspeicher vorhanden sein. Um zu überprüfen, ob es vorhanden ist, verwenden Sie das Cmdlet "Get-ServiceFabricNodeHealth ". Alternativ können Sie das Cmdlet Get-ServiceFabricNode verwenden. Wenn das Cmdlet den Knoten abruft und der Knoten den gültigen Integritätszustand aufweist, ist der Knoten im Integritätsspeicher vorhanden.

Das Cmdlet sendet den Bericht nach einem Intervall, das vom HealthReportSendIntervalInSec-Parameter des Cmdlets Connect-ServiceFabricCluster angegeben wurde. Die Clusterverbindung muss während dieser Zeit lebendig gehalten werden. Der Befehl wird auf dem Client ausgewertet, ohne auf den Integritätsspeicher zu verweisen. Der Bericht wird möglicherweise nicht im Integritätsspeicher angewendet, auch wenn der Befehl Erfolg zurückgibt. Beispielsweise kann der Integritätsspeicher den Bericht aufgrund eines ungültigen Parameters wie etwa einer veralteten Sequenznummer ablehnen.

Um zu sehen, ob der Bericht im Integritätsspeicher angewendet wurde, verwenden Sie das Cmdlet Get-ServiceNodeHealth , und überprüfen Sie, ob der Bericht im HealthEvents-Abschnitt angezeigt wird.

Um Service Fabric-Cluster zu verwalten, starten Sie Windows PowerShell mithilfe der Option "Als Administrator ausführen". Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung zum Cluster her, und dann das Cmdlet Get-ServiceClusterConnection .

Beispiele

Beispiel 1: Bericht über fehlerintegrität mit unendlichem TTL

PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "Firewall" -HealthState Error -Description "Firewall rules were not correctly applied"

Dieser Befehl sendet einen Integritätsbericht über den Knoten "Node01" aus der Quelle namens "MyWatchdog". Der Integritätsbericht enthält Informationen über die Integritätseigenschafts-Firewall in einem Fehlerstatus mit unendlichem TTL.

Beispiel 2: Berichtswarnung gültig für angegebene TTL

PS C:\> Send-ServiceFabricNodeHealthReport -NodeName "Node01" -SourceId "MyWatchdog" -HealthProperty "CPU" -HealthState Warning -Description "CPU has been more than 90% for the last hour." -TimeToLiveSec 10 -RemoveWhenExpired

Dieser Befehl sendet einen Integritätsbericht über den Knoten "Node01" aus der Quelle namens "MyWatchdog". Der Integritätsbericht enthält Informationen zur CPU der Integritätseigenschaft in einem Warnungsstatus. Der Befehl enthält auch eine Beschreibung für die Warnung, legt die TTL auf 10 Sekunden fest und konfiguriert den Bericht, der beim Ablauf entfernt werden soll.

Parameter

-Description

Gibt menschliche lesbare Informationen zu der Bedingung an, die den Bericht ausgelöst hat. Die Parameter SourceId, HealthProperty und HealthState beschreiben den Bericht vollständig.

Die maximale Zeichenlänge für die Beschreibung beträgt 4096 Zeichen. Wenn die angegebene Zeichenfolge länger ist, wird sie automatisch abgeschnitten. Beim Abschneiden endet die Beschreibung mit einer Markierung, "[Abgeschnitten]", um benutzern anzugeben, die abgeschnitten wurden. Die Gesamtzeichenfolgengröße beträgt 4096 Zeichen, sodass weniger als 4096 Zeichen aus der ursprünglichen Zeichenfolge beibehalten werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-HealthProperty

Gibt die Eigenschaft des Berichts an. Zusammen mit dem SourceId-Parameter identifiziert diese Eigenschaft den Bericht eindeutig. Der Bericht überschreibt alle vorherigen Berichte mit den gleichen Werten für die Parameter SourceId und HealthProperty auf derselben Entität.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-HealthState

Gibt ein HealthState-Objekt an, das den gemeldeten Integritätszustand darstellt.

Typ:HealthState
Zulässige Werte:Invalid, Ok, Warning, Error, Unknown
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Immediate

Gibt an, ob der Bericht sofort an den Integritätsspeicher gesendet werden soll. Dies ist für kritische Berichte hilfreich, die schnellstmöglich gesendet werden sollen. Wenn nicht angegeben, wird der Bericht basierend auf den Einstellungen für den Integritätsclient gesendet. Aus diesem Grund wird der Bericht entsprechend der HealthReportSendInterval-Konfiguration batchweise verarbeitet. Dies ist die empfohlene Einstellung, da der Integritätsclient die Optimierung von Meldungen des Integritätsberichts für den Integritätsspeicher sowie die Verarbeitung von Integritätsberichten ermöglicht. Standardmäßig legt der Powershell Fabric-Client HealthReportSentInterval auf 0 fest, sodass Berichte sofort gesendet werden.

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

-NodeName

Gibt den Namen eines Service Fabric-Knotens an. Das Cmdlet sendet einen Integritätsbericht auf dem knoten, den Sie angeben.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RemoveWhenExpired

Gibt an, dass der Bericht aus dem Integritätsspeicher entfernt wird, wenn er abläuft. Wenn Sie diesen Parameter nicht angeben, wird die Entität im Fehlerzustand betrachtet, wenn die Berichtszeit abläuft. Die Berichte, die beim Abgelaufenen entfernt werden, können für Bedingungen verwendet werden, die nur für einen Zeitraum gültig sind oder für das Löschen von Berichten aus dem Integritätsspeicher.

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

-SequenceNumber

Gibt die Sequenznummer an, die dem Integritätsbericht zugeordnet ist. Wenn Sie keinen Wert für diesen Parameter angeben, wird die Sequenznummer automatisch festgelegt. Wenn Sie eine Sequenznummer angeben, muss dieser Wert höher sein als jede vorherige Sequenznummer, die auf derselben SourceId und HealthProperty festgelegt ist, oder der Bericht wird aufgrund von Fälligkeit abgelehnt.

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

-SourceId

Gibt den Bezeichner der Quelle an, die den Bericht ausgelöst hat.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

-TimeToLiveSec

Gibt die Zeit für Live (TTL) des Berichts in Sekunden an. Wenn die TTL abläuft, wird der Bericht aus dem Integritätsspeicher entfernt, wenn der Parameter RemoveWhenExpired angegeben wird. Andernfalls wird die Entität aufgrund des abgelaufenen Berichts bei Fehler ausgewertet. Der Standardwert ist Unendlich.

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

Eingaben

System.String

System.Fabric.Health.HealthState

System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Ausgaben

System.Object