Udostępnij za pośrednictwem

HealthEvent

  • Artykuł

Reprezentuje informacje o kondycji zgłaszane dla jednostki kondycji, takie jak klaster, aplikacja lub węzeł, z dodatkowymi metadanymi dodanymi przez Menedżera kondycji.

Właściwości

Nazwa Typ Wymagane
SourceId ciąg Tak
Property ciąg Tak
HealthState ciąg (wyliczenie) Tak
TimeToLiveInMilliSeconds ciąg (czas trwania) Nie
Description ciąg Nie
SequenceNumber ciąg Nie
RemoveWhenExpired boolean Nie
HealthReportId ciąg Nie
IsExpired boolean Nie
SourceUtcTimestamp ciąg (data-godzina) Nie
LastModifiedUtcTimestamp ciąg (data-godzina) Nie
LastOkTransitionAt ciąg (data-godzina) Nie
LastWarningTransitionAt ciąg (data-godzina) Nie
LastErrorTransitionAt ciąg (data-godzina) Nie

SourceId

Typ: ciąg
Wymagane: Tak

Nazwa źródłowa identyfikująca składnik client/watchdog/system, który wygenerował informacje o kondycji.

Property

Typ: ciąg
Wymagane: Tak

Właściwość informacji o kondycji. Jednostka może mieć raporty o kondycji dla różnych właściwości. Właściwość jest ciągiem, a nie stałym wyliczeniem, aby umożliwić reporterowi elastyczne kategoryzowanie warunku stanu wyzwalającego raport. Na przykład reporter o identyfikatorze SourceId "LocalWatchdog" może monitorować stan dostępnego dysku w węźle, dzięki czemu może zgłaszać właściwość "AvailableDisk" w tym węźle. Ten sam reporter może monitorować łączność węzła, dzięki czemu może zgłosić właściwość "Łączność" w tym samym węźle. W magazynie kondycji te raporty są traktowane jako oddzielne zdarzenia kondycji dla określonego węzła.

Wraz z identyfikatorem SourceId właściwość unikatowo identyfikuje informacje o kondycji.

HealthState

Typ: ciąg (wyliczenie)
Wymagane: Tak

Stan kondycji jednostki usługi Service Fabric, takiej jak klaster, węzeł, aplikacja, usługa, partycja, replika itp.

Możliwe wartości:

  • Invalid — wskazuje nieprawidłowy stan kondycji. Wszystkie wyliczenia usługi Service Fabric mają nieprawidłowy typ. Wartość jest równa zero.
  • Ok - Wskazuje, że stan kondycji jest w porządku. Wartość to 1.
  • Warning — Wskazuje, że stan kondycji jest na poziomie ostrzeżenia. Wartość to 2.
  • Error — wskazuje, że stan kondycji jest na poziomie błędu. Należy zbadać stan kondycji błędu, ponieważ może to mieć wpływ na poprawne funkcje klastra. Wartość to 3.
  • Unknown — wskazuje nieznany stan kondycji. Wartość to 65535.

TimeToLiveInMilliSeconds

Typ: ciąg (czas trwania)
Wymagane: Nie

Czas trwania, dla którego ten raport o kondycji jest prawidłowy. To pole używa formatu ISO8601 do określania czasu trwania. Gdy klienci będą okresowo raportować, powinni wysyłać raporty o wyższej częstotliwości niż czas wygaśnięcia. Jeśli klienci zgłaszają przejście, mogą ustawić czas wygaśnięcia na nieskończony. Po wygaśnięciu czasu wygaśnięcia zdarzenie kondycji zawierające informacje o kondycji zostanie usunięte ze sklepu kondycji, jeśli wartość RemoveWhenExpired ma wartość true lub zostanie obliczona w przypadku błędu, jeśli element RemoveWhenExpired ma wartość false.

Jeśli nie zostanie określony, czas wygaśnięcia domyślnie ma wartość nieskończoną.

Description

Typ: ciąg
Wymagane: Nie

Opis informacji o kondycji. Reprezentuje on dowolny tekst używany do dodawania czytelnych informacji o raporcie. Maksymalna długość ciągu opisu wynosi 4096 znaków. Jeśli podany ciąg będzie dłuższy, zostanie automatycznie obcięty. Po obcięciu ostatnie znaki opisu zawierają znacznik "[Obcięte]", a całkowity rozmiar ciągu to 4096 znaków. Obecność znacznika wskazuje użytkownikom, że wystąpiło obcinanie. Pamiętaj, że po obcięciu opis zawiera mniej niż 4096 znaków z oryginalnego ciągu.

