HealthEvent

  • Článek

Představuje informace o stavu hlášené u entity stavu, jako je cluster, aplikace nebo uzel, s dalšími metadaty přidanými Správcem stavu.

Vlastnosti

Název Typ Vyžadováno
SourceId řetězec Yes
Property řetězec Yes
HealthState string (výčet) Ano
TimeToLiveInMilliSeconds string (duration) No
Description řetězec No
SequenceNumber řetězec No
RemoveWhenExpired boolean Ne
HealthReportId řetězec No
IsExpired boolean Ne
SourceUtcTimestamp string (datum a čas) Ne
LastModifiedUtcTimestamp string (datum a čas) Ne
LastOkTransitionAt string (datum a čas) No
LastWarningTransitionAt string (datum a čas) Ne
LastErrorTransitionAt string (datum a čas) Ne

SourceId

Typ: řetězec
Povinné: Ano

Název zdroje, který identifikuje komponentu klienta, watchdog nebo systému, která vygenerovala informace o stavu.

Property

Typ: řetězec
Povinné: Ano

Vlastnost informací o stavu. Entita může mít sestavy stavu pro různé vlastnosti. Vlastnost je řetězec, nikoli pevný výčet, který umožňuje zpravodaji flexibilitu kategorizovat stav podmínku, která aktivuje sestavu. Například reportér s Id zdroje "LocalWatchdog" může monitorovat stav dostupného disku na uzlu, aby mohl na tomto uzlu hlásit vlastnost AvailableDisk. Stejný zpravodaj může monitorovat připojení uzlu, takže může nahlásit vlastnost "Připojení" na stejném uzlu. V úložišti stavů se tyto sestavy považují za samostatné události stavu pro zadaný uzel.

Spolu s SourceId vlastnost jednoznačně identifikuje informace o stavu.

HealthState

Typ: řetězec (výčet)
Povinné: Ano

Stav entity Service Fabric, jako je cluster, uzel, aplikace, služba, oddíl, replika atd.

Možné hodnoty:

  • Invalid – Označuje neplatný stav. Všechny výčty Service Fabric mají neplatný typ. Hodnota je nula.
  • Ok - Indikuje, že je stav v pořádku. Hodnota je 1.
  • Warning – Označuje stav na úrovni upozornění. Hodnota je 2.
  • Error – Označuje, že stav je na úrovni chyby. Měl by se prověřit stav chyby, protože může mít vliv na správnou funkčnost clusteru. Hodnota je 3.
  • Unknown – Označuje neznámý stav. Hodnota je 65535.

TimeToLiveInMilliSeconds

Typ: řetězec (doba trvání)
Povinné: Ne

Doba, po kterou je tato zpráva o stavu platná. Toto pole používá k určení doby trvání formát ISO8601. Když klienti pravidelně hlásí sestavy, měli by posílat sestavy s vyšší frekvencí, než je hodnota TTL (Time to Live). Pokud klienti hlásí přechod, můžou nastavit hodnotu TTL (Time to Live) na nekonečnou hodnotu. Když vyprší hodnota Time to Live, událost stavu, která obsahuje informace o stavu, se buď odebere z úložiště stavů, pokud má RemoveWhenExpired hodnotu true, nebo se vyhodnotí jako chyba, pokud RemoveWhenExpired false.

Pokud není zadaný, hodnota Time to Live bude ve výchozím nastavení nekonečná.

Description

Typ: řetězec
Povinné: Ne

Popis informací o zdravotním stavu. Představuje volný text, který se používá k přidání čitelných informací o sestavě. Maximální délka řetězce pro popis je 4096 znaků. Pokud je zadaný řetězec delší, automaticky se zkrátí. Při zkrácení budou poslední znaky popisu obsahovat značku "[Zkráceno] a celková velikost řetězce je 4096 znaků. Přítomnost značky označuje uživatelům, že došlo ke zkrácení. Všimněte si, že při zkrácení má popis z původního řetězce méně než 4096 znaků.

