您可以通过以下两种方式安装配置Python插件(查看兼容性):
在云端页面中安装配置Python插件,相关说明请参考“在云端页面安装管理插件”。
在主机端通过命令安装配置Python插件,下面主要介绍这种方式的安装配置方法。
安装Python插件
要监控Python应用,您需要安装Python插件。首先请切换至Smart Agent安装目录的bin目录,然后执行./plugin.sh -install Python -P [Port]命令安装插件,例如:
./plugin.sh -install Python -P 1001
-P参数用于指定端口,对于本来没有端口的插件,指定端口可以标识插件的唯一性。同一插件可以通过指定不同的端口安装多个,当然您也可以不指定端口,安装时直接执行./plugin.sh -install Python命令即可。
需要说明的是:
安装Python插件时,默认会使用系统内的Python进行安装。如果Python环境是通过编译安装的,需要将PythonAgent.sh脚本中PythonCommand的值(默认值为python)设置为Python的安装路径。设置的值可以是python命令,如果环境变量中没有python命令,则需要设置具体的python命令脚本,例如“ /usr/local/python2.7/bin/python”。
配置Python插件
安装Python插件后,您可以通过以下两种方式配置插件:
逐个配置
执行./plugin.sh -config Python -P [Port]命令,通过配置引导逐步配置插件,例如:
./plugin.sh -config Python -P 1001
安装插件时未指定端口时,直接执行./plugin.sh -config Python命令即可。
按照配置引导的提示,确认配置项后输入对应的序号,查看当前配置项的值并输入新的值。配置完成后,输入对应序号保存配置并退出配置引导。
批量配置
您还可以在执行./plugin.sh -config Python -P [Port]命令时,通过指定参数名称和参数值直接配置插件的多个配置项,例如:
./plugin.sh -config Python -P 1001 -utlbf 180 -uftlb 2000
安装插件时未指定端口时,直接执行./plugin.sh -config Python命令并配置参数即可。
其中:
“-utlb”用于配置:UserTimeLimitBar
“-utlbf”用于配置:UserTimeLimitBarFrequency
“-uftlb”用于配置:UserFunctionTimeLimitBar>
“-p”用于配置:PythonCommand,即Python install bin path
配置项说明
安装Python插件后,您可以在Python插件conf目录的app.conf文件中查看可配置项,主要配置项及相关说明见下表:
配置项 | 说明 |
UserTimeLimitBarFrequency | 用于设置慢请求的记录频率,单位为秒(s)。例如设置为60,则在60s内,对于同一个请求,只记录一次慢请求。 |
UserFunctionTimeLimitBar | 用于设置需要采集的方法的执行时间阈值,单位为微秒(μs)。例如设置为1000,则执行时间大于1000微秒(即大于1ms)的方法才会被采集。 |
UserTimeLimitBar | 用于设置慢请求的阈值,单位为毫秒(ms)。例如设置为500,则响应时间大于500ms的请求为慢请求。 |
Python install bin path | 用于配置Python的安装路径。安装Python插件时,默认会使用系统内的Python进行安装,此时不需要修改该配置项。 如果Python环境是通过编译安装的,需要通过该配置项设置Python的安装路径即将PythonAgent.sh脚本中PythonCommand的值(默认值为python)设置为Python的安装路径。设置的值可以是python命令,如果环境变量中没有python命令,则需要设置具体的python命令脚本,例如“ /usr/local/python2.7/bin/python”。 |
启动Python插件
注意:启动Python插件时需要root权限。
安装配置插件后,执行./plugin.sh -start Python -P [Port]命令启动插件,例如:
./plugin.sh -start Python -P 1001
安装插件时未指定端口时,直接执行./plugin.sh -start Python命令即可。
启动插件后,为保证配置生效并避免出错,您需要重启以下服务: apache、httpd、Python Server、nginx 注:启动、停止、重启、更新插件后都需要重启这些服务。 |
启动成功后,稍等几分钟您可以在“应用”模块的应用列表中查看数据。但请注意,从来没被访问过的应用不会显示在应用列表中。