PerformanceCounter

[C#] PerformanceCounterでカウンターを作成する方法

2025-01-18更新日: 2025-01-18

C#でPerformanceCounterを使用してカウンターを作成するには、まずSystem.Diagnostics名前空間をインポートします。

次に、PerformanceCounterCategoryクラスを使用して新しいカウンターカテゴリを作成します。

カテゴリが存在しない場合はCreateメソッドを使用して作成します。

次に、PerformanceCounterクラスのインスタンスを生成し、CategoryName、CounterName、InstanceNameを設定します。

カウンターの種類はPerformanceCounterTypeで指定します。

カウンターをインクリメントするにはIncrementメソッドを使用し、値を取得するにはNextValueメソッドを使用します。

これにより、アプリケーションのパフォーマンスを監視するためのカスタムカウンターを作成できます。

目次から探す

カウンターの作成手順
カウンターの操作
カウンターの削除と管理
完成したプログラム
- プログラムの説明
応用例
まとめ

カウンターの作成手順

カウンターカテゴリの作成

C#のPerformanceCounterを使用するには、まずカウンターのカテゴリを作成する必要があります。

NugetからSystem.Diagnostics.PerformanceCounterを検索してインストールしておく必要があります。

コンソールからの場合は、dotnet add package System.Diagnostics.PerformanceCounterでインストールできます。

カテゴリは、カウンターをグループ化するためのもので、特定のアプリケーションやサービスに関連するカウンターをまとめることができます。

以下のコードは、カウンターカテゴリを作成する方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターカテゴリの名前
        string categoryName = "MyCategory";
        
        // カウンターの説明
        string counterName = "MyCounter";
        
        // カウンターの説明
        string counterHelp = "This is my custom counter.";
        // カウンターカテゴリが存在しない場合に作成
        if (!PerformanceCounterCategory.Exists(categoryName))
        {
            // カウンターカテゴリの作成
            CounterCreationDataCollection counterDataCollection = new CounterCreationDataCollection();
            CounterCreationData counterData = new CounterCreationData
            {
                CounterName = counterName,
                CounterHelp = counterHelp,
                CounterType = PerformanceCounterType.NumberOfItems32
            };
            counterDataCollection.Add(counterData);
            
            // カテゴリの作成
            PerformanceCounterCategory.Create(categoryName, "My custom performance counter category.", PerformanceCounterCategoryType.SingleInstance, counterDataCollection);
        }
    }
}

PerformanceCounterCategory.Createメソッドの呼び出しは管理者権限を持った状態で実行しないと例外が発生します。

このコードを実行すると、MyCategoryという名前のカウンターカテゴリが作成され、その中にMyCounterというカウンターが追加されます。

カウンターのインスタンス化

カウンターカテゴリが作成されたら、次にカウンターのインスタンスを作成します。

これにより、カウンターの値を操作できるようになります。

以下のコードは、カウンターのインスタンスを作成する方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        // カウンターのインスタンスを作成
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターの初期値を設定
        myCounter.RawValue = 0;
    }
}

このコードを実行すると、MyCounterのインスタンスが作成され、初期値が0に設定されます。

カウンターのプロパティ設定

カウンターのインスタンスを作成した後は、必要に応じてカウンターのプロパティを設定します。

これにより、カウンターの動作をカスタマイズできます。

以下のコードは、カウンターのプロパティを設定する方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターのプロパティ設定
        myCounter.RawValue = 0; // 初期値を設定
        myCounter.CounterName = "UpdatedCounter"; // カウンター名を更新
    }
}

このコードを実行すると、MyCounterの名前がUpdatedCounterに変更され、初期値は0に設定されます。

これにより、カウンターの動作を柔軟に調整できます。

カウンターの操作

カウンターの初期化

カウンターを使用する前に、初期化を行う必要があります。

初期化では、カウンターの値を設定し、必要に応じてリセットを行います。

以下のコードは、カウンターの初期化方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターの初期化
        myCounter.RawValue = 0; // 初期値を0に設定
    }
}

このコードを実行すると、MyCounterの値が0に初期化されます。

これにより、カウンターを正しく使用する準備が整います。

カウンターのインクリメントとデクリメント

カウンターの値を操作するためには、インクリメントやデクリメントを行います。

これにより、カウンターの値を増減させることができます。

以下のコードは、カウンターのインクリメントとデクリメントの方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターの初期化
        myCounter.RawValue = 0; // 初期値を0に設定
        
        // カウンターのインクリメント
        myCounter.Increment(); // 値を1増加
        
        // カウンターのデクリメント
        myCounter.Decrement(); // 値を1減少
    }
}

このコードを実行すると、MyCounterの値が1増加し、その後1減少します。

最終的な値は0になります。

カウンターの値の取得

カウンターの値を取得することで、現在の状態を確認できます。

以下のコードは、カウンターの値を取得する方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターの初期化
        myCounter.RawValue = 0; // 初期値を0に設定
        
        // カウンターのインクリメント
        myCounter.Increment(); // 値を1増加
        
        // カウンターの値を取得
        float currentValue = myCounter.NextValue(); // 現在の値を取得
        
        // 値を表示
        System.Console.WriteLine($"Current Counter Value: {currentValue}");
    }
}

このコードを実行すると、MyCounterの現在の値が表示されます。

NextValue()メソッドを使用することで、カウンターの最新の値を取得できます。

カウンターの削除と管理

カウンターの削除方法

カウンターを使用しなくなった場合、不要なカウンターを削除することができます。

これにより、システムのリソースを節約できます。

以下のコードは、カウンターを削除する方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターカテゴリの名前
        string categoryName = "MyCategory";
        
        // カウンターカテゴリが存在する場合に削除
        if (PerformanceCounterCategory.Exists(categoryName))
        {
            PerformanceCounterCategory.Delete(categoryName); // カウンターカテゴリを削除
        }
    }
}

このコードを実行すると、MyCategoryという名前のカウンターカテゴリが削除され、その中のすべてのカウンターも同時に削除されます。

カウンターのリセット

カウンターの値をリセットすることで、再度カウントを開始することができます。

リセットは、カウンターの状態を初期化するために便利です。

以下のコードは、カウンターのリセット方法を示しています。

using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターの初期化
        myCounter.RawValue = 0; // 初期値を0に設定
        
        // カウンターのインクリメント
        myCounter.Increment(); // 値を1増加
        
        // カウンターのリセット
        myCounter.RawValue = 0; // 値を0にリセット
        
        // リセット後の値を表示
        System.Console.WriteLine($"Counter Value after Reset: {myCounter.RawValue}");
    }
}

このコードを実行すると、MyCounterの値がリセットされ、0になります。

リセット後の値も表示されます。

カウンターの管理とメンテナンス

カウンターを適切に管理し、定期的にメンテナンスを行うことは、パフォーマンスの最適化に重要です。

以下は、カウンターの管理とメンテナンスに関するポイントです。

管理項目	説明
定期的な削除	不要なカウンターを定期的に削除すること。
値のリセット	使用後はカウンターの値をリセットすること。
カウンターの監視	カウンターの値を監視し、異常を検知すること。

これらの管理項目を実施することで、カウンターのパフォーマンスを維持し、システムの健全性を保つことができます。

完成したプログラム

以下に、これまでの内容を統合した完成したプログラムを示します。

このプログラムは、カウンターカテゴリの作成、カウンターのインスタンス化、カウンターの操作(初期化、インクリメント、デクリメント、値の取得)、カウンターの削除、リセット、管理を行います。

