Compteurs de performances dans SqlClient
S’applique à : 
.NET Framework 
.NET Core .NET Standard
Vous pouvez utiliser des compteurs de performances Microsoft.Data.SqlClient pour surveiller l’état de votre application et les ressources de connexion qu’elle utilise. Vous pouvez surveiller les compteurs de performance à l'aide de l'Analyseur de performances Windows ou accéder à ces derniers par programme à l'aide de la classe PerformanceCounter dans l'espace de noms System.Diagnostics.
Compteurs de performances disponibles
Actuellement, il existe 14 compteurs de performances différents disponibles pour Microsoft.Data.SqlClient, comme décrit dans le tableau suivant.
| Compteur de performances | Description |
|---|---|
HardConnectsPerSecond |
Nombre de connexions par seconde qui sont établies à un serveur de base de données. |
HardDisconnectsPerSecond |
Nombre de déconnexions par seconde qui sont effectuées à un serveur de base de données. |
NumberOfActiveConnectionPoolGroups |
Nombre de groupes du pool de connexion unique qui sont actifs. Ce compteur est contrôlé par le nombre de chaînes de connexion uniques qui se trouvent dans AppDomain. |
NumberOfActiveConnectionPools |
Nombre total de regroupements de connexions. |
NumberOfActiveConnections |
Nombre de connexions actives en cours d'utilisation. Remarque : Ce compteur de performance n’est pas activé par défaut. Pour activer ce compteur de performance, voir Activation des compteurs désactivés par défaut. |
NumberOfFreeConnections |
Nombre de connexions disponibles pour une utilisation dans les regroupements de connexions. Remarque : Ce compteur de performance n’est pas activé par défaut. Pour activer ce compteur de performance, voir Activation des compteurs désactivés par défaut. |
NumberOfInactiveConnectionPoolGroups |
Nombre de groupes du regroupement de connexions unique qui sont marqués pour le nettoyage. Ce compteur est contrôlé par le nombre de chaînes de connexion uniques qui se trouvent dans AppDomain. |
NumberOfInactiveConnectionPools |
Nombre de regroupements de connexions inactifs sans activité récente et en attente de suppression. |
NumberOfNonPooledConnections |
Nombre de connexions actives qui n'ont pas été regroupées. |
NumberOfPooledConnections |
Nombre de connexions actives qui sont gérées par l'infrastructure de regroupement de connexions. |
NumberOfReclaimedConnections |
Nombre de connexions ayant été récupérées par le biais du garbage collection dans lequel Close ou Dispose n'a pas été appelé par l'application. Remarque La fermeture ou la suppression explicite des connexions nuit aux performances. |
NumberOfStasisConnections |
Nombre de connexions en attente de l'achèvement d'une action et par conséquent non disponibles pour une utilisation par votre application. |
SoftConnectsPerSecond |
Nombre de connexions actives en cours d'extraction du regroupement de connexions. Remarque : Ce compteur de performance n’est pas activé par défaut. Pour activer ce compteur de performance, voir Activation des compteurs désactivés par défaut. |
SoftDisconnectsPerSecond |
Nombre de connexions actives retournées au regroupement de connexions. Remarque : Ce compteur de performance n’est pas activé par défaut. Pour activer ce compteur de performance, voir Activation des compteurs désactivés par défaut. |
Activer les compteurs désactivés par défaut
Les compteurs de performance NumberOfFreeConnections, NumberOfActiveConnections, SoftDisconnectsPerSecond et SoftConnectsPerSecond sont désactivés par défaut. Ajoutez les informations suivantes dans le fichier de configuration de l'application pour les activer :
<system.diagnostics>
<switches>
<add name="ConnectionPoolPerformanceCounterDetail" value="4"/>
<!-- A value of 4 corresponds to System.Diagnostics.TraceLevel.Verbose -->
</switches>
</system.diagnostics>
Récupérer les valeurs des compteurs de performances
L'application console suivante montre comment récupérer les valeurs de compteur de performance dans votre application. Les connexions doivent être ouvertes et actives pour que les informations soient retournées pour l’ensemble des compteurs de performances du fournisseur de données Microsoft SqlClient pour SQL Server.
Notes
Cet exemple utilise la base de données d’exemple AdventureWorks. Les chaînes de connexion fournies dans l’exemple de code supposent que la base de données est installée et disponible sur l’ordinateur local, et que vous avez créé des connexions qui correspondent à celles fournies dans les chaînes de connexion. Vous devrez peut-être activer les connexions SQL Server si votre serveur est configuré à l'aide des paramètres de sécurité par défaut qui autorisent uniquement l'authentification Windows. Modifiez les chaînes de connexion en fonction de votre environnement.
Exemple
using System;
using Microsoft.Data.SqlClient;
using System.Diagnostics;
using System.Runtime.InteropServices;
namespace PerformanceCounterTest
{
class Program
{
PerformanceCounter[] PerfCounters = new PerformanceCounter[10];
SqlConnection connection = new SqlConnection();
static void Main()
{
Program prog = new Program();
// Open a connection and create the performance counters.
prog.connection.ConnectionString =
GetIntegratedSecurityConnectionString();
prog.SetUpPerformanceCounters();
Console.WriteLine("Available Performance Counters:");
// Create the connections and display the results.
prog.CreateConnections();
Console.WriteLine("Press Enter to finish.");
Console.ReadLine();
}
private void CreateConnections()
{
// List the Performance counters.
WritePerformanceCounters();
// Create 4 connections and display counter information.
SqlConnection connection1 = new SqlConnection(
GetIntegratedSecurityConnectionString());
connection1.Open();
Console.WriteLine("Opened the 1st Connection:");
WritePerformanceCounters();
SqlConnection connection2 = new SqlConnection(
GetSqlConnectionStringDifferent());
connection2.Open();
Console.WriteLine("Opened the 2nd Connection:");
WritePerformanceCounters();
SqlConnection connection3 = new SqlConnection(
GetSqlConnectionString());
connection3.Open();
Console.WriteLine("Opened the 3rd Connection:");
WritePerformanceCounters();
SqlConnection connection4 = new SqlConnection(
GetSqlConnectionString());
connection4.Open();
Console.WriteLine("Opened the 4th Connection:");
WritePerformanceCounters();
connection1.Close();
Console.WriteLine("Closed the 1st Connection:");
WritePerformanceCounters();
connection2.Close();
Console.WriteLine("Closed the 2nd Connection:");
WritePerformanceCounters();
connection3.Close();
Console.WriteLine("Closed the 3rd Connection:");
WritePerformanceCounters();
connection4.Close();
Console.WriteLine("Closed the 4th Connection:");
WritePerformanceCounters();
}
private enum ADO_Net_Performance_Counters
{
NumberOfActiveConnectionPools,
NumberOfReclaimedConnections,
HardConnectsPerSecond,
HardDisconnectsPerSecond,
NumberOfActiveConnectionPoolGroups,
NumberOfInactiveConnectionPoolGroups,
NumberOfInactiveConnectionPools,
NumberOfNonPooledConnections,
NumberOfPooledConnections,
NumberOfStasisConnections
// The following performance counters are more expensive to track.
// Enable ConnectionPoolPerformanceCounterDetail in your config file.
// SoftConnectsPerSecond
// SoftDisconnectsPerSecond
// NumberOfActiveConnections
// NumberOfFreeConnections
}
private void SetUpPerformanceCounters()
{
connection.Close();
this.PerfCounters = new PerformanceCounter[10];
string instanceName = GetInstanceName();
Type apc = typeof(ADO_Net_Performance_Counters);
int i = 0;
foreach (string s in Enum.GetNames(apc))
{
this.PerfCounters[i] = new PerformanceCounter();
this.PerfCounters[i].CategoryName = ".NET Data Provider for SqlServer";
this.PerfCounters[i].CounterName = s;
this.PerfCounters[i].InstanceName = instanceName;
i++;
}
}
[DllImport("kernel32.dll", SetLastError = true)]
static extern int GetCurrentProcessId();
private string GetInstanceName()
{
//This works for Winforms apps.
string instanceName =
System.Reflection.Assembly.GetEntryAssembly().GetName().Name;
// Must replace special characters like (, ), #, /, \\
string instanceName2 =
AppDomain.CurrentDomain.FriendlyName.ToString().Replace('(', '[')
.Replace(')', ']').Replace('#', '_').Replace('/', '_').Replace('\\', '_');
// For ASP.NET applications your instanceName will be your CurrentDomain's
// FriendlyName. Replace the line above that sets the instanceName with this:
// instanceName = AppDomain.CurrentDomain.FriendlyName.ToString().Replace('(','[')
// .Replace(')',']').Replace('#','_').Replace('/','_').Replace('\\','_');
string pid = GetCurrentProcessId().ToString();
instanceName = instanceName + "[" + pid + "]";
Console.WriteLine("Instance Name: {0}", instanceName);
Console.WriteLine("---------------------------");
return instanceName;
}
private void WritePerformanceCounters()
{
Console.WriteLine("---------------------------");
foreach (PerformanceCounter p in this.PerfCounters)
{
Console.WriteLine("{0} = {1}", p.CounterName, p.NextValue());
}
Console.WriteLine("---------------------------");
}
private static string GetIntegratedSecurityConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file.
return @"Data Source=.;Integrated Security=True;" +
"Initial Catalog=AdventureWorks";
}
private static string GetSqlConnectionString()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file.
return @"Data Source=.;User Id=<myUserID>;Password=<myPassword>;" +
"Initial Catalog=AdventureWorks";
}
private static string GetSqlConnectionStringDifferent()
{
// To avoid storing the connection string in your code,
// you can retrieve it from a configuration file.
return @"Initial Catalog=AdventureWorks;Data Source=.;" +
"User Id=<myUserID>;Password=<myPassword>;";
}
}
}