Kesehatan Replika Laporan

Artikel
08/05/2023

Mengirimkan laporan kesehatan tentang replika Service Fabric.

Melaporkan status kesehatan dari replika Service Fabric yang ditentukan. Laporan harus berisi informasi tentang sumber laporan kesehatan dan properti tempat laporan tersebut dilaporkan. Laporan dikirimkan ke replika gateway Service Fabric, yang diteruskan ke penyimpanan kesehatan. Laporan dapat diterima oleh gateway, tetapi ditolak oleh penyimpanan kesehatan setelah validasi ekstra. Misalnya, penyimpanan kesehatan dapat menolak laporan karena parameter yang tidak valid, seperti nomor urutan kedaluwarsa. Untuk melihat apakah laporan diterapkan di penyimpanan kesehatan, jalankan GetReplicaHealth dan periksa apakah laporan muncul di bagian HealthEvents.

Minta

Metode	URI Permintaan
POST	`/Partitions/{partitionId}/$/GetReplicas/{replicaId}/$/ReportHealth?api-version=6.0&ServiceKind={ServiceKind}&Immediate={Immediate}&timeout={timeout}`

Parameter

Nama	Jenis	Diperlukan	Lokasi
`partitionId`	string (uuid)	Ya	Jalur
`replicaId`	string	Ya	Jalur
`api-version`	string	Ya	Kueri
`ServiceKind`	string (enum)	Ya	Kueri
`Immediate`	boolean	Tidak	Kueri
`timeout`	bilangan bulat (int64)	Tidak	Kueri
`HealthInformation`	HealthInformation	Ya	Isi

`partitionId`

Jenis: string (uuid)
Diperlukan: Ya

Identitas partisi.

`replicaId`

Jenis: string
Diperlukan: Ya

Pengenal replika.

`api-version`

Jenis: string
Diperlukan: Ya
Default: 6.0

Versi API. Parameter ini diperlukan dan nilainya harus '6.0'.

Versi SERVICE Fabric REST API didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi TERBARU api yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang didokumenkan dalam spesifikasi ini.

Selain itu, runtime menerima versi apa pun yang lebih tinggi dari versi terbaru yang didukung hingga versi runtime saat ini. Jadi jika versi API terbaru adalah 6.0, tetapi jika runtime adalah 6.1, untuk mempermudah penulisan klien, runtime akan menerima versi 6.1 untuk API tersebut. Namun perilaku API akan sesuai versi 6.0 yang didokumentasikan.

`ServiceKind`

Jenis: string (enum)
Diperlukan: Ya
Default: Stateful

Jenis replika layanan (Stateless atau Stateful) yang kesehatannya sedang dilaporkan. Berikut ini adalah nilai yang mungkin. Nilai yang mungkin termasuk: 'Stateless', 'Stateful'

`Immediate`

Jenis: boolean
Diperlukan: Tidak
Default: false

Bendera yang menunjukkan apakah laporan harus segera dikirim. Laporan dikirimkan ke Aplikasi gateway Service Fabric, yang diteruskan ke penyimpanan kesehatan. Jika Immediate diatur ke true, laporan dikirim segera dari HTTP Gateway ke penyimpanan kesehatan, terlepas dari pengaturan klien fabric yang digunakan Aplikasi GATEWAY HTTP. Ini berguna untuk laporan kritis yang harus dikirim sesegera mungkin. Tergantung waktu dan kondisi lainnya, mengirim laporan mungkin masih gagal, misalnya jika Gateway HTTP ditutup atau pesan tidak mencapai Gateway. Jika Immediate diatur ke false, laporan dikirim berdasarkan pengaturan klien kesehatan dari HTTP Gateway. Oleh karena itu, laporan akan ditumpuk sesuai konfigurasi HealthReportSendInterval. Ini adalah pengaturan yang direkomendasikan karena memungkinkan klien kesehatan untuk mengoptimalkan pesan pelaporan kesehatan ke penyimpanan kesehatan serta pemrosesan laporan kesehatan. Secara default, laporan tidak segera dikirim.

`timeout`

Jenis: bilangan bulat (int64)
Diperlukan: Tidak
Default: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Batas waktu server untuk melakukan operasi dalam hitungan detik. Batas waktu ini menentukan durasi waktu klien bersedia menunggu operasi yang diminta selesai. Nilai default untuk parameter ini adalah 60 detik.

`HealthInformation`

Jenis: HealthInformation
Diperlukan: Ya

Menjelaskan informasi kesehatan untuk laporan kesehatan. Informasi ini perlu ada di semua laporan kesehatan yang dikirim ke manajer kesehatan.

Respons

Kode Status HTTP	Deskripsi	Skema Respons
200 (OK)	Operasi yang berhasil akan mengembalikan kode status 200.
Semua kode status lainnya	Respons kesalahan terperinci.	FabricError

Bagikan melalui