# 使用VPCEP方式接入APM（OpenTelemetry）
#### 适用局点
使用VPCEP方式接入适用局点包括：华北-北京四、西南-贵阳一。
#### 租户侧配置
1. 登录VPCEP控制台，创建终端节点。具体操作请参考[购买连接"接口"型终端节点服务的终端节点](https://support.huaweicloud.com/usermanual-vpcep/zh-cn_topic_0131645189.html#section2)。
   
   1. 在"服务类别"选择"云服务"。
   
   2. 在"选择服务"中输入apm-master，搜索到结果后勾选该服务。
   
   3. 根据需要选择是否创建内网域名，不创建的话后续也可通过终端节点ip访问终端服务。
   
   
   
   4. 根据需要进行选择实例类型，此处选择"基础型"。
   
   5. "网络类型"选择"IPv4"，填入可用的vpc及子网网段。
   
   
   
   
2. 创建完毕等待终端链接到终端服务，状态为"已接受"说明链接成功。若服务侧开了链接审批，则需要在服务侧账号下把该链接审批接受链接即可。 
   图1链接成功   
   ![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002770070973.png "点击放大")
   图2链接审批   
   ![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002740551650.png "点击放大")
   
   
3. 获取终端节点的ip或域名备用。 
   图3获取终端节点信息   
   ![](https://support.huaweicloud.com/usermanual-apm2/zh-cn_image_0000002740391770.png "点击放大")
   
   
 
#### 通过VPCEP方式接入OpenTelemetry探针
以ECS虚机场景vpcep接入探针为例。
1. 创建节点。在创建终端节点的vpc下创建一个ecs机器并登录。具体操作请参见[快速购买ECS](https://support.huaweicloud.com/usermanual-ecs/ecs_03_7012.html)。
   ![](https://support.huaweicloud.com/usermanual-apm2/public_sys-resources/note_3.0-zh-cn.png)
   节点出方向端口，需要开放4317端口。
   
2. 登录[APM控制台](https://console.huaweicloud.com/apm2/)。
3. 在左侧导航栏中选择"应用监控 \> 应用列表"。
4. 进入"接入应用"页面。
   - 首次接入应用时，单击"点击接入应用"，进入"接入应用"页面。
   
   - 已有探针接入时，在页面右上角，单击"接入应用"，进入"接入应用"页面。
    
5. 选择"区域"和"应用"。若未有应用，可单击"创建应用"，弹出"创建应用"弹窗，具体操作请参见[创建应用](https://support.huaweicloud.com/usermanual-apm2/apm_07_0050.html#apm_07_0050__section1684713176449)。
6. "接入方式"选择OpenTelemetry。
7. "服务端语言"选择Java。
8. 下载OpenTelemetry Java Agent。 前往[Agent下载地址](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases)，下载后将Agent文件放在Java进程有访问权限的目录。
   
9. 添加探针启动参数并重启应用。具体参数信息可参见[表1](https://support.huaweicloud.com/usermanual-apm2/apm_08_0023.html#apm_08_0023__table6501411105116)。
   ```
   java -javaagent:探针安装路径  \
     -Dotel.exporter.otlp.protocol=grpc  \
     -Dotel.exporter.otlp.traces.endpoint=上报地址 \
     -Dotel.exporter.otlp.headers=Authentication=鉴权信息  \
     -Dotel.service.name=应用名称.组件名称.环境名称  \  
     -Dotel.metrics.exporter=none  \
     -Dotel.logs.exporter=none  \
     -jar <用户应用>.jar  &
   ```
   ![](https://support.huaweicloud.com/usermanual-apm2/public_sys-resources/note_3.0-zh-cn.png)
   Dotel.exporter.otlp.traces.endpoint的值为http://终端节点ip:4317。