Freigeben über

Send-ServiceFabricClusterHealthReport

  • Referenz
Modul:
ServiceFabric

Sendet einen Integritätsbericht zu einem Service Fabric-Cluster.

Syntax

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

Beschreibung

Das Cmdlet Send-ServiceFabricClusterHealthReport sendet einen Integritätsbericht auf einem Service Fabric-Cluster.

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-ServiceClusterHealth , 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-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Dieser Befehl sendet einen Integritätsbericht über den Cluster aus der Quelle MyWatchdog. Der Integritätsbericht enthält Informationen zur Verfügbarkeit der Integritätseigenschaft in einem Fehlerstatus mit unendlichem TTL.

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

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "EnoughNodes" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -SequenceNumber 1344

Dieser Befehl sendet einen Integritätsbericht über den Cluster aus der Quelle MyWatchDog. Der Integritätsbericht enthält Informationen über die Integritätseigenschaft EnoughNodes in einem Warnungsstatus . Der Bericht bleibt für 10 Sekunden im Integritätsspeicher, nachdem er automatisch entfernt wird. Der Befehl gibt den SequenceNumber-Parameter an. Die Sequenznummer muss höher sein als alle zuvor gemeldeten Sequenznummern für dieselbe SourceId und Eigenschaft, oder der Bericht wird aufgrund von Fälligkeit abgelehnt.

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HealthState

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

Type:HealthState
Accepted values:Invalid, Ok, Warning, Error, Unknown
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

System.Fabric.Health.HealthState

System.String

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