Unified Communication Use Cases

Profiling Python Programs

Profiling CPU/Time Usage

Here's an example on how to profile wazo-auth for CPU/time usage:

Stop the monit daemon:
```
service monit stop
```
Stop the process you want to profile, i.e. wazo-auth:
```
service wazo-auth stop
```
Start the service in foreground mode running with the profiler:
```
python -m cProfile -o test.profile /usr/bin/xivo-auth -f
```
This will create a file named test.profile when the process terminates.

To profile wazo-confgend, you must use this command instead of the one above:
```
twistd3 -p test.profile --profiler=cprofile --savestats -no --python=/usr/bin/wazo-confgend
```
Note that profiling multi-threaded program (wazo-agid, wazo-confd) doesn't work reliably.

The Debugging Daemons section documents how to launch the various Wazo services in foreground/debug mode.

Examine the result of the profiling:

$ python -m pstats test.profile
Welcome to the profile statistics browser.
% sort time
% stats 15
...
% sort cumulative
% stats 15

Here's an example on how to measure the code coverage of wazo-auth.

This can be useful when you suspect a piece of code to be unused and you want to have additional information about it.

Install the following packages:

apt-get install python-pip build-essential python-dev

Install coverage via pip:
```
pip install coverage
```
Run the program in foreground mode with coverage run:
```
service monit stop
service wazo-auth stop
coverage erase
coverage run /usr/bin/wazo-auth -f
```
The Debugging Daemons section documents how to launch the various Wazo service in foreground/debug mode.
After the process terminates, use coverage html to generate an HTML coverage report:
```
coverage html --include='*wazo_calld*'
```
This will generate an htlmcov directory in the current directory.
Browse the coverage report.

Either copy the directory onto your computer and open it with a web browser, or start a web server on the Wazo:
```
cd htmlcov
python -m SimpleHTTPServer
```
Then open the page from your computer (i.e. not on the Wazo):
```
firefox http://<wazo-hostname>:8000
```