PerformanceCounterType Enumeration
Specifies the formula used to calculate the NextValue method for a PerformanceCounter instance.
Assembly: System (in System.dll)
Member name | Description | |
---|---|---|
AverageBase | A base counter that is used in the calculation of time or count averages, such as AverageTimer32 and AverageCount64. Stores the denominator for calculating a counter to present "time per operation" or "count per operation". | |
AverageCount64 | An average counter that shows how many items are processed, on average, during an operation. Counters of this type display a ratio of the items processed to the number of operations completed. The ratio is calculated by comparing the number of items processed during the last interval to the number of operations completed during the last interval. | |
AverageTimer32 | An average counter that measures the time it takes, on average, to complete a process or operation. Counters of this type display a ratio of the total elapsed time of the sample interval to the number of processes or operations completed during that time. This counter type measures time in ticks of the system clock. | |
CounterDelta32 | A difference counter that shows the change in the measured attribute between the two most recent sample intervals. | |
CounterDelta64 | A difference counter that shows the change in the measured attribute between the two most recent sample intervals. It is the same as the CounterDelta32 counter type except that is uses larger fields to accomodate larger values. | |
CounterMultiBase | A base counter that indicates the number of items sampled. It is used as the denominator in the calculations to get an average among the items sampled when taking timings of multiple, but similar items. Used with CounterMultiTimer, CounterMultiTimerInverse, CounterMultiTimer100Ns, and CounterMultiTimer100NsInverse. | |
CounterMultiTimer | A percentage counter that displays the active time of one or more components as a percentage of the total time of the sample interval. Because the numerator records the active time of components operating simultaneously, the resulting percentage can exceed 100 percent. | |
CounterMultiTimer100Ns | A percentage counter that shows the active time of one or more components as a percentage of the total time of the sample interval. It measures time in 100 nanosecond (ns) units. | |
CounterMultiTimer100NsInverse | A percentage counter that shows the active time of one or more components as a percentage of the total time of the sample interval. Counters of this type measure time in 100 nanosecond (ns) units. They derive the active time by measuring the time that the components were not active and subtracting the result from multiplying 100 percent by the number of objects monitored. | |
CounterMultiTimerInverse | A percentage counter that shows the active time of one or more components as a percentage of the total time of the sample interval. It derives the active time by measuring the time that the components were not active and subtracting the result from 100 percent by the number of objects monitored. | |
CounterTimer | A percentage counter that shows the average time that a component is active as a percentage of the total sample time. | |
CounterTimerInverse | A percentage counter that displays the average percentage of active time observed during sample interval. The value of these counters is calculated by monitoring the percentage of time that the service was inactive and then subtracting that value from 100 percent. | |
CountPerTimeInterval32 | An average counter designed to monitor the average length of a queue to a resource over time. It shows the difference between the queue lengths observed during the last two sample intervals divided by the duration of the interval. This type of counter is typically used to track the number of items that are queued or waiting. | |
CountPerTimeInterval64 | An average counter that monitors the average length of a queue to a resource over time. Counters of this type display the difference between the queue lengths observed during the last two sample intervals, divided by the duration of the interval. This counter type is the same as CountPerTimeInterval32 except that it uses larger fields to accommodate larger values. This type of counter is typically used to track a high-volume or very large number of items that are queued or waiting. | |
ElapsedTime | A difference timer that shows the total time between when the component or process started and the time when this value is calculated. | |
NumberOfItems32 | An instantaneous counter that shows the most recently observed value. Used, for example, to maintain a simple count of items or operations. | |
NumberOfItems64 | An instantaneous counter that shows the most recently observed value. Used, for example, to maintain a simple count of a very large number of items or operations. It is the same as NumberOfItems32 except that it uses larger fields to accommodate larger values. | |
NumberOfItemsHEX32 | An instantaneous counter that shows the most recently observed value in hexadecimal format. Used, for example, to maintain a simple count of items or operations. | |
NumberOfItemsHEX64 | An instantaneous counter that shows the most recently observed value. Used, for example, to maintain a simple count of a very large number of items or operations. It is the same as NumberOfItemsHEX32 except that it uses larger fields to accommodate larger values. | |
RateOfCountsPerSecond32 | A difference counter that shows the average number of operations completed during each second of the sample interval. Counters of this type measure time in ticks of the system clock. | |
RateOfCountsPerSecond64 | A difference counter that shows the average number of operations completed during each second of the sample interval. Counters of this type measure time in ticks of the system clock. This counter type is the same as the RateOfCountsPerSecond32 type, but it uses larger fields to accommodate larger values to track a high-volume number of items or operations per second, such as a byte-transmission rate. | |
RawBase | A base counter that stores the denominator of a counter that presents a general arithmetic fraction. Check that this value is greater than zero before using it as the denominator in a RawFraction value calculation. | |
RawFraction | An instantaneous percentage counter that shows the ratio of a subset to its set as a percentage. For example, it compares the number of bytes in use on a disk to the total number of bytes on the disk. Counters of this type display the current percentage only, not an average over time. | |
SampleBase | A base counter that stores the number of sampling interrupts taken and is used as a denominator in the sampling fraction. The sampling fraction is the number of samples that were 1 (or true) for a sample interrupt. Check that this value is greater than zero before using it as the denominator in a calculation of SampleFraction. | |
SampleCounter | An average counter that shows the average number of operations completed in one second. When a counter of this type samples the data, each sampling interrupt returns one or zero. The counter data is the number of ones that were sampled. It measures time in units of ticks of the system performance timer. | |
SampleFraction | A percentage counter that shows the average ratio of hits to all operations during the last two sample intervals. | |
Timer100Ns | A percentage counter that shows the active time of a component as a percentage of the total elapsed time of the sample interval. It measures time in units of 100 nanoseconds (ns). Counters of this type are designed to measure the activity of one component at a time. | |
Timer100NsInverse | A percentage counter that shows the average percentage of active time observed during the sample interval. |
Some counter types represent raw data, while others represent calculated values that are based on one or more counter samples. The following categories classify the types of counters available.
Average: measure a value over time and display the average of the last two measurements. Associated with each average counter is a base counter that tracks the number of samples involved.
Difference: subtract the last measurement from the previous one and display the difference, if it is positive; if negative, they display a zero.
Instantaneous: display the most recent measurement.
Percentage: display calculated values as a percentage.
Rate: sample an increasing count of events over time and divide the change in count values by the change in time to display a rate of activity.
When sampling performance counter data, using a counter type that represents an average can make raw data values meaningful for your use. For example, the raw data counter NumberOfItems64 can expose data that is fairly random from sample to sample. The formula for an average calculation of the values that the counter returns would be (X 0 +X 1 +…+X n)/n, where each X i is a raw counter sample.
Rate counters are similar to average counters, but more useful for situations in which the rate increases as a resource is used. A formula that quickly calculates the average is ((X n -X 0)/(T n -T 0)) / frequency, where each X i is a counter sample and each T i is the time that the corresponding sample was taken. The result is the average usage per second.
Note |
---|
Unless otherwise indicated, the time base is seconds. |
When instrumenting applications (creating and writing custom performance counters), you might be working with performance counter types that rely on an accompanying base counter that is used in the calculations. The base counter must be immediately after its associated counter in the CounterCreationDataCollection collection your application uses. The following table lists the base counter types with their corresponding performance counter types.
Base counter type | Performance counter types |
---|---|
AverageBase | AverageTimer32 AverageCount64 |
CounterMultiBase | CounterMultiTimer CounterMultiTimerInverse CounterMultiTimer100Ns CounterMultiTimer100NsInverse |
RawBase | RawFraction |
SampleBase | SampleFraction |
The following examples demonstrate several of the counter types in the PerformanceCounterType enumeration.
AverageCount64
AverageTimer32
ElapsedTime
NumberOfItems32
NumberOfItems64
SampleFraction
RateOfCountsPerSecond32
RateOfCountsPerSecond64
RawFraction
Available since 1.1