Click here to Skip to main content
13,665,784 members
Click here to Skip to main content
Add your own
alternative version


32 bookmarked
Posted 8 Feb 2006
Licenced CPOL

Using custom attributes to add performance counters to your application

, 8 Feb 2006
Rate this:
Please Sign up or sign in to vote.
A brief overview of what performance counters are and a library that makes their use a bit easier.


A performance counter monitors the behavior of performance objects on a computer. These include physical components, such as processors, disks, and memory, and system objects, such as processes and threads. There are also a large number of performance counters created (and maintained) by the .NET common language run time environment, including % time spent in garbage collection, and total size of managed heaps etc.

The windows preformance monitoring tool

The behaviour of your system can be monitored by running the perfmon.exe utility which has the interface as shown above. You select the performance counters that you are interested in and they are graphed for you.

Creating custom performance counters

The .NET framework includes two classes that you can use to interact with the performance monitor: PerformanceCounterCategory and PerformanceCounter - using these, you can create custom performance counters to monitor aspects of your own application to keep an eye on its performance.

Attribute for performance monitoring

The attached library contains two attribute derived classes, PerformanceCounterCategoryAttribute and PerformanceCounterAttribute, which you can use to decorate your business object classes, and then use the shared functions in the PerformanceCounterUtilities class to create and update these performance counters.

Associating a class with a performance counter category

To associate a class with a particular performance counter category, you decorate that class definition with a PerformanceCounterCategoryAttribute attribute.

<PerformanceCounterCategory("Attribute Test", _
"Test of the performance counter utility library")> _
Public Class PerformanceCounterTestClass
'- - 8< - - - - - - - - - - - - - - - - - - -

Associating a property of a class with a performance counter

To associate a public property of your class with a particular performance counter, you decorate that property definition with a PerformanceCounterAttribute attribute.

'- - 8< - - - - - - - - - - - - - - - - - - - 
<PerformanceCounter("Value List Length", _
"The number of items in the value list", _ 
PerformanceCounterType.NumberOfItems32)> _
Public ReadOnly Property CurrentList() As Collection
'- - 8< - - - - - - - - - - - - - - - - - - -

There are overloaded constructors for the PerformanceCounterAttribute attribute that allow you to specify the type of the performance counter (if none is specifically selected, PerformanceCounterType.NumberOfItems32 is assumed), and for those performance counter types that require an associated base performance counter (for example, a RawFraction counter type requires an associated Rawbase counter type), you can specify the name of the property that supplies the base performance category.

(Re)Creating the performance counters

Before you can assign values to the various performance counters, you need to create them. To do this, you pass an instance of your class (that has the attributes on it) to RebuildPerformanceCounterCategory. This creates a set of CounterCreationData objects and puts them in the right order needed to create the performance counters for that object type.

Private TestClass As New PerformanceCounterTestClass
'\\ Create and register the performance counter categories       

Updating all the performance counters from an instance of a class

To update all the performance counters associated with a class, call the UpdatePerformanceCounter method and pass the class instance in.


Updating a single performance counter from a class and property name

To update a single performance counter associated with a class property, call the UpdatePerformanceCounter method and pass the class instance and the property name in.

PerformanceCounterUtilities.UpdatePerformanceCounter(TestClass, _

Usage scenarios

Custom performance counters are a great way of instrumenting your .NET applications in order to monitor the performance and diagnose any bottlenecks or problems with that application, and in the long term, they can save a great deal of stress and hair loss.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Duncan Edwards Jones
Software Developer (Senior)
Ireland Ireland
C# / SQL Server developer
Microsoft MVP (Azure) 2017
Microsoft MVP (Visual Basic) 2006, 2007

You may also be interested in...


Comments and Discussions

Generaluse for wcf service Pin
Member 336990915-Dec-08 15:52
memberMember 336990915-Dec-08 15:52 
GeneralPerformanceCounterAttribute Pin
shatl4-Sep-06 1:08
membershatl4-Sep-06 1:08 
GeneralRe: PerformanceCounterAttribute Pin
Duncan Edwards Jones4-Sep-06 1:18
memberDuncan Edwards Jones4-Sep-06 1:18 
GeneralExample of usage Pin
DSSI-Ryan15-Mar-06 14:50
memberDSSI-Ryan15-Mar-06 14:50 
GeneralRe: Example of usage Pin
Duncan Edwards Jones20-Mar-06 11:55
memberDuncan Edwards Jones20-Mar-06 11:55 
GeneralRe: Example of usage Pin
DSSI-Ryan20-Mar-06 14:55
memberDSSI-Ryan20-Mar-06 14:55 
GeneralRe: Example of usage Pin
Duncan Edwards Jones20-Mar-06 20:49
memberDuncan Edwards Jones20-Mar-06 20:49 
GeneralRe: Example of usage Pin
astanton19781-Dec-08 2:12
memberastanton19781-Dec-08 2:12 
GeneralNice Job Pin
computerguru9238215-Feb-06 4:42
membercomputerguru9238215-Feb-06 4:42 
GeneralRe: Nice Job Pin
Duncan Edwards Jones15-Feb-06 5:14
memberDuncan Edwards Jones15-Feb-06 5:14 
GeneralRe: Nice Job Pin
computerguru9238215-Feb-06 6:49
membercomputerguru9238215-Feb-06 6:49 
GeneralRe: Nice Job Pin
Henk-Jan Visscher16-Feb-06 0:10
memberHenk-Jan Visscher16-Feb-06 0:10 
GeneralRe: Nice Job Pin
Duncan Edwards Jones16-Feb-06 0:19
memberDuncan Edwards Jones16-Feb-06 0:19 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web06-2016 | 2.8.180810.1 | Last Updated 8 Feb 2006
Article Copyright 2006 by Duncan Edwards Jones
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid