ADO.NET でのパフォーマンスカウンター

.NET Framework では、Microsoft.Data.SqlClient は、Windowsパフォーマンスカウンターを公開して、アプリケーションとその接続リソースを監視できるようにします。 Microsoft.Data.SqlClient NuGet package をインストールし、この記事の SQL の例では Microsoft.Data.SqlClient 名前空間を使用します。 Windows パフォーマンスモニターまたはPerformanceCounterを使用してこれらのカウンターを読み取る

モダンな.NETでは、Microsoft.Data.SqlClient は、Windows パフォーマンスカウンターではなく EventCounters を公開します。詳細については、「 SqlClient のイベントカウンター」を参照してください。

利用可能なパフォーマンスカウンター

.NET Framework では、次の 14 個のパフォーマンスカウンターをMicrosoft.Data.SqlClientおよびSystem.Data.OracleClientで使用できます。個々のカウンターの名前は、Microsoft .NET Framework の地域別バージョン全体でローカライズされているわけではないことに注意してください。

パフォーマンスカウンター	説明
`HardConnectsPerSecond`	データベースサーバーに対する 1 秒あたりの接続数。
`HardDisconnectsPerSecond`	データベースサーバーに対する 1 秒あたりの切断数。
`NumberOfActiveConnectionPoolGroups`	アクティブな一意の接続プールグループの数。このカウンターは、AppDomain に見つかった一意の接続文字列数によって制御されます。
`NumberOfActiveConnectionPools`	接続プールの合計数。
`NumberOfActiveConnections`	現在使用中のアクティブな接続の数。注: このパフォーマンスカウンターは、既定では無効にされています。このパフォーマンスカウンターを有効にするには、「既定ではオフになっているカウンターのアクティブ化」を参照してください。
`NumberOfFreeConnections`	接続プール内の利用可能な接続数。注: このパフォーマンスカウンターは、既定では無効にされています。このパフォーマンスカウンターを有効にするには、「既定ではオフになっているカウンターのアクティブ化」を参照してください。
`NumberOfInactiveConnectionPoolGroups`	排除対象としてマークされた一意の接続プールグループの数。このカウンターは、AppDomain に見つかった一意の接続文字列数によって制御されます。
`NumberOfInactiveConnectionPools`	最近のアクティビティが存在せず、破棄待ち状態となっている、アクティブでない接続プールの数。
`NumberOfNonPooledConnections`	プールされていないアクティブな接続の数。
`NumberOfPooledConnections`	接続プールインフラストラクチャによって管理されているアクティブな接続の数。
`NumberOfReclaimedConnections`	アプリケーションが `Close` または `Dispose` を呼び出さなかった場合に、ガベージコレクションによって回収された接続の数。接続を明示的に閉じるか破棄しないと、パフォーマンスが低下します。
`NumberOfStasisConnections`	現在アクションの完了を待っている (そのためにアプリケーションからは使用できない) 接続の数。
`SoftConnectsPerSecond`	接続プールから取得されているアクティブな接続の数。注: このパフォーマンスカウンターは、既定では無効にされています。このパフォーマンスカウンターを有効にするには、「既定ではオフになっているカウンターのアクティブ化」を参照してください。
`SoftDisconnectsPerSecond`	接続プールに戻されているアクティブな接続の数。注: このパフォーマンスカウンターは、既定では無効にされています。このパフォーマンスカウンターを有効にするには、「既定ではオフになっているカウンターのアクティブ化」を参照してください。

接続プールグループと接続プール

Windows 認証 (統合セキュリティ) を使用している場合、NumberOfActiveConnectionPoolGroups と NumberOfActiveConnectionPools の両方のパフォーマンスカウンターを監視する必要があります。なぜなら、接続プールグループはユニークな接続文字列に対応付けられるためです。統合セキュリティを使用した場合、接続文字列にマップされた接続プールの他に、個々の Windows ID 用に別々のプールが作成されます。たとえば、同じ AppDomain に属する Fred と Julie が、どちらも "Data Source=MySqlServer;Integrated Security=true" という接続文字列を使用した場合、その接続文字列に対応した接続プールグループが作成され、それに加えて、2 つのプール (Fred 用と Julie 用) が作成されます。 John と Martha が同一の SQL Server ログインで接続文字列を使用 "Data Source=MySqlServer;User Id=lowPrivUser;Password=[PLACEHOLDER]"場合は、 lowPrivUser ID に対して 1 つのプールのみが作成されます。

重要

Microsoft では、使用可能な最も安全な認証フローを使用することをお勧めします。 Azure SQL に接続する場合は、Azure リソースの管理 ID が推奨される認証方法です。

既定ではオフになっているカウンターのアクティブ化

