Rapor Uygulaması Sistem Durumu
Service Fabric uygulamasında bir sistem durumu raporu gönderir.
Belirtilen Service Fabric uygulamasının sistem durumunu bildirir. Rapor, raporlandığı sistem durumu raporunun ve özelliğinin kaynağı hakkındaki bilgileri içermelidir. Rapor, sistem durumu deposuna iletilen bir Service Fabric ağ geçidi uygulamasına gönderilir. Rapor ağ geçidi tarafından kabul edilebilir, ancak ek doğrulamadan sonra sistem durumu deposu tarafından reddedilir. Ö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 uygulama durumunu alın ve raporun HealthEvents bölümünde görüntülenip görüntülenmediğini denetleyin.
İstek
Yöntem | İstek URI'si |
---|---|
POST | /Applications/{applicationId}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout} |
Parametreler
Ad | Tür | Gerekli | Konum |
---|---|---|---|
applicationId |
string | Yes | Yol |
api-version |
string | Yes | Sorgu |
Immediate |
boolean | No | Sorgu |
timeout |
integer (int64) | No | Sorgu |
HealthInformation |
HealthInformation | Yes | Gövde |
applicationId
Tür: dize
Gerekli: Evet
Uygulamanın kimliği. Bu genellikle 'fabric:' URI şeması olmayan uygulamanın tam adıdır.
Sürüm 6.0'dan başlayarak hiyerarşik adlar "~" karakteriyle sınırlandırılır.
Örneğin, uygulama adı "fabric:/myapp/app1" ise, uygulama kimliği 6.0+ sürümünde "myapp~app1" ve önceki sürümlerde "myapp/app1" olacaktır.
api-version
Tür: dize
Gerekli: Evet
Varsayılan: 6.0
API sürümü. Bu parametre gereklidir ve değeri '6.0' olmalıdır.
Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenenden farklı olabilir.
Buna ek olarak çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul ediyor. Bu nedenle, en son API sürümü 6.0 ise ancak çalışma zamanı 6.1 ise, istemcileri yazmayı kolaylaştırmak için çalışma zamanı bu API için sürüm 6.1'i kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.
Immediate
Tür: boole
Gerekli: Hayır
Varsayılan: false
Raporun hemen gönderilmesi gerekip gerekmediğini gösteren bir bayrak.
Sistem durumu raporu, sistem durumu deposuna iletilen bir Service Fabric ağ geçidi uygulamasına gönderilir.
Anında ayarı true olarak ayarlanırsa rapor, HTTP Ağ Geçidi Uygulamasının kullandığı doku istemci ayarlarına bakılmaksızın http ağ geçidinden sistem durumu deposuna hemen gönderilir.
Bu, en kısa sürede gönderilmesi gereken kritik raporlar için kullanışlıdır.
Zamanlamaya ve diğer koşullara bağlı olarak, örneğin HTTP Ağ Geçidi kapatılırsa veya ileti Ağ Geçidi'ne ulaşmazsa raporu gönderme işlemi başarısız olmaya devam edebilir.
Anlık ayarı false olarak ayarlanırsa, rapor HTTP Ağ Geçidi'nden sistem durumu istemci ayarlarına göre gönderilir. Bu nedenle, HealthReportSendInterval yapılandırmasına göre toplu işlenecektir.
Bu, sistem durumu istemcisinin sistem durumu raporlama iletilerini sistem durumu deposuna ve sistem durumu raporu işlemeye en iyi duruma getirmesine olanak tanıdığından önerilen ayardır.
Varsayılan olarak, raporlar hemen gönderilmez.
timeout
Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1
İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.
HealthInformation
Tür: HealthInformation
Gerekli: Evet
Sistem durumu raporunun sistem durumu bilgilerini açıklar. Bu bilgilerin sistem durumu yöneticisine gönderilen tüm sistem durumu raporlarında bulunması gerekir.
Yanıtlar
HTTP Durum Kodu | Description | Yanıt Şeması |
---|---|---|
200 (Tamam) | Başarılı bir işlem 200 durum kodu döndürür. |
|
Diğer tüm durum kodları | Ayrıntılı hata yanıtı. |
Doku Oluşturucu |