Send-ServiceFabricDeployedServicePackageHealthReport
Service Fabric'in dağıtılan hizmet paketinde bir sistem durumu raporu gönderir.
Syntax
Send-ServiceFabricDeployedServicePackageHealthReport
[-ApplicationName] <Uri>
[-ServiceManifestName] <String>
[-NodeName] <String>
[[-ServicePackageActivationId] <String>]
-HealthState <HealthState>
-SourceId <String>
-HealthProperty <String>
[-Description <String>]
[-TimeToLiveSec <Int32>]
[-RemoveWhenExpired]
[-SequenceNumber <Int64>]
[-Immediate]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
Send-ServiceFabricDeployedServicePackageHealthReport cmdlet'i Service Fabric tarafından dağıtılan hizmet paketinde bir sistem durumu raporu gönderir.
Dağıtılan hizmet paketi sistem durumu deposunda zaten mevcut olmalıdır. Hizmetin mevcut olup olmadığını denetlemek için Get-ServiceFabricDeployedServicePackageHealth cmdlet'ini kullanın. Uygulama adını, hizmet paketi adını ve düğüm adını belirtin. Alternatif olarak, Get-ServiceFabricDeployedApplicationHealth cmdlet'ini kullanabilirsiniz. Uygulama adını ve düğüm adını belirtin ve hizmet paketini bulmak için dağıtılan hizmet paketi sistem durumu bölümünü denetleyin.
Cmdlet, Connect-ServiceFabricCluster cmdlet'inin HealthReportSendIntervalInSec parametresi tarafından belirtilen bir aralık sonrasında raporu gönderir. Küme bağlantısı bu süre boyunca canlı tutulmalıdır. Komut, sistem durumu deposunda çalıştırılmaya başvurmadan istemcide değerlendirilir. Komut başarı döndürse bile rapor sistem durumu deposunda uygulanamayabilir. Örneğin, sistem durumu deposu, eski bir dizi numarası gibi geçersiz bir parametre nedeniyle raporu reddedebilir.
Raporun sistem durumu deposunda uygulanıp uygulanmadığını görmek için Get-ServiceFabricDeployedServicePackageHealth cmdlet'ini kullanın ve raporun HealthEvents bölümünde görünüp görünmediğini denetleyin.
Service Fabric kümelerini yönetmek için Yönetici olarak çalıştır seçeneğini kullanarak Windows PowerShell başlatın. Service Fabric kümesinde herhangi bir işlem gerçekleştirmeden önce Connect-ServiceFabricCluster cmdlet'ini ve ardından Get-ServiceFabricClusterConnection cmdlet'ini kullanarak kümeyle bağlantı kurun.
Örnekler
Örnek 1: Sonsuz TTL ile Hata durumu raporu bildirme
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -NodeName "Node01" -ServiceManifestName "MyServiceManifest" -HealthProperty "Memory" -HealthState Error -SourceId "MyWatchdog"
Bu komut, MyServiceManifest adlı hizmet bildirimi için Node01 adlı düğümde fabric:/MyApplication adlı uygulama için dağıtılan bir hizmet paketine sistem durumu raporu gönderir. Sistem durumu raporu, sonsuz TTL ile MyWatchdog kaynağından alınan Bir Hata durumu durumundaki Bellek sistem durumu özelliği hakkında bilgi içerir. Açıklama verilmez ve sıra numarası otomatik olarak ayarlanır.
Örnek 2: Belirtilen TTL için geçerli olan Rapor Uyarısı ve süresi dolduğunda bu uyarıyı kaldırın
PS C:\> Send-ServiceFabricDeployedServicePackageHealthReport -ApplicationName fabric:/MyApplication -ServiceManifestName MyServiceManifest -NodeName "Node01" -HealthProperty "CustomSetup" -HealthState Warning -SourceId MyWatchdog -RemoveWhenExpired -Description "The setup has completed with some warnings." -TimeToLiveSec 10
Bu komut, Node01 adlı düğümdeki MyServiceManifest adlı hizmet bildirimi için fabric:/MyApplication adlı uygulama için dağıtılan hizmet paketinde bir sistem durumu raporu gönderir. Sistem durumu raporu, 10 saniye TTL ile MyWatchdog kaynağından uyarı sistem durumu durumunda CustomSetup sistem durumu özelliği hakkında bilgi içerir. Raporun süresi dolduktan sonra sistem durumu deposundan kaldırılır ve sistem durumu değerlendirmesini artık etkilemez. Bu komut uyarının açıklamasını da verir.
Parametreler
-ApplicationName
Service Fabric uygulamasının Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. Cmdlet, belirttiğiniz URI'ye sahip uygulama için bir sistem durumu raporu gönderir.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-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 kesme işleminin 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. Rapor, aynı varlık üzerindeki SourceId ve HealthProperty parametreleri için aynı değerlere sahip önceki raporları geçersiz kılar.
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önderilip gönderilmeymeyeceğ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. Sistem durumu istemcisinin sistem durumu raporu işlemenin yanı sıra sistem durumu raporlama iletilerini sistem durumu deposuna en iyi duruma getirmesine olanak sağladığından bu önerilen ayardı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 |
-NodeName
Service Fabric düğümünün adını belirtir. Cmdlet, belirttiğiniz düğümde dağıtılan bir hizmet paketi için bir sistem durumu raporu gönderir.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 Sağlık Deposu'ndan raporları 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 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 |
-ServiceManifestName
Service Fabric hizmet bildiriminin adını belirtir. ApplicationName ve NodeName ile birlikte, bu değer dağıtılan hizmet paketi sistem durumu varlığını benzersiz olarak tanımlar.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServicePackageActivationId
Dağıtılan ServicePackage'ın etkinleştirme kimliği. Bu, Get-ServiceFabricDeployedServicePackage sorgusu kullanılarak elde edilebilir.
Hizmet oluşturulurken belirtilen ServicePackageActivationMode değeri SharedProcess ise (New-ServiceFabricService
veya belirtilmezse, varsayılan olarak SharedProcess olarak ayarlanıyorsa), ServicePackageActivationId değeri her zaman boş bir dizedir ve belirtilmesi gerekmez. Hizmet paketi etkinleştirme kimliği hakkında daha fazla bilgi edinmek için bkz. [Service Fabric Barındırma Modeli][1].
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
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
İşlem için 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 olarak 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.String
System.Fabric.Health.HealthState
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