HealthEvent

Artikel
07/19/2023

Mewakili informasi kesehatan yang dilaporkan pada entitas kesehatan, seperti kluster, aplikasi, atau node, dengan metadata tambahan yang ditambahkan oleh Health Manager.

Properti

Nama	Jenis	Diperlukan
`SourceId`	string	Ya
`Property`	string	Ya
`HealthState`	string (enum)	Ya
`TimeToLiveInMilliSeconds`	string (durasi)	Tidak
`Description`	string	Tidak
`SequenceNumber`	string	Tidak
`RemoveWhenExpired`	boolean	Tidak
`HealthReportId`	string	Tidak
`IsExpired`	boolean	Tidak
`SourceUtcTimestamp`	string (tanggal-waktu)	Tidak
`LastModifiedUtcTimestamp`	string (tanggal-waktu)	Tidak
`LastOkTransitionAt`	string (tanggal-waktu)	Tidak
`LastWarningTransitionAt`	string (tanggal-waktu)	Tidak
`LastErrorTransitionAt`	string (tanggal-waktu)	Tidak

`SourceId`

Jenis: string
Diperlukan: Ya

Nama sumber yang mengidentifikasi komponen klien/pengawas/sistem yang menghasilkan informasi kesehatan.

`Property`

Jenis: string
Diperlukan: Ya

Milik informasi kesehatan. Entitas dapat memiliki laporan kesehatan untuk properti yang berbeda. Properti adalah sebuah string dan bukan enumerasi tetap untuk memungkinkan fleksibilitas reporter untuk mengkategorikan kondisi status yang memicu laporan tersebut. Misalnya, pelapor dengan SourceId "LocalWatchdog" dapat memantau status disk yang tersedia pada sebuah node, sehingga dapat melaporkan properti "AvailableDisk" pada node tersebut. Reporter yang sama dapat memantau konektivitas node, sehingga dapat melaporkan properti "Connectivity" pada node yang sama. Di penyimpanan kesehatan, laporan ini diperlakukan sebagai peristiwa kesehatan terpisah untuk node yang ditentukan.

Bersama dengan SourceId, properti ini secara unik mengidentifikasi informasi kesehatan.

`HealthState`

Jenis: string (enum)
Diperlukan: Ya

Status kesehatan entitas Service Fabric seperti Kluster, Node, Aplikasi, Layanan, Partisi, Replika, dll.

Potensi nilai:

Invalid - Menunjukkan status kesehatan yang tidak valid. Semua enumerasi Service Fabric memiliki jenis yang tidak valid. Nilainya berbasis nol.
Ok - Menunjukkan keadaan kesehatan baik-baik saja. Nilainya adalah 1.
Warning - Menunjukkan status kesehatan berada pada tingkat peringatan. Nilainya adalah 2.
Error - Menunjukkan status kesehatan berada pada tingkat kesalahan. Status kesehatan kesalahan harus diselidiki, karena dapat memengaruhi fungsionalitas kluster yang benar. Nilainya adalah 3.
Unknown - Menunjukkan status kesehatan yang tidak diketahui. Nilainya adalah 65535.

`TimeToLiveInMilliSeconds`

Jenis: string (durasi)
Diperlukan: Tidak

Durasi ketika laporan kesehatan ini valid. Bidang ini menggunakan format ISO8601 untuk menentukan durasi. Ketika klien melaporkan secara berkala, mereka akan mengirim laporan dengan frekuensi yang lebih tinggi daripada time to live. Jika klien melaporkan transisi, mereka dapat mengatur time to live ke tak terbatas. Ketika time to live kedaluwarsa, peristiwa kesehatan yang berisi informasi kesehatan dihapus dari penyimpanan kesehatan, jika RemoveWhenExpired adalah true, atau dievaluasi karena kesalahan, jika RemoveWhenExpired false.

Jika tidak ditentukan, time to live menggunakan nilai default ke nilai tak terbatas.

`Description`

Jenis: string
Diperlukan: Tidak

Penjabaran informasi kesehatan. Ini mewakili teks bebas yang digunakan untuk menambahkan informasi yang dapat dibaca manusia tentang laporan. Panjang string maksimum untuk deskripsi adalah 4096 karakter. Jika string yang disediakan lebih panjang, string tersebut akan dipotong secara otomatis. Ketika dipotong, karakter terakhir dari deskripsi berisi penanda "[Truncated]", dan ukuran total stringnya adalah 4096 karakter. Munculnya penanda menunjukkan kepada pengguna bahwa pemotongan terjadi. Perhatikan bahwa ketika dipotong, deskripsi memiliki kurang dari 4096 karakter dari string asli.

