部署

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

配置探针

1. 生成配置文件，请执行以下命令。

   tingyun-admin generate-config YourLicenseKey outputFile.ini
   

2. 设置collector_addresses。

   格式为collector_addresses=IP:Port，该IP地址是tingyun-collector所在服务器地址，Port是tingyun-collector中collector.properties中collector.port的值，并将ssl设置成False。

   说明：配置文件有很多配置项可提供不同功能，详情请参见探针配置章节。

3. 嵌入探针。

   假设配置文件的存放路径为/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
   

4. 访问应用。