Python 安装配置

对于大多数支持的WSGI服务器和web框架,您可以依照OneAPM快速使用指南中的说明进行使用。如果在使用Heroku,请查看Heroku快速使用指南。

如果快速指南没有覆盖到您的web框架,或者您对安装方式有特别需求,以下的说明会对您有所帮助。

可用的方式

安装OneAPM Python包的标准方式:

从我们的下载网站上手动下载安装包后用提供的setup.py进行安装。

为Python agent能正常运行,您需要做到以下步骤:

  1. 将ONEAPM包安装到Python中。
  2. 创建、编辑Python agent的配置文件。
  3. 测试安装。
  4. 编辑您的应用,加载并且初始化agent。

下载页面

  1. 手动取得安装包,请参照Python agent引导安装页面的最新版本的链接。
  2. 解压zip文件。
  3. 在解压的安装包下顶层文件夹下安装,运行:
python setup.py install

对于Python安装或者您希望安装Python agent到某个虚拟环境,均可运行此命令。

注意:如果在系统范围内进行Python安装,使用sudo命令,或者将命令作为root运行。

创建配置文件

当oneapm Python包已经安装后,会包含一个命名为blueware-admin的管理脚本,和Python执行文件在同一目录下。

1.创建agent的配置文件,使用generate-config命令运行管理脚本,然后提供您的产品授权码,包括一个编写配置文件的目标名称。

blueware-admin generate-config LICENSE-KEY blueware.ini

2.编辑生成的agent配置文件,取消该行的注释,然后设置日志文件到一个您的web应用可以写入的地方。

log_file = /tmp/blueware-python-agent.log

如果您在托管服务上托管您的web应用,您也许需要询问托管服务商来获知编写日志文件的地方,该路径需是绝对路径。

3.最后,修改会向OneAPM 用户界面发送数据的应用名称。当前默认是

app_name = Python Application。

测试agent配置

在您继续之前,请使用包含管理脚本的命令行测试包已经被正确安装,以及确认配置文件的相关参数是正确的。如需进行此测试,请运行:

blueware-admin validate-config blueware.ini
还有其他问题? 提交请求

您还可以采取以下方式解决问题: