Send-ServiceFabricServiceHealthReport
Service Fabric hizmetine sistem durumu raporu gönderir.
Syntax
Send-ServiceFabricServiceHealthReport
[-ServiceName] <Uri>
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
Send-ServiceFabricServiceHealthReport cmdlet'i Service Fabric hizmetinde bir sistem durumu raporu gönderir.
Hizmet sistem durumu deposunda zaten mevcut olmalıdır. Var olup olmadığını denetlemek için Get-ServiceFabricServiceHealth cmdlet'ini kullanın ve ServiceName parametresini belirtin. Alternatif olarak, uygulama bilgilerini almak için Get-ServiceFabricApplicationHealth cmdlet'ini kullanabilir ve sonra istediğiniz hizmeti bulmak için hizmet durumu durumlarını kontrol edebilirsiniz.
Rapor, Connect-ServiceFabricCluster cmdlet'inin HealthReportSendIntervalInSec parametresinde belirtilen saniye sayısından sonra gönderilir. Küme bağlantısı bu süre boyunca canlı tutulmalıdır.
Cmdlet başarı döndürebilir, ancak rapor zaman uyumsuz olarak gönderildiğinden işlemesi başarısız olabilir. Raporun sistem durumu deposuna uygulanıp uygulanmadığını görmek için Get-ServiceFabricServiceHealth cmdlet'ini kullanın ve raporun HealthEvents bölümünde görünüp görünmediğini denetleyin.
Service Fabric kümesinde herhangi bir işlem yapmadan önce Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.
Örnekler
Örnek 1: Sonsuz TTL ile Hata durumu raporu bildirme
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "Availability" -HealthState Error -Description "The service is not available."
Bu komut, kaynak MyWatchDog kaynağından fabric:/MyApplication/MyService adlı hizmet için bir sistem durumu raporu gönderir. Sistem durumu raporu, sonsuz TTL ile bir Hata durumu durumunda sistem durumu özelliği Kullanılabilirliği hakkında bilgi içerir. Bu komut hata için bir açıklama da verir.
Örnek 2: Belirtilen TTL için geçerli Olan Rapor Uyarısı
PS C:\> Send-ServiceFabricServiceHealthReport -ServiceName fabric:/MyApplication/MyService -SourceId "MyWatchdog" -HealthProperty "PrivateData" -HealthState Warning -TimeToLiveSec 10 -RemoveWhenExpired -Description "Accessing private data in database MyServicePrivateData is slow."
Bu komut, kaynak MyWatchdog kaynağından fabric:/MyApplication/MyService adlı hizmette bir sistem durumu raporu gönderir. Sistem durumu raporu, 10 saniyelik TTL ile Uyarı sistem durumu durumundaki PrivateData sistem durumu özelliği hakkında bilgi içerir ve son kullanma tarihinde kaldırılma için raporu işaretler.
Parametreler
-Description
Raporu tetikleyen koşul hakkında okunabilir bilgileri belirtir. SourceId, HealthProperty ve HealthState parametreleri raporu tam olarak açıklar.
Açıklama için en fazla dize uzunluğu 4096 karakterdir. Sağlanan dize daha uzunsa, otomatik olarak kesilir. Kesildiğinde, kullanıcılara kesmenin gerçekleştiğini göstermek için açıklama "[Kesilmiş]" işaretçisiyle biter. Toplam dize boyutu 4096 karakterdir, bu nedenle özgün dizeden 4096 karakterden daha az karakter tutulur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthProperty
Raporun özelliğini belirtir. SourceId parametresiyle birlikte bu özellik raporu benzersiz olarak tanımlar.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HealthState
Bildirilen sistem durumunu temsil eden bir HealthState nesnesi belirtir.
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
Raporun hemen sistem durumu deposuna gönderilmesi gerekip gerekmediğini belirtir. Bu, en kısa sürede gönderilmesi gereken kritik raporlar için kullanışlıdır. Belirtilmezse, rapor sistem durumu istemci ayarlarına göre gönderilir. Bu nedenle, HealthReportSendInterval yapılandırmasına göre toplu işlenecektir. Bu önerilen ayardır çünkü sistem durumu istemcisinin sistem durumu raporlama iletilerini hem sistem durumu deposuna hem de sistem durumu raporu işlemeye en iyi duruma getirmesine olanak tanır. Varsayılan olarak, Powershell doku istemcisi HealthReportSentInterval'ı 0 olarak ayarlar, bu nedenle raporlar hemen gönderilir.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveWhenExpired
Raporun süresi dolduğunda sistem durumu deposundan kaldırıldığını gösterir. Bu parametreyi belirtmezseniz, rapor yaşam süresi dolduğunda varlık Hata durumunda kabul edilir. Süresi dolduğunda kaldırılan raporlar, yalnızca belirli bir süre için geçerli olan koşullar veya Raporları Health Store'dan temizlemek için kullanılabilir.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SequenceNumber
Sistem durumu raporuyla ilişkili sıra numarasını belirtir. Bu parametre için bir değer belirtmezseniz, sıra numarası otomatik olarak ayarlanır. Bir sıra numarası belirtirseniz, bu değerin aynı SourceId ve HealthProperty üzerinde ayarlanan önceki sıra numarasından daha yüksek olması gerekir, aksi takdirde eskime nedeniyle rapor reddedilir.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
Service Fabric hizmetinin Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceId
Raporu tetikleyen kaynağın tanımlayıcısını belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
İşlemin zaman aşımı süresini saniye cinsinden belirtir.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeToLiveSec
Raporun Yaşam Süresi'ni (TTL) saniye cinsinden belirtir. TTL'nin süresi dolduğunda RemoveWhenExpired parametresi belirtilirse rapor sistem durumu deposundan kaldırılır. Aksi takdirde varlık, süresi dolan rapor nedeniyle Hata olarak değerlendirilir. Varsayılan değer Sonsuz'dur.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Girişler
System.Uri
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]]
Çıkışlar
System.Object