如何安装JaegerAgent-可观测链路 OpenTelemetry 版(OpenTelemetry)-阿里云帮助中心

可观测链路 OpenTelemetry 版支持使用OpenTelemetry、Jaeger、Zipkin和Skywalking客户端将应用链路数据上报至控制台。如果你需要通过Jaeger Agent上报数据请先安装Jaeger Agent。

步骤一：获取接入点信息

新版控制台

登录可观测链路 OpenTelemetry 版控制台，在左侧导航栏单击接入中心。
在开源框架区域单击Jaeger卡片。
在弹出的Jaeger面板中选择数据需要上报的地域。

说明
初次接入的地域将会自动进行资源初始化。
选择连接方式和上报方式，然后复制接入点信息。
- 连接方式：若您的服务部署在阿里云上，且所属地域与选择的接入地域一致，推荐使用阿里云内网方式，否则选择公网方式。
- 上报方式：根据客户端支持的协议类型选择gRPC协议上报数据。
gRPC Agent 方式的接入点命令格式为 ./jaeger-agent --reporter.grpc.host-port=<接入点地址>:1883 --agent.tags=Authentication=<Token>，其中接入点地址根据所选地域和连接方式自动生成。若 Jaeger Agent 版本为 1.15 及以上，需将 --agent.tags 参数替换为对应新版参数。

旧版控制台

登录可观测链路 OpenTelemetry 版控制台。
在左侧导航栏单击集群配置，然后在右侧页面单击接入点信息页签。
在页面顶部选择需要接入的地域，然后在集群信息区域打开显示Token开关。
在客户端采集工具区域单击Jaeger。

在相关信息列中，获取接入点信息。单击 Jaeger 后，页面以表格形式展示当前地域（如华东2（上海））的接入点信息，数据上报方式为直接上报。相关信息列包含：通过HTTP上报数据的公网接入点URL和阿里云VPC网络接入点URL；通过Agent上报数据的公网接入点命令（示例：./jaeger-agent --reporter.grpc.host-port=tracing-analysis-dc-sh.aliyuncs.com:1883 --agent.tags=Authentication=<Token>）和VPC网络接入点命令。请复制对应接入点地址用于客户端配置。注意：Jaeger Agent 1.15版本以下请将 --agent.tags 替换为 --jaeger.tags。

说明
如果应用部署于阿里云生产环境，则选择阿里云VPC网络接入点，否则选择公网接入点。

步骤二：下载并启动Jaeger Agent

ECS环境

若您使用ECS，则可以通过如下方式启动Jaeger Agent。

下载Jaeger Agent安装包并完成解压。
说明
建议使用最新Jaeger Agent版本。
使用以下命令行启动Jaeger Agent。
```
nohup ./jaeger-agent --reporter.grpc.host-port=<endpoint> --agent.tags=<token>
```
说明
- 对于Jaeger Agent v1.15.0及以下版本，请将启动命令中--agent.tags替换为--jaeger.tags。
- <endpoint>为步骤一中相应客户端和相应地域的接入点。
- <token>为步骤一中获取的接入点信息。

Docker环境

若您使用Docker部署，则建议使用容器方式启动Jaeger Agent，以减少您的运维成本。启动命令如下：

docker run -d\
  --rm \
  -p5775:5775/udp \
  -p6831:6831/udp \
  -p6832:6832/udp \
  -p5778:5778/tcp \
  jaegertracing/jaeger-agent:<version> \
  --reporter.grpc.host-port=<endpoint> \
  --agent.tags=<token>

说明

在上述启动命令中：

对于Jaeger Agent v1.15.0及以下版本，请将启动命令中--agent.tags替换为--jaeger.tags。
<version>为Jaeger Agent版本，例如1.23。其他可用版本，请参见Docker Hub。
<endpoint>为步骤一中相应客户端和相应地域的接入点。
<token>为步骤一中获取的接入点信息。