[toc]

关键字

• Span
• SpanId
• SpanContext
• TraceId
• Tags
• from_of
• child_of

开始

什么是分布式跟踪?

分布式跟踪(也称分布式请求跟踪)是一种用于应用程序进行概要分析和监视的方法.尤其是使用微服务架构构建的应用程序.分布式跟踪有助于查明哪里发生故障以及什么原因导致性能下降.

谁在使用分布式跟踪?

IT和DevOps团队可以使用分布式跟踪应用程序.分布式跟踪特别适合调试和监视现代分布式软件体系. 如微服务.
可以帮助开发人员调试和优化代码.

什么是OpenTracing?

OpenTracing由Api规范,规范框架和文档组成.不用关心特定的供应商.

组成

• Trace
• Span
• SpanContext

结构图:

graph TD;   
    subgraph service1
     A[span1]-- span4 child of span3 --> A1[span3]
     A1 --> A2[span4]
     A1 --> A3[span5]
     A --> B[span2]
    end

    subgraph Network
     C((Trace-Context))
     B -.-> C
    end

    subgraph service3
     C -.-> D[span]
     D --> D1[span]
     D1--> D2[span]
     D --> E[span]
    end

trace

一次完整的跟踪,由多个span组成.
trace主要由,trace-id和span组成.

span

span 是分布式跟踪的主要构成模块,代表分布式的一个工作单元.
分布式系统的每个组件都有一个命名的span.比如”request”,”db”
span 可以包含其它span的引用,从而组成一个完整生命周期跟踪图.如上.
通常一个span的内容规范.

• name,记录点的名称,用于分类
• time,记录的开始时间戳和结束时间戳
• tags,标记. key:value组成
• logs,记录, key:value组成
• spanContext, 上下文

name

由字符串组成成的标识,可以用于过滤和标识.

time

时间,由开始时间和结束时间

tag

标签,可以存放多个.
用于过滤.包含一些常用的规范标签.
行业约定

如:

log

日志,用于调试和信息记录.
日志的准备字段,参考上面的约定链接.

SpanContext

span的描述,上下文信息,
必须的trace-id,span-id,span-kind

Trace-Context

传播上下文,通过Http传播给其他平台.
W3C Trace-Context规范

现在各种平台规范不一样.Jaeger使用的是.
Jaeger标记

Key:uber-trace-id不区分大小写,使用

Value :
值由几部份组成.
{trace-id}:{span-id}:{parent-span-id}:{flags}

• trace-id : 64位或128位 的 随机 base16 数
• span-id: 64位或128位 的 随机 base16 数
• parent-span-id: 0,代表根级
• flags: 标记,2个字节.
  • 第1位,1:采样,0:不采样
  • 第2位,调试标记

使用

下面结合 php的opentracing 和 jaeger,几个经典分布式追踪场景的使用和查询.

• Http
• DB
• MQ
• Cache
• Task
• Thread
• RPC
• 前端App

有很多优先的支持opentrcing平台,如zipkin,阿里云等.
我这里使用 Jaeger.
基于docker的部署环境,数据存储使用es.

环境要求:

• docker
• jaeger,服务端
• jaeger-agent,客户端
• jaeger存储,使用ES
• php-opentracing 包

演示的php框架,使用的是hpyerf 和 laravel

安装部署Jaeger

todo:持续更新中…