Reliable Actors için tanılama ve performans izlemesi

  • Makale

Reliable Actors çalışma zamanı EventSource olaylarını ve performans sayaçlarını yayar. Bunlar çalışma zamanının nasıl çalıştığını gösteren içgörüler sağlar ve sorun giderme ve performans izleme konusunda yardımcı olur.

EventSource olayları

Reliable Actors çalışma zamanının EventSource sağlayıcı adı "Microsoft-ServiceFabric-Actors" şeklindedir. Bu olay kaynağındaki olaylar, aktör uygulaması Visual Studio'da hata ayıklanırken Tanılama Olayları penceresinde görüntülenir.

EventSource olaylarını toplamaya ve/veya görüntülemeye yardımcı olan araçlara ve teknolojilere örnek olarak PerfView, Azure Tanılama, Anlam Günlüğü ve Microsoft TraceEvent Kitaplığı verilebilir.

Anahtar sözcükler

Reliable Actors EventSource'a ait tüm olaylar bir veya daha fazla anahtar sözcükle ilişkilendirilir. Bu, toplanan olayların filtrelenmesine olanak tanır. Aşağıdaki anahtar sözcük bitleri tanımlanır.

Bit Açıklama
0x1 Doku Aktörleri çalışma zamanının çalışmasını özetleyen önemli olaylar kümesi.
0x2 Aktör yöntemi çağrılarını açıklayan olaylar kümesi. Daha fazla bilgi için aktörlerle ilgili giriş konusuna bakın.
0x4 Aktör durumuyla ilgili olaylar kümesi. Daha fazla bilgi için aktör durumu yönetimi konusuna bakın.
0x8 Aktördeki sıra tabanlı eşzamanlılık ile ilgili olaylar kümesi. Daha fazla bilgi için eşzamanlılık konusuna bakın.

Performans sayaçları

Reliable Actors çalışma zamanı aşağıdaki performans sayacı kategorilerini tanımlar.

Kategori Açıklama
Service Fabric Actor Azure Service Fabric aktörlerine özgü sayaçlar, örneğin aktör durumundan tasarruf etmek için geçen süre
Service Fabric Actor Yöntemi Service Fabric aktörleri tarafından uygulanan yöntemlere özgü sayaçlar, örneğin bir aktör yönteminin çağrılma sıklıkları

Yukarıdaki kategorilerin her birinde bir veya daha fazla sayaç vardır.

Windows işletim sisteminde varsayılan olarak kullanılabilen Windows Performans İzleyicisi uygulaması, performans sayacı verilerini toplamak ve görüntülemek için kullanılabilir. Azure Tanılama, performans sayacı verilerini toplamak ve Azure tablolarına yüklemek için başka bir seçenektir.

Performans sayacı örneği adları

Çok sayıda aktör hizmeti veya aktör hizmeti bölümü olan bir kümede çok sayıda aktör performans sayacı örneği olacaktır. Performans sayacı örneği adları, performans sayacı örneğinin ilişkili olduğu belirli bölüm ve aktör yöntemini (varsa) tanımlamaya yardımcı olabilir.

Service Fabric Actor kategorisi

kategorisi Service Fabric Actoriçin, sayaç örneği adları aşağıdaki biçimdedir:

ServiceFabricPartitionID_ActorsRuntimeInternalID

ServiceFabricPartitionID , performans sayacı örneğinin ilişkili olduğu Service Fabric bölüm kimliğinin dize gösterimidir. Bölüm kimliği bir GUID'dir ve dize gösterimi, "D" biçim tanımlayıcısı Guid.ToString ile yöntemi aracılığıyla oluşturulur.

ActorRuntimeInternalID , İç kullanımı için Doku Aktörleri çalışma zamanı tarafından oluşturulan 64 bitlik bir tamsayının dize gösterimidir. Bu, benzersiz olduğundan emin olmak ve diğer performans sayacı örnek adlarıyla çakışmayı önlemek için performans sayacı örneği adına eklenir. Kullanıcılar, performans sayacı örneği adının bu bölümünü yorumlamayı denememelidir.

Aşağıda, kategoriye ait Service Fabric Actor bir sayaç için sayaç örneği adı örneği verilmiştir:

2740af29-78aa-44bc-a20b-7e60fb783264_635650083799324046

Yukarıdaki örnekte Service 2740af29-78aa-44bc-a20b-7e60fb783264 Fabric bölüm kimliğinin dize gösterimi ve 635650083799324046 çalışma zamanının iç kullanımı için oluşturulan 64 bit kimliktir.

Service Fabric Actor Yöntemi kategorisi

kategorisi Service Fabric Actor Methodiçin, sayaç örneği adları aşağıdaki biçimdedir:

