Bagikan melalui

HealthInformation

  • Artikel

Mewakili informasi laporan kesehatan umum. Ini termasuk dalam semua laporan kesehatan yang dikirim ke penyimpanan kesehatan dan di semua peristiwa kesehatan yang dikembalikan oleh kueri kesehatan.

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

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