Melaporkan Kesehatan Paket Layanan yang Disebarkan
Mengirim laporan kesehatan tentang paket layanan yang disebarkan Service Fabric.
Melaporkan status kesehatan paket layanan 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 paket layanan yang disebarkan dan periksa apakah laporan muncul di bagian HealthEvents.
Minta
| Metode | URI Permintaan |
|---|---|
| POST | /Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout} |
Parameter
| Nama | Jenis | Diperlukan | Lokasi |
|---|---|---|---|
nodeName |
string | Ya | Jalur |
applicationId |
string | Ya | Jalur |
servicePackageName |
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.
servicePackageName
Jenis: string
Diperlukan: Ya
Nama paket layanan.
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 |