This reverts commit a869abf951
.
Actually, we need to have both admin guide and configuration
guide because openstack manual will link to these two guides
respectively.
Change-Id: I1dc4ae9b0258afdc14efdce5664ffb0c7984124d
2.9 KiB
Use OSProfiler in Zun
This is the demo for Zun integrating with osprofiler. Zun is an OpenStack container management services, while OSProfiler provides a tiny but powerful library that is used by most OpenStack projects and their python clients.
Install Redis database
After osprofiler 1.4.0, user can choose mongodb or redis as the backend storage option without using ceilometer. Here just use Redis as an example, user can choose mongodb, elasticsearch, and etc. Install Redis as the centralized collector. Redis in container is easy to launch, choose Redis Docker and run:
$ docker run --name some-redis -p 6379:6379 -d redis
Now there is a redis database which has an expose port to access. OSProfiler will send data to this key-value database.
Change the configure file
Change the /etc/zun/zun.conf, add the following lines, change the <ip-address> to the real IP:
[profiler]
enabled = True
trace_sqlalchemy = True
hmac_keys = SECRET_KEY
connection_string = redis://<ip-address>:6379/
Then restart zun-api and zun-compute (Attention, the newest version of Zun has move zun-api service to apache2 server. You can't restart the service just in screen. Use "systemctl restart apache2" will work).
Use below commands to get the trace information:
$ zun --profile SECRET_KEY list
Use <TRACE-ID>, you will get a <TRACE-ID> for trace:
$ osprofiler trace show <TRACE-ID> --connection-string=redis://<ip-address>:6379 --html
Troubleshooting
How to check whether the integration is fine: Stop the Redis container, then run the command:
$ zun --profile SECRET_KEY list
In the zun-api log, will see "ConnectionError: Error 111 connecting to <ip-address>:6379. ECONNREFUSED." That means that osprofiler will write the trace data to redis, but can't connect it. So the integration is fine. When /etc/zun/api-paste.ini file changed (change the pipeline), you need to re-deploy the zun service.