パフォーマンスカウンターを作成してシャードマップマネージャーのパフォーマンスを追跡する

パフォーマンスカウンターを使用して、データ依存ルーティング操作のパフォーマンスを追跡します。これらのカウンターは、パフォーマンスモニターの [エラスティックデータベース: シャード管理] カテゴリでアクセスできます。

特にデータ依存ルーティングを使用するときに、シャードマップマネージャーのパフォーマンスをキャプチャできます。カウンターは、Microsoft.Azure.SqlDatabase.ElasticScale.Client クラスのメソッドを使用して作成されます。

前提条件

パフォーマンスカテゴリとカウンターを作成するには、アプリケーションをホストするコンピューター上でユーザーがローカルな Administrators グループの一員になっている必要があります。
パフォーマンスカウンターインスタンスを作成し、カウンターを更新するには、ユーザーが Administrators グループまたは Performance Monitor Users グループの一員になっている必要があります。

カウンターを作成するには、ShardMapManagementFactory クラスの CreatePerformanceCategoryAndCounters メソッドを呼び出します。このメソッドは、管理者だけが実行できます。

ShardMapManagerFactory.CreatePerformanceCategoryAndCounters()

この PowerShell スクリプトを使用してメソッドを実行することもできます。このメソッドは、次のパフォーマンスカウンターを作成します。

キャッシュされたマッピング: シャードマップ用にキャッシュされたマッピングの数です。
DDR 操作数/秒: シャードマップ用のデータ依存ルーティング操作の割合です。このカウンターは、 OpenConnectionForKey() に対する呼び出しで宛先のシャードへの接続が成功したときに更新されます。
マッピングのキャッシュ検索ヒット数/秒: シャードマップでのマッピングで成功したキャッシュ検索操作の割合です。
マッピングのキャッシュ検索ミス数/秒: シャードマップでのマッピングで失敗したキャッシュ検索操作の割合です。
キャッシュに追加または更新されたマッピング数/秒: シャードマップ用のキャッシュに追加または更新されたマッピングの割合です。
キャッシュから削除されたマッピング数/秒: シャードマップ用のキャッシュから削除されたマッピングの割合です。

パフォーマンスカウンターは、それぞれのキャッシュされたシャードマップで、プロセスごとに作成されます。

次のイベントは、パフォーマンスカウンターの作成をトリガーします。

一括読み込みによる ShardMapManager の初期化 (ShardMapManager にシャードマップが含まれている場合)。 GetSqlShardMapManager メソッドと TryGetSqlShardMapManager メソッドを含みます。
シャードマップの検索の成功 (GetShardMap()、GetListShardMap()、または GetRangeShardMap() を使用)。
CreateShardMap() を使用したシャードマップの作成の成功。

パフォーマンスカウンターは、シャードマップとマッピングに対して実行されるすべてのキャッシュ操作によって更新されます。 DeleteShardMap () を使用してシャードマップが正常に削除されると、パフォーマンスカウンターインスタンスも削除されます。

パフォーマンスカテゴリとカウンターの作成は、ShardMapManager オブジェクトの作成前に 1 回だけ実行する必要があります。 CreatePerformanceCategoryAndCounters() コマンドを実行するたびに前のカウンターがクリアされ (すべてのインスタンスによって報告されたデータが失われ)、新しいカウンターが作成されます。
パフォーマンスカウンターインスタンスは、プロセスごとに作成されます。パフォーマンスカウンターインスタンスは、アプリケーションがクラッシュするか、シャードマップがキャッシュから削除されると削除されます。

まだ弾力性データベースツールを使用していない場合は、ファーストステップガイドを参照してください。ご質問がある場合は、SQL Database に関する Microsoft Q&A 質問ページを参照してください。機能に関するご要望は、SQL Database に関するフィードバックフォーラムで新しいアイデアを追加したり、既存のアイデアに投票したりしてください。