using System;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターカテゴリの名前
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        // カウンターカテゴリが存在しない場合に作成
        if (!PerformanceCounterCategory.Exists(categoryName))
        {
            CounterCreationDataCollection counterDataCollection = new CounterCreationDataCollection();
            CounterCreationData counterData = new CounterCreationData
            {
                CounterName = counterName,
                CounterHelp = "This is my custom counter.",
                CounterType = PerformanceCounterType.NumberOfItems32
            };
            counterDataCollection.Add(counterData);
            
            PerformanceCounterCategory.Create(categoryName, "My custom performance counter category.", PerformanceCounterCategoryType.SingleInstance, counterDataCollection);
        }
        // カウンターのインスタンス化
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カウンターの初期化
        myCounter.RawValue = 0; // 初期値を0に設定
        
        // カウンターのインクリメント
        myCounter.Increment(); // 値を1増加
        
        // カウンターの値を取得
        float currentValue = myCounter.NextValue(); // 現在の値を取得
        Console.WriteLine($"Current Counter Value after Increment: {currentValue}");
        
        // カウンターのデクリメント
        myCounter.Decrement(); // 値を1減少
        
        // カウンターの値を再取得
        currentValue = myCounter.NextValue(); // 現在の値を取得
        Console.WriteLine($"Current Counter Value after Decrement: {currentValue}");
        
        // カウンターのリセット
        myCounter.RawValue = 0; // 値を0にリセット
        Console.WriteLine($"Counter Value after Reset: {myCounter.RawValue}");
        
        // カウンターカテゴリの削除
        if (PerformanceCounterCategory.Exists(categoryName))
        {
            PerformanceCounterCategory.Delete(categoryName); // カウンターカテゴリを削除
            Console.WriteLine($"Counter Category '{categoryName}' has been deleted.");
        }
    }
}

プログラムの説明

カウンターカテゴリの作成: MyCategoryという名前のカウンターカテゴリを作成します。
カウンターのインスタンス化: MyCounterというカウンターのインスタンスを作成します。
カウンターの初期化: カウンターの値を0に設定します。
カウンターのインクリメント: カウンターの値を1増加させます。
カウンターの値の取得: 現在のカウンターの値を取得し、表示します。
カウンターのデクリメント: カウンターの値を1減少させます。
カウンターのリセット: カウンターの値を0にリセットします。
カウンターカテゴリの削除: 使用が終わったカウンターカテゴリを削除します。

このプログラムを実行することで、カウンターの基本的な操作を体験することができます。

応用例

複数インスタンスの管理

複数のカウンターインスタンスを管理することで、異なるプロセスやスレッドのパフォーマンスを個別に監視できます。

以下のコードは、複数のカウンターインスタンスを作成し、それぞれの値を管理する方法を示しています。

using System;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カウンターカテゴリの名前
        string categoryName = "MyMultiInstanceCategory";
        
        // カウンターカテゴリが存在しない場合に作成
        if (!PerformanceCounterCategory.Exists(categoryName))
        {
            CounterCreationDataCollection counterDataCollection = new CounterCreationDataCollection();
            
            // 複数のカウンターインスタンスを作成
            for (int i = 1; i <= 3; i++)
            {
                string counterName = $"InstanceCounter{i}";
                CounterCreationData counterData = new CounterCreationData
                {
                    CounterName = counterName,
                    CounterHelp = $"This is counter for instance {i}.",
                    CounterType = PerformanceCounterType.NumberOfItems32
                };
                counterDataCollection.Add(counterData);
            }
            
            PerformanceCounterCategory.Create(categoryName, "Category for multiple instances.", PerformanceCounterCategoryType.MultiInstance, counterDataCollection);
        }
        // 各インスタンスのカウンターを管理
        for (int i = 1; i <= 3; i++)
        {
            PerformanceCounter instanceCounter = new PerformanceCounter(categoryName, $"InstanceCounter{i}", false);
            instanceCounter.Increment(); // 値を1増加
            Console.WriteLine($"Counter Value for InstanceCounter{i}: {instanceCounter.NextValue()}");
        }
    }
}

このコードを実行すると、MyMultiInstanceCategoryというカテゴリ内に3つのカウンターインスタンスが作成され、それぞれの値が表示されます。

カスタムカウンターの作成

