更新时间:2026-08-13 GMT+08:00
分享

Python应用接入APM

Python应用接入APM

  1. 登录APM控制台
  2. 在左侧导航栏中选择“应用监控 > 应用列表”。
  3. 进入“接入应用”页面。

    • 首次接入应用时,单击“点击接入应用”,进入“接入应用”页面。
    • 已有探针接入时,在页面右上角,单击“接入应用”,进入“接入应用”页面。

  4. 选择“区域”和“应用”。若未有应用,可单击“创建应用”,弹出“创建应用”弹窗,具体操作请参见创建应用
  5. “接入方式”选择SkyWalking。
  6. “服务端语言”选择Python。
  7. 数据接入。

    1. 下载SkyWalking。通过PyPi安装Python代理模块。

      执行命令如下:

      pip install "apache-skywalking"
      pip install "apache-skywalking[http]"
      pip install "apache-skywalking[kafka]"
      pip install apache-skywalking==0.7.0

      通过pip成功安装SkyWalking Python代理后,会在您的环境中安装一个命令行脚本。命令如下:

      sw-python
    2. 接入Agent。接入Agent需要配置接入点、令牌(Token)、应用名称三个参数,在您的启动文件中配置如下参数:
      from skywalking import agent, config
                config.init(
                collector_address='**.**.**.**:****',
                authentication='Zv***qe',
                service_name='apply name',
                )
                agent.start()
      
      表1 参数说明

      参数

      说明

      是否必填

      应用名称

      应用显示的名称。一个应用代表一个逻辑单元,是一个全局概念,各个region都可以看到相同的应用信息,比如一个租户下面比较独立的功能模块可以定义为一个应用。

      必填

      组件名称

      组件名称,代表一个组件,需要使用英文字符开头。同一个应用下,组件名称不能重复。一个组件可以包含多个环境。不能重复,如果要重复,使用instanceName区分。

      必填

      环境名称

      环境名称,代表一个应用在一个地方的部署。一个应用程序根据配置不同可以部署多个环境,比如测试环境,现网环境。每个环境都在一个region部署,具有唯一的region属性。该参数可以为空,代表默认环境。

      选填

      环境标签

      环境标签,主要用于环境过滤,多个环境打上相同的环境标签,在web页面上可以通过标签将这些环境过滤出来。该参数可以为空。

      选填

      应用英文名称

      应用英文名称,为全局概念。如果填写,则必须提前创建该应用。如果为空,则代表默认应用(开通APM时系统会自动创建一个默认应用)。

      选填

      子应用

      子应用,为全局概念,在应用下面子文件夹。该参数可以为空,为空代表资源挂载在根应用下面,子应用最多支持三层。比如 a/b/c,a、b、c各代表一层。

      选填

      用户应用

      用户所属的应用名称。

      必填

    3. 重启应用。目前,sw-pythonCLI提供了一个run选项,您可以试用该选项来执行您的应用程序。

      如果您之前运行gunicorn应用程序的命令是:

      gunicorn app.wsgi

      请将其改为:

      sw-python run gunicorn app.wsgi

      SkyWalking Python代理将很快与您的应用程序一起启动。

相关文档