Send-ServiceFabricServiceHealthReport
Odešle zprávu o stavu služby Service Fabric.
Syntax
Send-ServiceFabricServiceHealthReport
[-ServiceName] <Uri>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Rutina Send-ServiceFabricServiceHealthReport odešle zprávu o stavu služby Service Fabric.
Služba by již měla existovat v úložišti stavu. Pokud chcete zkontrolovat, jestli existuje, použijte rutinu Get-ServiceFabricServiceHealth a zadejte parametr ServiceName . Případně můžete pomocí rutiny Get-ServiceFabricApplicationHealth získat informace o aplikaci a pak zkontrolovat část stavu služby a najít požadovanou službu.
Sestava se odešle po počtu sekund zadaných v parametru 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-ServiceFabricServiceHealth a zkontrolujte, jestli se sestava zobrazí v části HealthEvents.
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: Sestava stavu chyby s nekonečným TTL
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error -Description "The service is not available."Tento příkaz odešle zprávu o stavu pro službu s názvem fabric:/MyApplication/MyService ze zdroje MyWatchDog. Sestava stavu obsahuje informace o dostupnosti vlastnosti stavu ve stavu chyby s neomezenou hodnotu TTL. Tento příkaz také obsahuje popis chyby.
Příklad 2: Upozornění sestavy platné pro zadanou hodnotu TTL
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "PrivateData" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "Accessing private data in database MyServicePrivateData is slow."Tento příkaz odešle zprávu o stavu služby s názvem fabric:/MyApplication/MyService ze zdrojového objektu MyWatchdog. Sestava stavu obsahuje informace o vlastnosti Health PrivateData ve stavu upozornění s 10 sekund TTL a označí sestavu pro odebrání po 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í. Když se zkrátí, popis končí značkou "[Zkráceno]", aby značil 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 sestava má 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ávkot podle konfigurace HealthReportSendInterval. Toto je doporučené nastavení, protože umožňuje klientovi stavu optimalizovat zprávy o stavu pro ukládání 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 |
-RemoveWhenExpired
Označuje, že se sestava odebere z úložiště stavu, když vyprší její platnost. Pokud tento parametr nezadáte, entita se považuje za chybový stav, když vyprší platnost času sestavy naživo. Sestavy, které jsou odebrány při vypršení platnosti, se dají použít pro podmínky, které jsou platné jenom po 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 |
-SequenceNumber
Určuje pořadové číslo přidružené ke zprávě o stavu. Pokud pro tento parametr nezadáte hodnotu, nastaví se pořadové číslo automaticky. Pokud zadáte pořadové číslo, musí být tato hodnota vyšší než jakékoli předchozí pořadové číslo nastavené na stejné Id zdroje a HealthProperty nebo je sestava odmítnuta kvůli zastaralému stavu.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ServiceName
Určuje identifikátor URI (Uniform Resource Identifier) služby Service Fabric.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 zadaný parametr RemoveWhenExpired . V opačném případě se entita vyhodnotí jako chyba kvůli sestavě s prošlou 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.Uri
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