ステートフル Reliable Services の診断機能
Azure Service Fabric ステートフル Reliable Services の StatefulServiceBase クラスは、サービスのデバッグに使用することができる EventSource イベントを出力するため、ランタイムの動作状況を理解し、トラブルシューティングに役立ちます。
EventSource イベント
ステートフル Reliable Services の StatefulServiceBase クラスの EventSource 名は、"Microsoft-ServiceFabric-Services" です。このイベント ソースからのイベントは、サービスを Visual Studio でデバッグしているときに、[診断イベント] ウィンドウに表示されます。
EventSource イベントの収集や表示に役立つツールとテクノロジの例には、PerfView、Azure Diagnostics、および Microsoft TraceEvent ライブラリがあります。
events
| イベント名 | イベント ID | Level | イベントの説明 |
|---|---|---|---|
| StatefulRunAsyncInvocation | 1 | Informational | サービスの RunAsync タスクが開始されたときに出力されます |
| StatefulRunAsyncCancellation | 2 | Informational | サービスの RunAsync タスクが取り消されたときに出力されます |
| StatefulRunAsyncCompletion | 3 | Informational | サービスの RunAsync タスクが完了したときに出力されます |
| StatefulRunAsyncSlowCancellation | 4 | 警告 | サービスの RunAsync タスクが取り消しの実行に時間がかかりすぎたときに出力されます |
| StatefulRunAsyncFailure | 5 | エラー | サービスの RunAsync タスクが例外をスローしたときに出力されます |
イベントの解釈
StatefulRunAsyncInvocation、StatefulRunAsyncCompletion、および StatefulRunAsyncCancellation イベントは、サービスの作成者が、サービスのライフ サイクルや、サービスの開始、取り消し、または完了のタイミングを知るために役立ちます。 この情報はサービスの問題をデバッグする場合やサービスのライフ サイクルを理解する場合に役立つことがあります。
StatefulRunAsyncSlowCancellation および StatefulRunAsyncFailure イベントはサービスの問題を示しているため、サービスの作成者はこれらのイベントに細心の注意を払う必要があります。
StatefulRunAsyncFailure は、サービスの RunAsync() タスクが例外をスローするたびに出力されます。 一般に、スローされる例外は、サービスのエラーやバグを示します。 さらに、この例外はサービスが失敗する原因となるため、別のノードに移動されます。 この操作には高い負荷がかかる可能性があるため、サービスの移動中には要求の受信が遅れることがあります。 サービスの作成者は例外の原因を特定し、可能であればそれを軽減する必要があります。
StatefulRunAsyncSlowCancellation は、RunAsync タスクの取り消し要求が 4 秒より長くかかる場合に出力されます。 取り消しの完了に時間がかかると、サービスが別のノードで速やかに再開できなくなります。 このシナリオはサービスの全体の可用性に影響を与える可能性があります。
パフォーマンス カウンター
Reliable Services ランタイムでは、次のパフォーマンス カウンター カテゴリを定義しています。
| カテゴリ | 説明 |
|---|---|
| Service Fabric トランザクション レプリケーター | Azure Service Fabric トランザクション レプリケーターに固有のカウンター |
| Service Fabric TStore | Azure Service Fabric TStore に固有のカウンター |
Service Fabric トランザクション レプリケーターは、特定の一連のレプリカ内でトランザクションをレプリケートするために、Reliable State Manager によって使用されます。
Service Fabric TStore は、Reliable Collections でキーと値のペアを格納および取得するために使用されるコンポーネントです。
パフォーマンス カウンター データの収集と表示には、Windows オペレーティング システムで既定で使用できる Windows パフォーマンス モニター アプリケーションを使用できます。 Azure Diagnostics があります。
パフォーマンス カウンター インスタンス名
多数の Reliable Service または Reliable Service パーティションを持つクラスターには、多数のトランザクション レプリケーターのパフォーマンス カウンター インスタンスが含まれます。 これは TStore パフォーマンス カウンターの場合と同様ですが、使用されているリライアブル ディクショナリとリライアブル キューの数も乗算されます。 パフォーマンス カウンター インスタンス名は、パフォーマンス カウンター インスタンスが関連付けられている特定のパーティション、サービス レプリカ、および TStore の場合の状態プロバイダーを識別するために役立ちます。
Service Fabric トランザクション レプリケーターのカテゴリ
カテゴリ Service Fabric Transactional Replicatorでは、カウンター インスタンス名の形式は次のようになります。
ServiceFabricPartitionId:ServiceFabricReplicaId
ServiceFabricPartitionId は、パフォーマンス カウンター インスタンスが関連付けられている Service Fabric パーティション ID の文字列表現です。 パーティション ID は GUID であり、その文字列表現は書式指定子 "D" を持つ Guid.ToString を使用して生成されます。
ServiceFabricReplicaId は、Reliable Service の特定のレプリカに関連付けられている ID です。 一意性を確保し、同じパーティションによって生成された他のパフォーマンス カウンター インスタンスと競合しないように、レプリカ ID は、パフォーマンス カウンター インスタンス名の中に組み入れられています。 Reliable Services におけるレプリカとその役割に関する詳細については、こちらで確認できます。
次のカウンター インスタンス名は、Service Fabric Transactional Replicator カテゴリ下のカウンターでは一般的です。
00d0126d-3e36-4d68-98da-cc4f7195d85e:131652217797162571
この例の 00d0126d-3e36-4d68-98da-cc4f7195d85e は Service Fabric パーティション ID の文字列表現であり、131652217797162571 はレプリカ ID です。
Service Fabric TStore カテゴリ
カテゴリ Service Fabric TStoreでは、カウンター インスタンス名の形式は次のようになります。
ServiceFabricPartitionId:ServiceFabricReplicaId:StateProviderId_PerformanceCounterInstanceDifferentiator_StateProviderName
ServiceFabricPartitionId は、パフォーマンス カウンター インスタンスが関連付けられている Service Fabric パーティション ID の文字列表現です。 パーティション ID は GUID であり、その文字列表現は書式指定子 "D" を持つ Guid.ToString を使用して生成されます。
ServiceFabricReplicaId は、Reliable Service の特定のレプリカに関連付けられている ID です。 一意性を確保し、同じパーティションによって生成された他のパフォーマンス カウンター インスタンスと競合しないように、レプリカ ID は、パフォーマンス カウンター インスタンス名の中に組み入れられています。 Reliable Services におけるレプリカとその役割に関する詳細については、こちらで確認できます。
StateProviderId は、リライアブル サービス内の状態プロバイダーと関連付けられている ID です。 状態プロバイダー ID は、TStore を別の TStore と区別するために、パフォーマンス カウンター インスタンス名の中に組み入れられています。
PerformanceCounterInstanceDifferentiator は、状態プロバイダー内のパフォーマンス カウンター インスタンスに関連付けられた差別化 ID です。 一意性を確保し、同じ状態プロバイダーによって生成された他のパフォーマンス カウンター インスタンスと競合しないように、この差別化要素は、パフォーマンス カウンター インスタンス名の中に組み入れられています。
StateProviderName は、リライアブル サービス内の状態プロバイダーと関連付けられている名前です。 状態プロバイダー名は、提供する状態をユーザーが簡単に識別できるように、パフォーマンス カウンターのインスタンス名の中に組み入れられています。
次のカウンター インスタンス名は、Service Fabric TStore カテゴリ下のカウンターでは一般的です。
00d0126d-3e36-4d68-98da-cc4f7195d85e:131652217797162571:142652217797162571_1337_urn:MyReliableDictionary/dataStore
上記の例で、00d0126d-3e36-4d68-98da-cc4f7195d85e は Service Fabric パーティション ID の文字列表現、131652217797162571 はレプリカ ID、142652217797162571 は状態プロバイダー ID、1337 はパフォーマンス カウンター インスタンスの差別化要素です。 urn:MyReliableDictionary/dataStore は、urn:MyReliableDictionary という名前のコレクションのデータを格納する状態プロバイダーの名前です。
トランザクション レプリケーター パフォーマンス カウンター
Reliable Services ランタイムでは、Service Fabric Transactional Replicator カテゴリにある次のイベントを出力します。
| カウンター名 | 説明 |
|---|---|
| トランザクションの開始操作数/秒 | 1 秒あたりに作成された新しい書き込みトランザクションの数。 |
| トランザクション操作数/秒 | 1 秒あたりにリライアブル コレクションで実行される追加/更新/削除操作の数。 |
| ログのフラッシュ バイト数/秒 | 1 秒あたりにトランザクション レプリケーターによってディスクにフラッシュされるバイト数。 |
| 調整された操作数/秒 | 調整のため、トランザクション レプリケーターによって 1 秒あたりに拒否される操作の数。 |
| Avg.コミットあたりのトランザクション ミリ秒 | トランザクションあたりのミリ秒単位での平均コミット遅延時間 |
| Avg.フラッシュ待機時間 (ミリ秒) | トランザクション レプリケーターによって開始されたディスク フラッシュ操作のミリ秒単位での平均時間 |
TStore のパフォーマンス カウンター
Reliable Services ランタイムでは、Service Fabric TStore カテゴリにある次のイベントを出力します。
| カウンター名 | 説明 |
|---|---|
| 項目数 | ストアに含まれる項目数。 |
| ディスク サイズ | ストアのチェックポイント ファイルの合計ディスク サイズ (バイト)。 |
| チェックポイント ファイル書き込みバイト数/秒 | 最新のチェックポイント ファイルで 1 秒あたりに書き込まれたバイト数。 |
| コピー ディスク転送バイト数/秒 | ストア コピー中に (プライマリ レプリカ上で) 読み取られたディスク バイト数/秒と (セカンダリ レプリカ上で) 書き込まれたディスク バイト数/秒。 |