• OpenTracing
    • 基本术语
    • 参考

    OpenTracing

    OpenTracing 是 CNCF 提出的分布式追踪的标准，它提供用厂商中立的 API，并提供 Go、Java、JavaScript、Python、Ruby、PHP、Objective-C、C++ 和 C# 这九种语言的库。

    目前支持 Tracer 包括 Zipkin、Skywalking、Jaeger 等，支持的框架包括 gRPC、MOTAN、django、Flask、Sharding-JDBC 等，详见 OpenTracing 官网。

    Jaeger 是遵循 OpenTracing 的一种实现。

    Jaeger UI

    关于 OpenTracing 的详细约定请参考：

    • OpenTracing 语义规范（Semantic Specification）
    • OpenTracing 语义约定（Semantic Conventions）

    基本术语

    如下是 OpenTracing 中定义的基本术语。

    Trace

    Trace 通常指一次完整的调用链。如上文中的 Jaeger UI 截图就是 Istio 官方提供的 Bookinfo 示例 的追踪中对 productpage 的调用链分析。

    Span

    每个 trace 都由一系列 Span 组成，一个 span 可以理解为两个微服务之间的调用，如同 Chrome 检查器中查看网络访问瀑布一样。

    Chrome Inspector

    根据 OpenTracing 的规格约定，每个 Span 都要包含以下状态：

    • 操作名称：可以是访问的一个 URL。必填。例如 localhost:8808/。
    • 起/止时间戳：也可以使用起始时间和持续时间来表示。必填。例如 1540273832696773。
    • Tags：一组键值对集合，Semantic Conventions 有一些常用约定。必填。例如 http.protocol。
    • Logs：一组键值对集合，用于记录调用日志。可选填。
    • SpanContext：在进程间通信时携带的 span 信息，指整个 trace。

    示例

    下面是 Jaeger 收集的来自 Bookinfo 示例 中的 productpage 的调用链追踪数据。

    1. {
    2.     "data": [
    3.         {
    4.             "traceID": "aaccbe962478cf93",
    5.             "spans": [
    6.                 {
    7.                     "traceID": "aaccbe962478cf93",
    8.                     "spanID": "fa36a9cbd60b4ae5",
    9.                     "operationName": "details.default.svc.cluster.local:9080/*",
    10.                     "references": [
    11.                         {
    12.                             "refType": "CHILD_OF",
    13.                             "traceID": "aaccbe962478cf93",
    14.                             "spanID": "2"
    15.                         }
    16.                     ],
    17.                     "startTime": 1540273832696773,
    18.                     "duration": 8171,
    19.                     "tags": [
    20.                         {
    21.                             "key": "component",
    22.                             "type": "string",
    23.                             "value": "proxy"
    24.                         },
    25.                         {
    26.                             "key": "node_id",
    27.                             "type": "string",
    28.                             "value": "sidecar~172.33.5.11~productpage-v1-8584c875d8-4jgwg.default~default.svc.cluster.local"
    29.                         }
    30.                         ...
    31.                     ],
    32.                     "logs": [],
    33.                     "processID": "p1",
    34.                     "warnings": null
    35.                 },
    36.                 ...
    37.             ],
    38.             "processes": {
    39.                 "p1": {
    40.                     "serviceName": "productpage",
    41.                     "tags": [
    42.                         {
    43.                             "key": "ip",
    44.                             "type": "string",
    45.                             "value": "172.33.5.11"
    46.                         }
    47.                     ]
    48.                 },
    49.                 ...
    50.             },
    51.             "warnings": null
    52.         }
    53.     ],
    54.     "total": 0,
    55.     "limit": 0,
    56.     "offset": 0,
    57.     "errors": null
    58. }

    在开发应用时需要使用兼容 OpenTracing API 的 Tracing 实现库，例如 Jaeger 来实现自动的分布式追踪。

    参考

    • OpenTracing 官方网站
    • OpenTracing 语义规范（Semantic Specification）
    • OpenTracing 语义约定（Semantic Conventions）
    • 开放分布式追踪（OpenTracing）入门与 Jaeger 实现