SequenceNumber

Typ: ciąg
Wymagane: Nie

Numer sekwencji dla tego raportu kondycji jako ciąg liczbowy. Numer sekwencji raportów jest używany przez magazyn kondycji do wykrywania nieaktualnych raportów. Jeśli nie zostanie określony, numer sekwencji jest generowany automatycznie przez klienta kondycji po dodaniu raportu.

RemoveWhenExpired

Typ: wartość logiczna
Wymagane: Nie

Wartość wskazująca, czy raport jest usuwany z magazynu kondycji po wygaśnięciu. W przypadku ustawienia wartości true raport zostanie usunięty z magazynu kondycji po jego wygaśnięciu. W przypadku ustawienia wartości false raport jest traktowany jako błąd po wygaśnięciu. Wartość tej właściwości jest domyślnie fałsz. Gdy klienci okresowo zgłaszają raport, powinni ustawić wartość RemoveWhenExpired false (wartość domyślna). W ten sposób, jeśli reporter ma problemy (np. zakleszczenie) i nie może zgłosić, jednostka jest oceniana przy błędzie po wygaśnięciu raportu kondycji. Oznacza to, że jednostka jest w stanie kondycji Błąd.

HealthReportId

Typ: ciąg
Wymagane: Nie

Identyfikator raportu kondycji, który identyfikuje raport kondycji i może służyć do znajdowania bardziej szczegółowych informacji o konkretnym zdarzeniu kondycji w aka.ms/sfhealthid

IsExpired

Typ: wartość logiczna
Wymagane: Nie

Zwraca wartość true, jeśli zdarzenie kondycji wygasło, w przeciwnym razie wartość false.

SourceUtcTimestamp

Typ: ciąg (data-godzina)
Wymagane: Nie

Data i godzina wysłania raportu kondycji przez źródło.

LastModifiedUtcTimestamp

Typ: ciąg (data-godzina)
Wymagane: Nie

Data i godzina ostatniej modyfikacji raportu kondycji przez magazyn kondycji.

LastOkTransitionAt

Typ: ciąg (data-godzina)
Wymagane: Nie

Jeśli bieżący stan kondycji to "Ok", ta właściwość zwraca czas, w którym raport kondycji został zgłoszony po raz pierwszy z wartością "OK". W przypadku okresowego raportowania wiele raportów o tym samym stanie mogło zostać wygenerowanych. Ta właściwość zwraca datę i godzinę odebrania pierwszego raportu kondycji "OK".

Jeśli bieżący stan kondycji to "Błąd" lub "Ostrzeżenie", zwraca datę i godzinę ostatniego stanu kondycji w obszarze "OK", przed przejściem do innego stanu.

Jeśli stan kondycji nigdy nie był "OK", wartość będzie równa zero daty i godziny.

LastWarningTransitionAt

Typ: ciąg (data-godzina)
Wymagane: Nie

Jeśli bieżący stan kondycji to "Ostrzeżenie", ta właściwość zwraca czas, w którym raport kondycji został po raz pierwszy zgłoszony z komunikatem "Ostrzeżenie". W przypadku okresowego raportowania wiele raportów o tym samym stanie mogło zostać wygenerowanych, jednak ta właściwość zwraca tylko datę i godzinę w pierwszym raporcie kondycji "Ostrzeżenie".

Jeśli bieżący stan kondycji to "OK" lub "Błąd", zwraca datę i godzinę ostatniego stanu kondycji w obszarze "Ostrzeżenie", przed przejściem do innego stanu.

Jeśli stan kondycji nigdy nie był "Ostrzeżenie", wartość będzie równa zero daty i godziny.

LastErrorTransitionAt

Typ: ciąg (data-godzina)
Wymagane: Nie

Jeśli bieżący stan kondycji to "Błąd", ta właściwość zwraca czas, w którym raport kondycji został po raz pierwszy zgłoszony z komunikatem "Błąd". W przypadku okresowego raportowania wiele raportów o tym samym stanie mogło zostać wygenerowanych, jednak ta właściwość zwraca tylko datę i godzinę w pierwszym raporcie kondycji "Błąd".

Jeśli bieżący stan kondycji to "Ok" lub "Ostrzeżenie", zwraca datę i godzinę ostatniego stanu kondycji w obszarze "Błąd", przed przejściem do innego stanu.

Jeśli stan kondycji nigdy nie miał wartości "Błąd", wartość będzie równa zero daty i godziny.