Freigeben über


Send-ServiceFabricPartitionHealthReport

Sendet einen Integritätsbericht auf einer Service Fabric-Dienstpartition.

Syntax

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

Beschreibung

Das cmdlet Send-ServiceFabricPartitionHealthReport sendet einen Integritätsbericht auf einer Service Fabric-Dienstpartition.

Die Partition muss bereits im Integritätsspeicher vorhanden sein. Um zu überprüfen, ob es vorhanden ist, verwenden Sie das Cmdlet Get-ServiceFabricPartitionHealth, und geben Sie die Partitions-ID an. Alternativ können Sie das Cmdlet Get-ServiceFabricServiceHealth verwenden und den Abschnitt "Partitionsstatus" überprüfen, um die Partition zu finden.

Das Cmdlet sendet den Bericht nach einem Intervall, das vom HealthReportSendIntervalInSec Parameter des Cmdlets Connect-ServiceFabricCluster angegeben wird. Die Clusterverbindung muss während dieser Zeit aktiv gehalten werden.

Das Cmdlet kann Erfolg zurückgeben, der Bericht wird jedoch asynchron gesendet, sodass die Verarbeitung fehlschlägt. Um festzustellen, ob der Bericht im Integritätsspeicher angewendet wurde, verwenden Sie das Cmdlet Get-ServiceFabricPartitionHealth, und überprüfen Sie, ob der Bericht im Abschnitt "HealthEvents" angezeigt wird.

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: Melden des Fehlerstatusberichts mit unendlicher TTL

PS C:\> Send-ServiceFabricPartitionHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Dieser Befehl sendet einen Integritätsbericht über die angegebene Partition aus der Quelle MyWatchdog. Der Integritätsbericht enthält Informationen zur Integritätseigenschaft Verfügbarkeit in einem Fehlerstatus mit unendlicher TTL.

Beispiel 2: Warnung melden, die für angegebene TTL gültig ist, und entfernen Sie sie, wenn sie abläuft.

PS C:\> Send-ServiceFabricPartitionHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -SourceId "MyWatchdog" -HealthProperty "ReplicaSet" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "The communication between replicas have high latency."

Dieser Befehl sendet einen Integritätsbericht über die angegebene Partition aus der Quelle MyWatchdog. Der Integritätsbericht enthält Informationen zur Integritätseigenschaft ReplicaSet- in einem Status "Warnung" mit 10 Sekunden TTL. Der Bericht ist für das Entfernen am Ablauf markiert.

Parameter

-Description

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

Die maximale Zeichenfolgenlänge für die Beschreibung beträgt 4096 Zeichen. Wenn die angegebene Zeichenfolge länger ist, wird sie automatisch abgeschnitten. Wenn die Beschreibung abgeschnitten wurde, endet die Beschreibung mit einer Markierung ,[Abgeschnitten]", um benutzern anzugeben, dass die Abkürzung erfolgt ist. Die Gesamtgröße der Zeichenfolge 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 denselben Werten für die SourceId- und HealthProperty Parameter für dieselbe 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 nützlich für kritische Berichte, die so schnell wie möglich gesendet werden sollten. Wenn nicht angegeben, wird der Bericht basierend auf den Einstellungen des Integritätsclients gesendet. Daher wird sie gemäß der HealthReportSendInterval-Konfiguration batched. Dies ist die empfohlene Einstellung, da der Integritätsclient die Optimierung von Integritätsberichtsmeldungen an 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

-PartitionId

Gibt die ID einer Service Fabric-Partition an.

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

-RemoveWhenExpired

Gibt an, dass der Bericht beim Ablauf aus dem Integritätsspeicher entfernt wird. Wenn Sie diesen Parameter nicht angeben, wird die Entität im Fehlerzustand betrachtet, wenn die Berichtszeit abläuft. Die Berichte, die nach ablaufendem Ablauf entfernt werden, können für Bedingungen verwendet werden, die nur für einen bestimmten 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 demselben SourceId- und HealthProperty-festgelegt ist, oder der Bericht wird aufgrund der Veraltetkeit 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 für den Vorgang in Sekunden 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 der TTL-Wert abläuft, wird der Bericht aus dem Integritätsspeicher entfernt, wenn der RemoveWhenExpired Parameter angegeben ist. Andernfalls wird die Entität aufgrund des abgelaufenen Berichts bei Fehler ausgewertet. Der Standardwert ist Infinite.

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

Eingaben

System.Guid

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