NumberOfFreeConnections、NumberOfActiveConnections、SoftDisconnectsPerSecond、SoftConnectsPerSecond の各パフォーマンスカウンターは、既定ではオフになっています。有効にするには、アプリケーションの構成ファイルに次の情報を追加します。

<system.diagnostics>
  <switches>
    <add name="ConnectionPoolPerformanceCounterDetail"
         value="4"/>
  </switches>
</system.diagnostics>

パフォーマンスカウンターの値の取得

次のコンソールアプリケーションは、アプリケーションでパフォーマンスカウンターの値を取得する方法を示しています。すべての ADO.NET パフォーマンスカウンターの情報を取得できるように、接続を開いてアクティブにする必要があります。

注

この例では、SQL Server に含まれるサンプル AdventureWorks データベースを使用します。サンプルコードの接続文字列は、データベースがローカルコンピューターにインストールされていること、SqlExpress というインスタンス名で実行されていること、接続文字列に指定された情報と一致する SQL Server ログインが作成済みであることを想定しています。既定のセキュリティ設定を使用するようにサーバーが構成されている場合、そのままでは Windows 認証しか許可されないため、SQL Server ログインを有効にする必要があります。接続文字列は環境に合わせて変更してください。

例

Option Explicit On
Option Strict On

Imports Microsoft.Data.SqlClient
Imports System.Diagnostics
Imports System.Runtime.InteropServices

Class Program

    Private PerfCounters(9) As PerformanceCounter
    Private connection As SqlConnection = New SqlConnection

    Public Shared Sub Main()
        Dim prog As Program = 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()
    End Sub

    Private Sub CreateConnections()
        ' List the Performance counters.
        WritePerformanceCounters()

        ' Create 4 connections and display counter information.
        Dim connection1 As SqlConnection = New SqlConnection( _
           GetIntegratedSecurityConnectionString)
        connection1.Open()
        Console.WriteLine("Opened the 1st Connection:")
        WritePerformanceCounters()

        Dim connection2 As SqlConnection = New SqlConnection( _
           GetSqlConnectionStringDifferent)
        connection2.Open()
        Console.WriteLine("Opened the 2nd Connection:")
        WritePerformanceCounters()

        Console.WriteLine("Opened the 3rd Connection:")
        Dim connection3 As SqlConnection = New SqlConnection( _
           GetSqlConnectionString)
        connection3.Open()
        WritePerformanceCounters()

        Dim connection4 As SqlConnection = 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()
    End Sub

    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
    End Enum

    Private Sub SetUpPerformanceCounters()
        connection.Close()
        Me.PerfCounters(9) = New PerformanceCounter()

        Dim instanceName As String = GetInstanceName()
        Dim apc As Type = GetType(ADO_Net_Performance_Counters)
        Dim i As Integer = 0
        Dim s As String = ""
        For Each s In [Enum].GetNames(apc)
            Me.PerfCounters(i) = New PerformanceCounter()
            Me.PerfCounters(i).CategoryName = ".NET Data Provider for SqlServer"
            Me.PerfCounters(i).CounterName = s
            Me.PerfCounters(i).InstanceName = instanceName
            i = (i + 1)
        Next
    End Sub

    Private Declare Function GetCurrentProcessId Lib "kernel32.dll" () As Integer

    Private Function GetInstanceName() As String
        'This works for Winforms apps.
        Dim instanceName As String = _
           System.Reflection.Assembly.GetEntryAssembly.GetName.Name

        ' Must replace special characters like (, ), #, /, \\
        Dim instanceName2 As String = _
           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("\\", "_")

        Dim pid As String = GetCurrentProcessId.ToString
        instanceName = (instanceName + ("[" & (pid & "]")))
        Console.WriteLine("Instance Name: {0}", instanceName)
        Console.WriteLine("---------------------------")
        Return instanceName
    End Function

    Private Sub WritePerformanceCounters()
        Console.WriteLine("---------------------------")
        For Each p As PerformanceCounter In Me.PerfCounters
            Console.WriteLine("{0} = {1}", p.CounterName, p.NextValue)
        Next
        Console.WriteLine("---------------------------")
    End Sub
End Class

using System;
using Microsoft.Data.SqlClient;
using System.Diagnostics;
using System.Runtime.InteropServices;

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("---------------------------");
    }
}

ADO.NET でのパフォーマンス カウンター

利用可能なパフォーマンス カウンター

接続プール グループと接続プール

既定ではオフになっているカウンターのアクティブ化

パフォーマンス カウンターの値の取得

例

関連項目

その他のリソース

ADO.NET でのパフォーマンスカウンター

利用可能なパフォーマンスカウンター

接続プールグループと接続プール

パフォーマンスカウンターの値の取得