MethodName_ActorsRuntimeMethodId_ServiceFabricPartitionID_ActorsRuntimeInternalID

MethodName , performans sayacı örneğinin ilişkili olduğu aktör yönteminin adıdır. Yöntem adının biçimi, Windows'daki performans sayacı örnek adlarının uzunluk üst sınırındaki kısıtlamalarla adın okunabilirliğini dengeleyen Yapı Aktörleri çalışma zamanındaki bir mantık temelinde belirlenir.

ActorsRuntimeMethodId , İç kullanım için Doku Aktörleri çalışma zamanı tarafından oluşturulan 32 bitlik bir tamsayının dize gösterimidir. Bu, benzersiz olduğundan emin olmak ve diğer performans sayacı örnek adlarıyla çakışmayı önlemek için performans sayacı örneği adına eklenir. Kullanıcılar, performans sayacı örneği adının bu bölümünü yorumlamayı denememelidir.

ServiceFabricPartitionID , performans sayacı örneğinin ilişkili olduğu Service Fabric bölüm kimliğinin dize gösterimidir. Bölüm kimliği bir GUID'dir ve dize gösterimi, "D" biçim tanımlayıcısı Guid.ToString ile yöntemi aracılığıyla oluşturulur.

ActorRuntimeInternalID , İç kullanımı için Doku Aktörleri çalışma zamanı tarafından oluşturulan 64 bitlik bir tamsayının dize gösterimidir. Bu, benzersiz olduğundan emin olmak ve diğer performans sayacı örnek adlarıyla çakışmayı önlemek için performans sayacı örneği adına eklenir. Kullanıcılar, performans sayacı örneği adının bu bölümünü yorumlamayı denememelidir.

Aşağıda, kategoriye ait Service Fabric Actor Method bir sayaç için sayaç örneği adı örneği verilmiştir:

ivoicemailboxactor.leavemessageasync_2_89383d32-e57e-4a9b-a6ad-57c6792aa521_635650083804480486

Yukarıdaki ivoicemailboxactor.leavemessageasync örnekte yöntem adı 2 , çalışma zamanının iç kullanımı için oluşturulan 32 bit kimlik, 89383d32-e57e-4a9b-a6ad-57c6792aa521 Service Fabric bölüm kimliğinin dize gösterimi ve 635650083804480486 çalışma zamanının iç kullanımı için oluşturulan 64 bit kimliktir.

Olaylar ve performans sayaçları listesi

Aktör yöntemi olayları ve performans sayaçları

Reliable Actors çalışma zamanı aktör yöntemleriyle ilgili aşağıdaki olayları yayar.

Olay adı Olay Kimliği Level Anahtar sözcük Açıklama
ActorMethodStart 7 Ayrıntılı 0x2 Actors çalışma zamanı bir aktör yöntemini çağırmak üzere.
ActorMethodStop 8 Ayrıntılı 0x2 Aktör yönteminin yürütülmesi tamamlandı. Başka bir ifadeyle, çalışma zamanının aktör yöntemine zaman uyumsuz çağrısı döndürülür ve aktör yöntemi tarafından döndürülen görev tamamlanmıştır.
ActorMethodThrewException 9 Uyarı 0x3 Bir aktör yönteminin yürütülmesi sırasında, çalışma zamanının aktör yöntemine zaman uyumsuz çağrısı sırasında veya aktör yöntemi tarafından döndürülen görevin yürütülmesi sırasında bir özel durum oluştu. Bu olay, aktör kodunda araştırılması gereken bir tür hata olduğunu gösterir.

Reliable Actors çalışma zamanı, aktör yöntemlerinin yürütülmesiyle ilgili olarak aşağıdaki performans sayaçlarını yayımlar.

Kategori adı Sayaç adı Açıklama
Service Fabric Actor Yöntemi Çağırmalar/Sn Aktör hizmeti yönteminin saniye başına çağrılma sayısı
Service Fabric Actor Yöntemi Çağırma başına ortalama milisaniye Aktör hizmet yönteminin milisaniye cinsinden yürütülmesi için geçen süre
Service Fabric Actor Yöntemi Özel durumlar oluştu/Sn Aktör hizmeti yönteminin saniye başına özel durum oluşturma sayısı

Eşzamanlılık olayları ve performans sayaçları

Reliable Actors çalışma zamanı eşzamanlılık ile ilgili aşağıdaki olayları yayar.

Olay adı Olay Kimliği Level Anahtar sözcük Açıklama
ActorMethodCallsWaitingForLock 12 Ayrıntılı 0x8 Bu olay, bir aktördeki her yeni dönüşün başında yazılır. Sıra tabanlı eşzamanlılığı zorlayan aktör başına kilidi almayı bekleyen bekleyen aktör çağrılarının sayısını içerir.

