快速接入Agent

前提条件

部署APM Agent时，必须确保接入APM的机器与APM服务网络连通，Agent才能正常工作。可使用“curl -kv”命令测试目标机器与APM服务器网络是否连通。例如，以检查华北-北京四区域，且接入方式为“Skywalking”的连通性为例，请登录应用所部署的机器，并输入命令curl -kv 100.125.2.112:11800，其他区域或源代码的地址请参考探针接入地址。
Python语言支持Skywalking和OpenTelemetry。

操作步骤

登录APM控制台。
单击左侧，选择“管理与监管 > 应用性能管理 APM”，进入APM服务页面。
在左侧导航栏中选择“应用监控 > 应用列表”。
单击“接入应用”，进入接入应用页面。

图1 接入应用
选择“区域”和“应用”。单击“创建应用”，弹出“创建应用”弹窗，可以具体操作参见创建应用。

图2 基础信息
“接入方式”选择Skywalking或者OpenTelemetry。
“服务端语言”选择Python。

图3 接入方式
根据应用类型选择接入对应的接入方式，按照步骤接入。同一个应用下，组件名称不能重复。
- OpenTelemetry
- 使用PuTTY等远程登录工具，登录待安装Agent的Linux操作系统主机，并以root或者service权限执行相关命令执行相关命令。执行安装命令的用户需要和启动应用的用户保持一致。
  1. 下载并安装相关包。
```
pip install opentelemetry-distro
pip install opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install
```
  2. 启动python应用。接入Agent需要配置 token、endpoint、服务名、主机名四个参数，在您的启动文件中配置如下参数：
```
opentelemetry-instrument     
--traces_exporter otlp     
--service_name 应用名称.组件名称.环境名称     
--resource_attributes host.name=host.name     
--exporter_otlp_endpoint http://**.**.**.**:****     
--exporter_otlp_headers Authentication=8e****04x     
python myapp.py
```
- Skywalking
- 下载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
```
- 接入Agent。接入Agent需要配置接入点、令牌（Token）、应用名称三个参数，在您的启动文件中配置如下参数：
```
from skywalking import agent, config
          config.init(
          collector_address='**.**.**.**:****',
          authentication='Zv***qe',
          service_name='apply name',
          )
          agent.start()
```
- 重启应用。目前，sw-pythonCLI提供了一个run选项，您可以试用该选项来执行您的应用程序。
  如果您之前运行gunicorn应用程序的命令是：
```
gunicorn app.wsgi
```
  请将其改为：
```
sw-python run gunicorn app.wsgi
```
  Skywalking Python代理将很快与您的应用程序一起启动。