This monitors a Prosody DSP, recording the amount of its CPU time that is being used for processing. It records this information in considerable detail, allowing you to find both long-term CPU usage as well as very short term effects.
Go to directory $(TiNG)/test.
You must have downloaded the firmware module cpumon.
Run cpumon with the appropriate options (the program is
gen-LINUX_V6/cpumon or
gen-WINNT_V6/cpumon
depending on which operating system you are using).
Command line options are:
-m <module>
| The Prosody module to use. This is the number of the module on the card. |
-x <cardspec>
| Specifies the Prosody card to use see Test programs: Specifying Prosody Processor modules. |
-X <maxrx>
| record this many samples, 0 means run continuously with no limit |
| <file> | name of file into which the CPU usage data is to be recorded. |
For example,
gen-WINNT_V6/cpumon -x x:1.2.3.4/mykey out.32
record CPU usage into out.32.
The data is recorded as a sequence of 32-bit numbers, each of which is one measurement. The numbers are stored least significant byte first. A file in this format can be converted to a text list of decimal numbers with the Prosody diag program int2text. On current ProsodyX hardware, with the current firmware kernel, a measurement value of 10,000 represents the maximum amount of CPU time available. A value larger than these may be recorded, and this indicates that the CPU is falling behind in its processing which will lead to undetected overruns and underruns.
The program closes the file and exits when you give it any input (i.e. when you hit RETURN).
The source code for this program is provided (cpumon.c).
This is one of the Prosody test programs .