Microsoft NET
Microsoft .NET Framework metrics come packaged with the CloudWisdom Windows Agent. Our Windows agent is a Microsoft Windows service that collects, aggregates, and publishes windows performance counters and attributes.
Configure
There’s no additional configuration necessary for the Microsoft .NET Framework if you’ve already installed the Windows agent unless you want to add additional custom metrics to supplement the default collected metrics.
Add Custom Metrics
Open the Add Counters window
Open perfmon (Performance Monitor) on your computer.
Click Performance Monitor in the Monitoring Tools folder. A graph generates.
Click Add above the graph. An Add Counters window opens. Leave the window open.
Prepare a New Counter
Navigate to the ReadWindowsPerfCounters file (typically located in
C:\Program Files\CollectdWin\config
) and open it.Optionally, at the top of the file but below the
<Counters>
tag, place a comment to section off your new custom category of counters.<!-- CustomCategoryName -->
Add a blank Counter tag template:
<Counter Category="" Name="" Instance="" CollectdPlugin="" CollectdType="" CollectdTypeInstance="" />
Fill In Counter Information
Follow the diagram below to fill out the Category, Name, and Instance fields (case sensitive) in the blank counter template you added in step 2.3. The picture outlines the expanded Processor counter category.
Tip
Not all categories have instances available. In the above example, the instances correlate to the processor’s cores, where
_Total
would calculate the metric selected for all four cores.Navigate to the types.db file (typically located in
C:\Program Files\CollectdWin)
and open it.Use your best judgment to match a type in
types.db
to the category you selected in step 3.1. Input the type (case sensitive) you wish to use into the CollectdType field.Create a metric category for the CollectdPlugin field. This category displays in the Metrics tree and search field.
Create a metric name using the CollectdTypeInstance field. This field is used as the metric’s name in CloudWisdom, but be sure to make it entirely unique.
Save the
ReadWindowsPerfCounters
file.
Example Counters
A Web Service Tracking Total Instances of Current Connections:
<Counter
Category="Web Service"
Name="Current Connections"
Instance="_Total"
CollectdPlugin="custom_iis"
CollectdType="current_connections"
CollectdTypeInstance="curr_connections"
/>
Three Process Counters Checking Status of different aspects of the Windows agent service:
<Counter
Category="Process"
Name="% Processor Time"
Instance="^CollectdWinService$"
CollectdPlugin="processes"
CollectdPluginInstance=""
CollectdType="percent"
CollectdTypeInstance="collectdwin.percent_processor_time"
/>
<Counter
Category="Process"
Name="Thread Count"
Instance="^CollectdWinService$"
CollectdPlugin="processes"
CollectdPluginInstance=""
CollectdType="count"
CollectdTypeInstance="collectdwin.thread_count"
/>
<Counter
Category="Process"
Name="Private Bytes"
Instance="^CollectdWinService$"
CollectdPlugin="processes"
CollectdPluginInstance=""
CollectdType="bytes"
CollectdTypeInstance="collectdwin.private_bytes"
/>