Send-ServiceFabricReplicaHealthReport
Odešle zprávu o stavu repliky Service Fabric.
Syntax
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-ReplicaId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Send-ServiceFabricReplicaHealthReport
[-PartitionId] <Guid>
-InstanceId <Int64>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
Rutina Send-ServiceFabricReplicaHealthReport odešle zprávu o stavu instance bezstavové služby Service Fabric nebo replikě stavové služby.
Instance bezstavové služby nebo replika stavové služby už musí existovat v úložišti stavu. Pokud chcete zkontrolovat, jestli existuje, použijte rutinu Get-ServiceFabricReplicaHealth a zadejte parametry PartitionId a ReplicaOrInstanceId . Alternativně můžete použít rutinu Get-ServiceFabricPartitionHealth s parametrem PartitionId a pak v části ReplicaHealthStates najít repliku.
Rutina odešle sestavu po intervalu určeném parametrem HealthReportSendIntervalInSec rutiny Connect-ServiceFabricCluster . Během této doby musí být připojení ke clusteru aktivní.
Rutina může vrátit úspěch, ale sestava se odešle asynchronně, takže zpracování může selhat. Pokud chcete zjistit, jestli se sestava použila v úložišti stavu, použijte rutinu Get-ServiceFabricReplicaHealth a zkontrolujte, jestli se sestava zobrazí v části události stavu.
Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .
Příklady
Příklad 1: Hlášení zprávy o stavu chyby u repliky stavové služby s nekonečnou hodnotu TTL
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaId 130464806670632402 -SourceId "MyWatchdog" -HealthProperty "DiskUsage" -HealthState Error -Description "Disk is full"
Tento příkaz odešle sestavu stavu pro zadaný oddíl pro zadanou repliku stavové služby ze zdrojového objektu MyWatchDog. Sestava stavu obsahuje informace o vlastnosti Stav DiskUsage ve stavu Chyby se nekonečnou hodnotu TTL. Tento příkaz také obsahuje popis chyby.
Příklad 2: Hlášení zprávy o stavu upozornění na instanci bezstavové služby platné pro zadanou hodnotu TTL a odebrání po vypršení platnosti
PS C:\> Send-ServiceFabricReplicaHealthReport -PartitionId 1a151ac7-9c25-4528-81fc-4c6bb9909394 -InstanceId 130464806670632403 -SourceId "MyWatchdog" -HealthProperty "Resources" -HealthState Warning -Description "Access to resources is temporarily disabled" -TimeToLiveSec 10 -RemoveWhenExpired
Tento příkaz odešle zprávu o stavu pro zadanou bezstavovou instanci služby ze zdroje MyWatchDog. Sestava stavu obsahuje informace o vlastnosti Health Resources ve stavu upozornění ze zdroje MyWatchdog s 10 sekund TTL. Sestava označená k odebrání při vypršení platnosti.
Parametry
-Description
Určuje čitelné informace o podmínce, která sestavu aktivovala. Parametry SourceId, HealthProperty a HealthState plně popisují sestavu.
Maximální délka řetězce popisu je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení končí popis značkou [Zkráceno]" a značí tak uživatelům, že došlo ke zkrácení. Celková velikost řetězce je 4096 znaků, takže se zachová méně než 4096 znaků z původního řetězce.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthProperty
Určuje vlastnost sestavy. Společně s parametrem SourceId tato vlastnost jedinečně identifikuje sestavu.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Určuje objekt HealthState , který představuje hlášený stav.
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
Určuje, jestli se má sestava okamžitě odeslat do úložiště stavu. To je užitečné pro kritické sestavy, které by se měly co nejdříve odeslat. Pokud není zadáno, sestava se odešle na základě nastavení klienta stavu. Proto se bude dávková podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy o sestavách stavu do úložiště stavu a zpracování sestav stavu. Ve výchozím nastavení klient prostředků infrastruktury PowerShellu nastaví HealthReportSentInterval na hodnotu 0, takže se sestavy odesílají okamžitě.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
Určuje ID bezstavové instance služby. ID instance je platné pouze pro bezstavové služby. Sestava stavové repliky, která používá Id instance místo ReplicaId , je přijata klientem stavu, ale je odmítnuta úložištěm stavu.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionId
Určuje ID oddílu Service Fabric.
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RemoveWhenExpired
Označuje, že sestava se po vypršení platnosti odebere z úložiště stavu. Pokud tento parametr nezadáte, entita se považuje za chybový stav, když vyprší platnost času sestavy naživo. Sestavy, které se odeberou, když vypršela platnost, se dají použít pro podmínky, které jsou platné jenom po určitou dobu, nebo pro vymazání sestav ze služby Health Store.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReplicaId
Určuje ID stavové repliky služby. ID repliky je platné pouze pro stavové služby. Klient stavu přijímá sestavu pro bezstavovou instanci, která používá Id repliky místo InstaceId , ale je odmítnuta úložištěm stavu.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SequenceNumber
Určuje pořadové číslo přidružené k sestavě stavu. Pokud pro tento parametr nezadáte hodnotu, pořadové číslo se nastaví automaticky. Pokud zadáte pořadové číslo, musí být tato hodnota vyšší než jakékoli předchozí pořadové číslo nastavené na stejné entitě pro stejnou hodnotu SourceId a HealthProperty nebo je sestava odmítnuta kvůli nestaralosti.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Určuje identifikátor zdroje, který sestavu aktivoval.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeToLiveSec
Určuje hodnotu TTL (Time to Live) sestavy v sekundách. Pokud vyprší platnost hodnoty TTL, sestava se odebere z úložiště stavu, pokud je zadán parametr RemoveWhenExpired . V opačném případě se entita vyhodnotí jako chyba z důvodu sestavy s vypršenou platností. Výchozí hodnota je Nekonečné.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Vstupy
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]]
Výstupy
System.Object