Bagikan melalui

Send-ServiceFabricClusterHealthReport

  • Referensi
Modul:
ServiceFabric

Mengirimkan laporan kesehatan tentang suatu kluster Service Fabric.

Sintaks

Send-ServiceFabricClusterHealthReport
    -HealthState <HealthState>
    -SourceId <String>
    -HealthProperty <String>
    [-Description <String>]
    [-TimeToLiveSec <Int32>]
    [-RemoveWhenExpired]
    [-SequenceNumber <Int64>]
    [-Immediate]
    [-TimeoutSec <Int32>]
    [<CommonParameters>]

Deskripsi

Cmdlet Send-ServiceFabricClusterHealthReport mengirimkan laporan kesehatan pada kluster Service Fabric.

Cmdlet mengirimkan laporan setelah interval yang ditentukan oleh parameter HealthReportSendIntervalInSec dari cmdlet Connect-ServiceFabricCluster . Koneksi kluster harus tetap hidup selama waktu ini. Perintah dievaluasi pada klien tanpa referensi untuk berjalan di penyimpanan kesehatan. Laporan mungkin tidak diterapkan di penyimpanan kesehatan meskipun perintah mengembalikan keberhasilan. Misalnya, penyimpanan kesehatan dapat menolak laporan karena parameter yang tidak valid, seperti nomor urutan kedaluwarsa.

Untuk melihat apakah laporan diterapkan di penyimpanan kesehatan, gunakan cmdlet Get-ServiceFabricClusterHealth dan periksa apakah laporan muncul di bagian HealthEvents.

Untuk mengelola kluster Service Fabric, mulai Windows PowerShell dengan menggunakan opsi Jalankan sebagai administrator. Sebelum Anda melakukan operasi apa pun pada kluster Service Fabric, buat koneksi ke kluster dengan menggunakan cmdlet Connect-ServiceFabricCluster dan kemudian cmdlet Get-ServiceFabricClusterConnection .

Contoh

Contoh 1: Melaporkan laporan kesehatan Kesalahan dengan TTL tak terbatas

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error

Perintah ini mengirimkan laporan kesehatan pada kluster dari sumber MyWatchdog. Laporan kesehatan berisi informasi tentang Ketersediaan properti kesehatan dalam status kesehatan Kesalahan, dengan TTL tak terbatas.

Contoh 2: Peringatan Laporan valid untuk TTL tertentu

PS C:\> Send-ServiceFabricClusterHealthReport -SourceId "MyWatchdog" -HealthProperty "EnoughNodes" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -SequenceNumber 1344

Perintah ini mengirimkan laporan kesehatan pada kluster dari sumber MyWatchDog. Laporan kesehatan berisi informasi tentang properti kesehatan EnoughNodes dalam status kesehatan Peringatan. Laporan tetap berada di penyimpanan kesehatan selama 10 detik, setelah itu secara otomatis dihapus. Perintah menentukan parameter SequenceNumber . Nomor urut harus lebih tinggi dari angka urutan yang dilaporkan sebelumnya untuk SourceId dan Properti yang sama, atau laporan ditolak karena kedaluarsa.

Parameter

-Description

Menentukan informasi yang dapat dibaca manusia tentang kondisi yang memicu laporan. Parameter SourceId, HealthProperty, dan HealthState sepenuhnya menjelaskan laporan.

Panjang string maksimum untuk deskripsi adalah 4096 karakter. Jika string yang disediakan lebih panjang, string tersebut secara otomatis terpotong. Saat dipotong, deskripsi diakhiri dengan penanda, "[Terpotong]", untuk menunjukkan kepada pengguna bahwa pemotongan terjadi. Ukuran string total adalah 4096 karakter, sehingga kurang dari 4096 karakter dari string asli disimpan.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HealthProperty

Menentukan properti laporan. Bersama dengan parameter SourceId , properti ini secara unik mengidentifikasi laporan. Laporan ini mengambil alih laporan sebelumnya dengan nilai yang sama untuk parameter SourceId dan HealthProperty pada entitas yang sama.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HealthState

Menentukan objek HealthState yang mewakili status kesehatan yang dilaporkan.

Type:HealthState
Accepted values:Invalid, Ok, Warning, Error, Unknown
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Immediate

Menentukan apakah laporan harus segera dikirim ke penyimpanan kesehatan. Ini berguna untuk laporan kritis yang harus dikirim sesegera mungkin. Jika tidak ditentukan, laporan dikirim berdasarkan pengaturan klien kesehatan. 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, klien Powershell fabric mengatur HealthReportSentInterval ke 0, sehingga laporan segera dikirim.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveWhenExpired

Menunjukkan bahwa laporan dihapus dari penyimpanan kesehatan saat kedaluwarsa. Jika Anda tidak menentukan parameter ini, entitas dipertimbangkan dalam status Kesalahan saat waktu laporan untuk hidup kedaluwarsa. Laporan yang dihapus saat kedaluwarsa dapat digunakan untuk kondisi yang hanya berlaku untuk jangka waktu tertentu atau untuk menghapus laporan dari Penyimpanan Kesehatan.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SequenceNumber

Menentukan nomor urut yang terkait dengan laporan kesehatan. Jika Anda tidak menentukan nilai untuk parameter ini, nomor urut diatur secara otomatis. Jika Anda menentukan nomor urut, nilai tersebut harus lebih tinggi dari angka urutan sebelumnya yang ditetapkan pada SourceId dan HealthProperty yang sama, atau laporan ditolak karena kedaluarsa.

Type:Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SourceId

Menentukan pengidentifikasi sumber yang memicu laporan.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeoutSec

Menentukan periode waktu habis, dalam detik, untuk operasi.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeToLiveSec

Menentukan Time to Live (TTL) laporan dalam hitungan detik. Ketika TTL kedaluwarsa, laporan dihapus dari penyimpanan kesehatan jika parameter RemoveWhenExpired ditentukan. Jika tidak, entitas dievaluasi pada Kesalahan karena laporan yang kedaluwarsa. Nilai defaultnya adalah Infinite.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Input

System.Fabric.Health.HealthState

System.String

System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Output

System.Object