部署
Python探针是根据 WSGI协议而为Web框架定制的性能监测客户端,理论上只要是基于WSGI协议的Web框架都能对其进行监测。
前提条件
请确认当前探针版本支持您目前的应用以及部署方式,详情请参见支持列表。
对于悟空SaaS平台,注册基调听云账户,取得 license-key。
- 设置探针的配置文件。
上述3个条件缺一不可,否则探针无法正常工作。
探针部署
UniAgent部署(仅Linux支持)
当Linux服务器上存在多种语言的应用时,推荐使用UniAgent安装。
安装路径固定为/opt/tingyun-oneagent,安装步骤请参见UniAgent部署说明。
UniAgent安装包内集成了Java/PHP/.NET Core/Node.js/Python 多个语言的探针,安装后不需要手工修改应用的配置文件,所有嵌入探针的动作均由UniAgent自动完成,并且可以自动监控Docker容器内的应用。
UniAgent安装完毕后,如需监控python应用,需手工开启/opt/tingyun-oneagent/conf/interceptor.conf
内python监控开关python_enabled=true
sudo sed -i -e "s/python_enabled.*/python_enabled=true/" /opt/tingyun-oneagent/conf/interceptor.conf
然后重启Python应用即可。
普通探针部署
先安装探针,再配置探针。关于配置项的详细说明可参见探针配置。
安装探针
用户可以到部署管理>下载中心页面中下载所需探针。
假设您得到的安装包为 tingyun-1.1.0.tar.gz,直接进行下述操作即可安装(如使用虚拟环境,请先激活)。如果安装了多个版本的python,请确认应用使用的python路径,将探针安装到指定的python目录下。
tar --zxvf tingyun -1.1.0.tar.gz --C /tmp
/path/to/python /tmp/ tingyun-1.1.0 /setup.py install
配置探针
生成配置文件,请执行以下命令。
tingyun-admin generate-config YourLicenseKey outputFile.ini
设置collectors。
格式为collectors=IP:Port,该IP地址是tingyun-collector所在服务器地址,Port是tingyun-collector中collector.properties中collector.port的值,并将ssl设置成False。
说明:配置文件有很多配置项可提供不同功能,详情请参见探针配置章节。
嵌入探针。
假设配置文件的存放路径为/tmp/tingyun.ini,做如下配置:
TINGYUN_CONFIG_FILE=/tmp/tingyun.ini tingyun-admin run-program 应用的启动命令 应用启动参数
例如:
TINGYUN_CONFIG_FILE=/tmp/tingyun.ini tingyun-admin run-program python manage.py runserver
访问应用。