Erstellen von Leistungsindikatoren zum Nachverfolgen der Leistung des Shardzuordnungs-Managers

Artikel
06/02/2023

Mit Leistungsindikatoren wird die Leistung der Vorgänge bei datenabhängigem Routing nachverfolgt. Auf diese Leistungsindikatoren kann im Systemmonitor in der Kategorie „Elastic Database: Shard Management“ (Elastische Datenbank: Shardverwaltung) zugegriffen werden.

Sie können die Leistung eines Shardzuordnungs-Managers insbesondere bei der Verwendung des datenabhängigen Routings erfassen. Leistungsindikatoren werden mit Methoden der Klasse „Microsoft.Azure.SqlDatabase.ElasticScale.Client“ erstellt.

Aktuelle Version: Besuchen Sie Microsoft.Azure.SqlDatabase.ElasticScale.Client. Siehe auch Upgrade einer App auf die neueste Clientbibliothek für elastische Datenbanken.

Voraussetzungen

Damit der Benutzer die Leistungskategorie und -indikatoren erstellen kann, muss er Mitglied der lokalen Gruppe Administratoren auf dem Computer mit der Anwendung sein.
Damit der Benutzer eine Leistungsindikatorinstanz erstellen und die Leistungsindikatoren aktualisieren kann, muss er entweder Mitglied der Gruppe Administratoren oder Mitglied der Gruppe Leistungsüberwachungsbenutzer sein.

Erstellen der Leistungskategorie und Leistungsindikatoren

Rufen Sie zum Erstellen der Leistungsindikatoren die CreatePerformanceCategoryAndCounters-Methode der ShardMapManagementFactory-Klasse auf. Nur ein Administrator kann die Methode ausführen:

ShardMapManagerFactory.CreatePerformanceCategoryAndCounters()

Sie können auch dieses PowerShell-Skript zum Ausführen der Methode verwenden. Die Methode erstellt die folgenden Leistungsindikatoren:

Cached mappings (Zwischengespeicherte Zuordnungen): Anzahl der Zuordnungen, die für die Shardzuordnung zwischengespeichert werden.
DDR operations/sec (DDR-Vorgänge/s): Rate der Vorgänge für datenabhängiges Routing für die Shardzuordnung. Dieser Leistungsindikator wird aktualisiert, wenn ein Aufruf von OpenConnectionForKey() zu einer erfolgreichen Verbindung mit dem Zielshard führt.
Mapping lookup cache hits/sec (Cachetreffer bei der Zuordnungssuche/s): Rate der erfolgreichen Cachesuchvorgänge für Zuordnungen in der Shardzuordnung.
Mapping lookup cache misses/sec (Cachefehler bei der Zuordnungssuche/s): Rate der fehlerhaften Cachsuchvorgänge für Zuordnungen in der Shardzuordnung.
Mappings added or updated in cache/sec (Im Cache hinzugefügte oder aktualisierte Zuordnungen/s): Rate, mit der Zuordnungen im Cache für die Shardzuordnung hinzugefügt oder aktualisiert werden.
Mappings removed from cache/sec (Aus dem Cache entfernte Zuordnungen/s): Rate, mit der Zuordnungen aus dem Cache für die Shardzuordnung entfernt werden.

Leistungsindikatoren werden für jede zwischengespeicherte Shardzuordnung pro Prozess erstellt.

Notizen

Die folgenden Ereignisse lösen die Erstellung der Leistungsindikatoren aus:

Initialisierung von ShardMapManager mit Eager Loading, wenn der ShardMapManager Shardzuordnungen enthält. Dazu gehören die Methoden GetSqlShardMapManager und TryGetSqlShardMapManager.
Erfolgreiches Nachschlagen einer Shardzuordnung (unter Verwendung von GetShardMap(), GetListShardMap() oder GetRangeShardMap()).
Erfolgreiche Erstellung einer Shardzuordnung mit „CreateShardMap()“.

Die Leistungsindikatoren werden von allen Cachevorgängen aktualisiert, die für die Shardzuordnung und Zuordnungen ausgeführt werden. Wird die Shardzuordnung mit DeleteShardMap() erfolgreich entfernt, führt dies zu einer Löschung der Leistungsindikatorinstanz.

Bewährte Methoden

Die Erstellung der Leistungskategorie und -indikatoren sollte nur einmal vor der Erstellung des ShardMapManager-Objekts erfolgen. Jede Ausführung des Befehls „CreatePerformanceCategoryAndCounters()“ löscht die vorherigen Leistungsindikatoren (von allen Instanzen werden Datenverluste gemeldet) und erstellt neue.
Leistungsindikatorinstanzen werden pro Prozess erstellt. Jeder Anwendungsabsturz oder jede Entfernung einer Shardzuordnung aus dem Cache führt dazu, dass die Leistungsindikatorinstanzen gelöscht werden.

Weitere Informationen

Übersicht über Features für elastische Datenbanken

Zusätzliche Ressourcen

Verwenden Sie noch keine elastischen Datenbanktools? Sehen Sie sich unseren Leitfaden zu den ersten Schritten an. Wenden Sie sich bei Fragen auf der Frageseite von Microsoft Q&A für SQL-Datenbank und für Featureanforderungen an uns, fügen Sie neue Ideen hinzu, oder stimmen Sie im SQL-Datenbank-Feedbackforumüber vorhandene Ideen ab.