mono-api-counters.html

## Counters

Counters is a Mono API for flexible statistics collection and is used to track different events inside the JIT.

You would typically register an address with the `mono_counters_register` routine and increment the counters from your application as you go. At the end of the program you would call mono_counters_dump which will display all the registered counters.

If you need more complicated counter computation, a function can be provided instead of an address. In that case the `MONO_COUNTER_CALLBACK` flag must be ored in the type request.

The types that can be rendered are:

           MONO_COUNTER_INT
           MONO_COUNTER_UINT
           MONO_COUNTER_WORD
           MONO_COUNTER_LONG
           MONO_COUNTER_ULONG
           MONO_COUNTER_DOUBLE
           MONO_COUNTER_STRING

To organize the output, you register also a section where the counter will be displayed, or one of the following values when you register your counter:

           MONO_COUNTER_JIT
           MONO_COUNTER_GC
           MONO_COUNTER_METADATA
           MONO_COUNTER_GENERICS
           MONO_COUNTER_SECURITY

`mono_counters_dump`
Syntax
void mono_counters_dump (int section_mask, FILE *outfile)

Parameters

section_mask | The sections to dump counters for
outfile | a FILE to dump the results to

Description
Displays the counts of all the enabled counters registered. To filter by variance, you can OR one or more variance with the specific section you want. Use `MONO_COUNTER_SECTION_MASK` to dump all categories of a specific variance.
`mono_counters_enable`
Syntax
void mono_counters_enable (int section_mask)

Parameters

sectionmask | a mask listing the sections that will be displayed

Description
This is used to track which counters will be displayed.