カスタムカウンターを作成することで、特定のアプリケーションやサービスに特化したパフォーマンス指標を監視できます。

以下のコードは、カスタムカウンターを作成する方法を示しています。

using System;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // カスタムカウンターのカテゴリ名
        string categoryName = "MyCustomCategory";
        string counterName = "CustomCounter";
        
        // カスタムカウンターの作成
        if (!PerformanceCounterCategory.Exists(categoryName))
        {
            CounterCreationDataCollection counterDataCollection = new CounterCreationDataCollection();
            CounterCreationData counterData = new CounterCreationData
            {
                CounterName = counterName,
                CounterHelp = "This is a custom performance counter.",
                CounterType = PerformanceCounterType.NumberOfItems32
            };
            counterDataCollection.Add(counterData);
            
            PerformanceCounterCategory.Create(categoryName, "Custom performance counter category.", PerformanceCounterCategoryType.SingleInstance, counterDataCollection);
        }
        // カスタムカウンターのインスタンス化
        PerformanceCounter customCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // カスタムカウンターの値を操作
        customCounter.Increment(); // 値を1増加
        Console.WriteLine($"Custom Counter Value: {customCounter.NextValue()}");
    }
}

このコードを実行すると、MyCustomCategoryというカスタムカウンターが作成され、値が1増加した後に表示されます。

リアルタイムモニタリングの実装

リアルタイムでカウンターの値を監視することで、アプリケーションのパフォーマンスを即座に把握できます。

以下のコードは、カウンターの値を定期的に取得し、リアルタイムで表示する方法を示しています。

using System;
using System.Diagnostics;
using System.Threading;
class Program
{
    static void Main(string[] args)
    {
        // カウンターのインスタンス化
        string categoryName = "MyCategory";
        string counterName = "MyCounter";
        
        PerformanceCounter myCounter = new PerformanceCounter(categoryName, counterName, false);
        
        // リアルタイムモニタリング
        Console.WriteLine("リアルタイムモニタリングを開始します。");
        for (int i = 0; i < 10; i++)
        {
            float currentValue = myCounter.NextValue(); // 現在の値を取得
            Console.WriteLine($"Current Counter Value: {currentValue}");
            Thread.Sleep(1000); // 1秒待機
        }
    }
}

このコードを実行すると、MyCounterの値が1秒ごとに取得され、リアルタイムで表示されます。

これにより、アプリケーションのパフォーマンスを継続的に監視することができます。

まとめ

この記事では、C#のPerformanceCounterを使用してカウンターを作成し、操作する方法について詳しく解説しました。

カウンターの作成手順や操作方法、さらには複数インスタンスの管理やカスタムカウンターの作成、リアルタイムモニタリングの実装など、実践的な応用例も紹介しました。

これらの知識を活用して、アプリケーションのパフォーマンスを効果的に監視し、最適化を図ることができるでしょう。

ぜひ、実際のプロジェクトに取り入れて、パフォーマンス管理を強化してみてください。

2025-01-18更新日: 2025-01-18

カウンターの作成手順

カウンターカテゴリの作成

カウンターのインスタンス化

カウンターのプロパティ設定

カウンターの操作

カウンターの初期化

カウンターのインクリメントとデクリメント

カウンターの値の取得

カウンターの削除と管理

カウンターの削除方法

カウンターのリセット

カウンターの管理とメンテナンス

完成したプログラム

プログラムの説明

応用例

複数インスタンスの管理

カスタムカウンターの作成

リアルタイムモニタリングの実装

まとめ

関連記事

[C#] PerformanceCounterの使い方と活用法

[C#] PerformanceCounterでCPU使用率を取得する方法

[C#] PerformanceCounterを用いたシステム監視の方法

[C#] PerformanceCounterインスタンスの使い方と活用法

[C#] PerformanceCounterのカスタム設定方法

[C#] PerformanceCounterでメモリ使用量を取得する方法

[C#] PerformanceCounterの初期化方法と活用法