Melaporkan Kesehatan Aplikasi yang Disebarkan

Artikel
07/19/2023

Mengirim laporan kesehatan tentang aplikasi Service Fabric yang disebarkan pada node Service Fabric.

Melaporkan status kesehatan aplikasi yang disebarkan pada node Service Fabric. Laporan harus berisi informasi tentang sumber laporan kesehatan dan properti tempat laporan tersebut dilaporkan. Laporan dikirimkan ke Layanan 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, dapatkan kesehatan aplikasi yang disebarkan dan periksa apakah laporan muncul di bagian HealthEvents.

Minta

Metode	URI Permintaan
POST	`/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout}`

Parameter

Nama	Jenis	Diperlukan	Lokasi
`nodeName`	string	Ya	Jalur
`applicationId`	string	Ya	Jalur
`api-version`	string	Ya	Kueri
`Immediate`	boolean	Tidak	Kueri
`timeout`	bilangan bulat (int64)	Tidak	Kueri
`HealthInformation`	HealthInformation	Ya	Isi

`nodeName`

Jenis: string
Diperlukan: Ya

Nama node.

`applicationId`

Jenis: string
Diperlukan: Ya

Identitas aplikasi. Ini biasanya nama lengkap aplikasi tanpa skema URI 'fabric:'. Mulai dari versi 6.0, nama hierarki dibatasi dengan karakter “~”. Misalnya, jika nama aplikasi adalah "fabric:/myapp/app1", identitas aplikasi akan menjadi "myapp~app1" di versi 6.0+ dan "myapp/app1" di versi sebelumnya.

`api-version`

Jenis: string
Diperlukan: Ya
Default: 6.0

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

Versi REST API Service Fabric didasarkan pada versi runtime tempat API diperkenalkan atau diubah. Runtime Service Fabric mendukung lebih dari satu versi API. Ini adalah versi API terbaru yang didukung. Jika versi API yang lebih rendah diteruskan, respons yang dikembalikan mungkin berbeda dari yang di dokumentasikan 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 dengan versi 6.0 yang di dokumentasikan.

`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