Aracılığıyla paylaş

Rapor Hizmeti Durumu

  • Makale

Service Fabric hizmetinde bir sistem durumu raporu gönderir.

Belirtilen Service Fabric hizmetinin sistem durumunu bildirir. Rapor, raporlandığı sistem durumu raporunun ve özelliğin kaynağı hakkındaki bilgileri içermelidir. Rapor, sistem durumu deposuna iletilen bir Service Fabric ağ geçidi hizmetine 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 sıra numarası gibi geçersiz bir parametre nedeniyle raporu reddedebilir. Raporun sistem durumu deposuna uygulanıp uygulanmadığını görmek için GetServiceHealth komutunu çalıştırın ve raporun HealthEvents bölümünde görünüp görünmediğini denetleyin.

İstek

Yöntem İstek URI'si
POST /Services/{serviceId}/$/ReportHealth?api-version=6.0&Immediate={Immediate}&timeout={timeout}

Parametreler

Ad Tür Gerekli Konum
serviceId string Yes Yol
api-version string Yes Sorgu
Immediate boolean No Sorgu
timeout integer (int64) No Sorgu
HealthInformation HealthInformation Yes Gövde

serviceId

Tür: dize
Gerekli: Evet

Hizmetin kimliği. Bu kimlik genellikle 'fabric:' URI şeması olmayan hizmetin tam adıdır. Sürüm 6.0'dan başlayarak, hiyerarşik adlar "~" karakteriyle sınırlandırılır. Örneğin, hizmet adı "fabric:/myapp/app1/svc1" ise, hizmet kimliği 6.0+ sürümünde "myapp~app1~svc1" ve önceki sürümlerde "myapp/app1/svc1" olur.

api-version

Tür: dize
Gerekli: Evet
Varsayılan: 6.0

API'nin 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 belgelenen yanıttan farklı olabilir.

Ayrıca ç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 edin. 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 bayrak. Sistem durumu raporu, sistem durumu deposuna iletilen bir Service Fabric ağ geçidi uygulamasına gönderilir. Immediate değeri true olarak ayarlanırsa, RAPOR HTTP Ağ Geçidi'nden http ağ geçidi uygulamasının kullandığı doku istemci ayarlarına bakılmaksızın hemen sistem durumu deposuna 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 yine başarısız olabilir. Anlık değer 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 ö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, 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 raporu için sistem durumu bilgilerini açıklar. Bu bilgilerin sistem durumu yöneticisine gönderilen tüm sistem durumu raporlarında mevcut olması 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