SequenceNumber

Typ: řetězec
Povinné: Ne

Pořadové číslo pro tuto sestavu stavu jako číselný řetězec. Pořadové číslo sestavy se používá v úložišti stavů ke zjišťování zastaralých sestav. Pokud není zadané, při přidání sestavy se automaticky vygeneruje pořadové číslo klientem stavu.

RemoveWhenExpired

Typ: boolean
Povinné: Ne

Hodnota, která určuje, jestli se sestava po vypršení platnosti odebere z úložiště stavů. Pokud je nastavená hodnota true, sestava se po vypršení platnosti odebere z úložiště stavů. Pokud je nastavená hodnota false, bude sestava po vypršení platnosti považována za chybu. Hodnota této vlastnosti je ve výchozím nastavení false. Když klienti pravidelně hlásí, měli by nastavit RemoveWhenExpired false (výchozí). Pokud má reportér problémy (např. vzájemné zablokování) a nemůže nahlásit, vyhodnotí se entita při vypršení platnosti sestavy stavu s chybou. Tím se entita označí jako ve stavu Chyba.

HealthReportId

Typ: řetězec
Povinné: Ne

ID sestavy stavu, které identifikuje sestavu stavu a lze ho použít k vyhledání podrobnějších informací o konkrétní události stavu na aka.ms/sfhealthid

IsExpired

Typ: boolean
Povinné: Ne

Vrátí hodnotu true, pokud vypršela platnost události stavu, jinak false.

SourceUtcTimestamp

Typ: řetězec (datum a čas)
Povinné: Ne

Datum a čas, kdy zdroj odeslal zprávu o stavu.

LastModifiedUtcTimestamp

Typ: řetězec (datum a čas)
Povinné: Ne

Datum a čas, kdy úložiště stavů naposledy upravilo sestavu stavu.

LastOkTransitionAt

Typ: řetězec (datum a čas)
Povinné: Ne

Pokud je aktuální stav Ok, vrátí tato vlastnost čas, kdy byla zpráva o stavu poprvé hlášena s ok. Pro pravidelné generování sestav mohlo být vygenerováno mnoho sestav se stejným stavem. Tato vlastnost vrátí datum a čas přijetí první zprávy o stavu OK.

Pokud je aktuální stav Chyba nebo Upozornění, vrátí datum a čas, kdy byl stav naposledy v ok, před přechodem do jiného stavu.

Pokud stav nikdy nebyl Ok, bude hodnota nula datum a čas.

LastWarningTransitionAt

Typ: řetězec (datum a čas)
Povinné: Ne

Pokud je aktuální stav Varování, vrátí tato vlastnost čas, kdy byla zpráva o stavu poprvé hlášena s upozorněním. Pro pravidelné generování sestav mohlo být vygenerováno mnoho sestav se stejným stavem, ale tato vlastnost vrací pouze datum a čas při prvním přijetí zprávy o stavu Upozornění.

Pokud je aktuální stav "Ok" nebo "Chyba", vrátí datum a čas, kdy byl stav naposledy v upozornění, před přechodem do jiného stavu.

Pokud stav nikdy nebyl Varování, hodnota bude nulové datum a čas.

LastErrorTransitionAt

Typ: řetězec (datum a čas)
Povinné: Ne

Pokud je aktuální stav Chyba, vrátí tato vlastnost čas, kdy byla zpráva o stavu poprvé hlášena s chybou. V případě pravidelného generování sestav mohlo být vygenerováno mnoho sestav se stejným stavem, ale tato vlastnost vrací pouze datum a čas, kdy byla přijata první zpráva o stavu Chyba.

Pokud je aktuální stav "Ok" nebo "Upozornění", vrátí datum a čas, kdy byl stav naposledy v chybě, před přechodem do jiného stavu.

Pokud stav nikdy nebyl Chyba, hodnota bude nulové datum a čas.