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

使用VPCEP方式接入APM(OpenTelemetry)

适用局点

使用VPCEP方式接入适用局点包括:华北-北京四、西南-贵阳一。

租户侧配置

  1. 登录VPCEP控制台,创建终端节点。具体操作请参考购买连接“接口”型终端节点服务的终端节点。

    1. 在“服务类别”选择“云服务”。
    2. 在“选择服务”中输入apm-master,搜索到结果后勾选该服务。
    3. 根据需要选择是否创建内网域名,不创建的话后续也可通过终端节点ip访问终端服务。
    1. 根据需要进行选择实例类型,此处选择“基础型”。
    2. “网络类型”选择“IPv4”,填入可用的vpc及子网网段。

  2. 创建完毕等待终端链接到终端服务,状态为“已接受”说明链接成功。若服务侧开了链接审批,则需要在服务侧账号下把该链接审批接受链接即可。

    图1 链接成功
    图2 链接审批

  3. 获取终端节点的ip或域名备用。

    图3 获取终端节点信息

通过VPCEP方式接入OpenTelemetry探针

以ECS虚机场景vpcep接入探针为例。
  1. 创建节点。在创建终端节点的vpc下创建一个ecs机器并登录。具体操作请参见快速购买ECS。

    节点出方向端口,需要开放4317端口。

  2. 登录APM控制台。
  3. 在左侧导航栏中选择“应用监控 > 应用列表”。
  4. 进入“接入应用”页面。
    • 首次接入应用时,单击“点击接入应用”,进入“接入应用”页面。
    • 已有探针接入时,在页面右上角,单击“接入应用”,进入“接入应用”页面。
  5. 选择“区域”和“应用”。若未有应用,可单击“创建应用”,弹出“创建应用”弹窗,具体操作请参见创建应用。
  6. “接入方式”选择OpenTelemetry。
  7. “服务端语言”选择Java。
  8. 下载OpenTelemetry Java Agent。

    前往Agent下载地址,下载后将Agent文件放在Java进程有访问权限的目录。

  9. 添加探针启动参数并重启应用。具体参数信息可参见表1。
    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  &

    Dotel.exporter.otlp.traces.endpoint的值为http://终端节点ip:4317。

相关文档