Reliable Actors çalışma zamanı eşzamanlılık ile ilgili aşağıdaki performans sayaçlarını yayımlar.

Kategori adı Sayaç adı Açıklama
Service Fabric Actor # of actor calls waiting for actor lock Sıra tabanlı eşzamanlılığı zorlayan aktör başına kilidi almak için bekleyen aktör çağrılarının sayısı
Service Fabric Actor Kilit başına ortalama milisaniye bekleme Sıra tabanlı eşzamanlılığı zorlayan aktör başına kilidi almak için geçen süre (milisaniye cinsinden)
Service Fabric Actor Ortalama milisaniye aktör kilidi tutuldu Aktör başına kilidin tutıldığı süre (milisaniye cinsinden)

Aktör durumu yönetim olayları ve performans sayaçları

Reliable Actors çalışma zamanı aktör durumu yönetimiyle ilgili aşağıdaki olayları yayar.

Olay adı Olay Kimliği Level Anahtar sözcük Açıklama
ActorSaveStateStart 10 Ayrıntılı 0x4 Aktörler çalışma zamanı aktör durumunu kaydetmek üzere.
ActorSaveStateStop 11 Ayrıntılı 0x4 Aktörler çalışma zamanı aktör durumunu kaydetmeyi tamamladı.

Reliable Actors çalışma zamanı aktör durumu yönetimiyle ilgili aşağıdaki performans sayaçlarını yayımlar.

Kategori adı Sayaç adı Açıklama
Service Fabric Actor Kaydetme durumu işlemi başına ortalama milisaniye Aktör durumunu milisaniye cinsinden kaydetmek için geçen süre
Service Fabric Actor Yük durumu işlemi başına ortalama milisaniye Aktör durumunu milisaniye cinsinden yüklemek için geçen süre

Reliable Actors çalışma zamanı, aktör çoğaltmalarıyla ilgili aşağıdaki olayları yayar.

Olay adı Olay Kimliği Level Anahtar sözcük Açıklama
ReplicaChangeRoleToPrimary 1 Bilgi 0x1 Aktör çoğaltması rolü Birincil olarak değiştirildi. Bu, bu bölümün aktörlerinin bu çoğaltma içinde oluşturulacağını gösterir.
ReplicaChangeRoleFromPrimary 2 Bilgi 0x1 Aktör çoğaltması rolü Birincil olmayan olarak değiştirdi. Bu, bu bölümün aktörlerinin artık bu çoğaltma içinde oluşturulmayacaklarını gösterir. Bu çoğaltmada önceden oluşturulmuş aktörlere yeni istek teslim edilmeyecek. Devam eden istekler tamamlandıktan sonra aktörler yok edilir.

Aktör etkinleştirme ve devre dışı bırakma olayları ve performans sayaçları

Reliable Actors çalışma zamanı, aktör etkinleştirme ve devre dışı bırakma ile ilgili aşağıdaki olayları yayar.

Olay adı Olay Kimliği Level Anahtar sözcük Açıklama
ActorActivated 5 Bilgi 0x1 Bir aktör etkinleştirildi.
ActorDeactivated 6 Bilgi 0x1 Bir aktör devre dışı bırakıldı.

Reliable Actors çalışma zamanı, aktör etkinleştirme ve devre dışı bırakma ile ilgili aşağıdaki performans sayaçlarını yayımlar.

Kategori adı Sayaç adı Açıklama
Service Fabric Actor Ortalama OnActivateAsync milisaniye OnActivateAsync yöntemini milisaniye cinsinden yürütmek için geçen süre

Aktör isteği işleme performans sayaçları

İstemci bir aktör proxy nesnesi aracılığıyla bir yöntem çağırdığında, ağ üzerinden aktör hizmetine bir istek iletisi gönderilmesiyle sonuçlanıyor. Hizmet, istek iletisini işler ve istemciye geri bir yanıt gönderir. Reliable Actors çalışma zamanı, aktör isteği işlemeyle ilgili aşağıdaki performans sayaçlarını yayımlar.

Kategori adı Sayaç adı Açıklama
Service Fabric Actor Bekleyen istek sayısı Hizmette işlenen istek sayısı
Service Fabric Actor İstek başına ortalama milisaniye Bir isteği işlemek için hizmet tarafından geçen süre (milisaniye cinsinden)
Service Fabric Actor İstek seri durumdan çıkarma için ortalama milisaniye Hizmette alınan aktör isteği iletisinin seri durumdan çıkarılması için geçen süre (milisaniye cinsinden)
Service Fabric Actor Yanıt serileştirme için ortalama milisaniye Yanıt istemciye gönderilmeden önce hizmetteki aktör yanıt iletisini seri hale getirmek için geçen süre (milisaniye cinsinden)

Sonraki adımlar