DST 埋点上报

分布式链路跟踪 DST 的服务端目前已不提供服务,使用实时监控 RMS 的分布式链路服务代替。埋点上报依然使用 SOFATracer 里的 DST 上报插件。

操作步骤

  1. 引入依赖。

    您需要在工程中引入 SOFATracer 依赖:

    <dependency>
         <groupId>com.alipay.sofa</groupId>
         <artifactId>tracer-enterprise-sofa-boot-starter</artifactId>
     </dependency>

  2. 添加配置。

    在工程的 application.properties 文件下添加一个 SOFATracer 需要使用的参数:

    com.alipay.sofa.tracer.remote=dst
    com.alipay.sofa.tracer.dst.acvip=false   
    com.alipay.sofa.tracer.dst.url=http://<monitor-gateway-lb>/zipkin/api/v1/spans
    说明

    目前 RMS 已脱离金融云的中间件体系,所以不会去 ACVIP 上注册。您需要配置 com.alipay.sofa.tracer.dst.acvip=false,并配置 com.alipay.sofa.tracer.dst.url,使用 SLB 寻址。

  3. 埋点上报。

    您可以通过以下代码触发 SOFARPC REST 埋点上报:

    @Path("/sofarest")
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    @Produces(MediaType.APPLICATION_JSON + ";charset=UTF-8")
    public interface SampleRestFacade {
        /**
         * http://localhost:8341/sofarest/hello
         */
        @GET
        @Path("/hello")
        String hello();
    }
  4. 启动应用。

    您可以在本地浏览器访问 http://localhost:8341/sofarest/hello

  5. 查看服务端展示。

    您可以通过 RMS 的链路查询功能查询上报链路。详情请参见 链路查询

配置说明

您还可以在 application.properties 文件中根据需求配置以下参数:

参数

说明

com.alipay.sofa.tracer.remote

配置上报的类型。取值:dst、zipkin。

您可以同时配置多个类型,以英文逗号(,)分隔。

com.alipay.sofa.tracer.dst.acvip

寻址是否使用 ACVIP,建议配置为 false。

com.alipay.sofa.tracer.dst.url

配置目的 URL,使用 SLB 寻址。

com.alipay.sofa.tracer.dst.queueSize

配置队列缓存数。默认值:65536。

com.alipay.sofa.tracer.dst.batchSize

配置单次上传数量。默认值:255。

com.alipay.sofa.tracer.dst.concurrency

配置上传并发数。默认值:10。

com.alipay.sofa.tracer.dst.timeout

配置超时时间,超过指定时间的上报会失败。

com.alipay.sofa.tracer.dst.retry

配置上传失败的重试次数。默认值:1。