`SequenceNumber`

Jenis: string
Diperlukan: Tidak

Nomor urut untuk laporan kesehatan ini sebagai string numerik. Nomor urutan laporan digunakan oleh penyimpanan kesehatan untuk mendeteksi laporan kedaluwarsa. Jika tidak ditentukan, nomor urut dibuat secara otomatis oleh klien kesehatan saat laporan ditambahkan.

`RemoveWhenExpired`

Jenis: boolean
Diperlukan: Tidak

Nilai yang menunjukkan apakah laporan dihapus dari penyimpanan kesehatan saat kedaluwarsa. Jika diatur ke true, laporan dihapus dari penyimpanan kesehatan setelah kedaluwarsa. Jika diatur ke false, laporan diperlakukan sebagai kesalahan saat kedaluwarsa. Nilai properti ini salah secara default. Ketika klien melaporkan secara berkala, maka harus mengatur RemoveWhenExpired ke false (default). Dengan cara ini, jika wartawan memiliki masalah (misalnya kebuntuan) dan tidak dapat melaporkan, entitas dievaluasi karena kesalahan ketika laporan kesehatan kedaluwarsa. Ini menandai entitas sebagai dalam status kesehatan dalam Kesalahan.

`HealthReportId`

Jenis: string
Diperlukan: Tidak

ID laporan kesehatan yang mengidentifikasi laporan kesehatan dan dapat digunakan untuk menemukan informasi lebih rinci tentang peristiwa kesehatan tertentu di aka.ms/sfhealthid

`IsExpired`

Jenis: boolean
Diperlukan: Tidak

Mengembalikan true jika peristiwa kesehatan kedaluwarsa, jika tidak salah.

`SourceUtcTimestamp`

Jenis: string (tanggal-waktu)
Diperlukan: Tidak

Tanggal dan waktu ketika laporan kesehatan dikirim oleh sumber.

`LastModifiedUtcTimestamp`

Jenis: string (tanggal-waktu)
Diperlukan: Tidak

Tanggal dan waktu ketika laporan kesehatan terakhir dimodifikasi oleh penyimpanan kesehatan.

`LastOkTransitionAt`

Jenis: string (tanggal-waktu)
Diperlukan: Tidak

Jika status kesehatan saat ini adalah 'Ok', properti ini mengembalikan waktu di mana laporan kesehatan pertama kali dilaporkan dengan 'Ok'. Untuk pelaporan berkala, banyak laporan dengan status yang sama mungkin telah dibuat. Properti ini mengembalikan tanggal dan waktu ketika laporan kesehatan 'Ok' pertama diterima.

Jika status kesehatan saat ini adalah 'Kesalahan' atau 'Peringatan', mengembalikan tanggal dan waktu status kesehatan terakhir di 'Ok', sebelum beralih ke status yang berbeda.

Jika status kesehatan tidak pernah 'Ok', nilainya akan menjadi nol tanggal-waktu.

`LastWarningTransitionAt`

Jenis: string (tanggal-waktu)
Diperlukan: Tidak

Jika status kesehatan saat ini adalah 'Peringatan', properti ini mengembalikan waktu di mana laporan kesehatan pertama kali dilaporkan dengan 'Peringatan'. Untuk pelaporan berkala, banyak laporan dengan status yang sama mungkin telah dibuat namun, properti ini hanya mengembalikan tanggal dan waktu pada laporan kesehatan 'Peringatan' pertama yang diterima.

Jika status kesehatan saat ini adalah 'Ok' atau 'Error', mengembalikan tanggal dan waktu status kesehatan terakhir dalam 'Warning', sebelum beralih ke status yang berbeda.

Jika status kesehatan tidak pernah 'Peringatan', nilainya akan menjadi nol tanggal-waktu.

`LastErrorTransitionAt`

Jenis: string (tanggal-waktu)
Diperlukan: Tidak

Jika status kesehatan saat ini adalah 'Kesalahan', properti ini mengembalikan waktu di mana laporan kesehatan pertama kali dilaporkan dengan 'Kesalahan'. Untuk pelaporan berkala, banyak laporan dengan status yang sama mungkin telah dibuat namun, properti ini hanya mengembalikan tanggal dan waktu pada laporan kesehatan 'Kesalahan' pertama yang diterima.

Jika status kesehatan saat ini adalah 'Ok' atau 'Peringatan', mengembalikan tanggal dan waktu status kesehatan terakhir dalam 'Kesalahan', sebelum beralih ke status yang berbeda.

Jika status kesehatan tidak pernah 'Kesalahan', nilainya akan menjadi nol tanggal-waktu.

Bagikan melalui