详解 Apache SkyWalking 跨进程传播协议

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

简介

SkyWalking 跨进程传播协议是用于上下文的传播，本文介绍的版本是 3.0 ，也被称为为 sw8 协议。

Header项

Header应该是上下文传播的最低要求。

Header名称： sw8 .
Header值：由 - 分隔的8个字段组成。Header值的长度应该小于2KB。

Header值

Header值中具体包含以下8个字段：

采样（Sample），0 或 1，0 表示上下文存在, 但是可以（也很可能）被忽略；1 表示这个追踪需要采样并发送到后端。
追踪ID（Trace Id），是 BASE64 编码的字符串，其内容是由 . 分割的三个 long 类型值, 表示此追踪的唯一标识。
父追踪片段ID（Parent trace segment Id），是 BASE64 编码的字符串，其内容是字符串且全局唯一。
父跨度ID（Parent span Id），是一个从 0 开始的整数，这个跨度ID指向父追踪片段（segment）中的父跨度（span）。
父服务名称（Parent service），是 BASE64 编码的字符串，其内容是一个长度小于或等于50个UTF-8编码的字符串。
父服务实例标识（Parent service instance），是 BASE64 编码的字符串，其内容是一个长度小于或等于50个UTF-8编码的字符串。
父服务的端点（Parent endpoint），是 BASE64 编码的字符串，其内容是父追踪片段（segment）中第一个入口跨度（span）的操作名，由长度小于或等于50个UTF-8编码的字符组成。
本请求的目标地址（Peer），是 BASE64 编码的字符串，其内容是客户端用于访问目标服务的网络地址（不一定是 IP + 端口）。

Header值示例

上面的说明太干了，我们来举一个具体的例子，可以更好的理解。

有两个服务，分别叫 onemore-a 和 onemore-b ，用户通过HTTP调用 onemore-a 的 /onemore-a/get ，然后 onemore-a 的 /onemore-a/get 又通过HTTP调用 onemore-b 的 /onemore-b/get ，流程图就是这样的：

那么，我们在 onemore-b 的 /onemore-b/get 的Header中就可以发现一个叫做 sw8 的key，其值为：

1-YTRlYzZmYzhjY2FiNGJiNGI2ODIwNjQ2OThjYzk3ZTYuNzQuMTYyMTgzODExMDQ1NTAwMDk=-YTRlYzZmYzhjY2FiNGJiNGI2ODIwNjQ2OThjYzk3ZTYuNzQuMTYyMTgzODExMDQ1NTAwMDg=-2-b25lbW9yZS1h-ZTFkMmZiYjYzYmJhNDMwNDk5YWY4OTVjMDQwZTMyZmVAMTkyLjE2OC4xLjEwMQ==-L29uZW1vcmUtYS9nZXQ=-MTkyLjE2OC4xLjEwMjo4MA==

文章持续更新，微信搜索「 万猫学社 」第一时间阅读，关注后回复「 电子书 」，免费获取12本Java必读技术书籍。

以 - 字符进行分割，可以得到：

1，采样，表示这个追踪需要采样并发送到后端。
YTRlYzZmYzhjY2FiNGJiNGI2ODIwNjQ2OThjYzk3ZTYuNzQuMTYyMTgzODExMDQ1NTAwMDk=，追踪ID，解码后为：a4ec6fc8ccab4bb4b682064698cc97e6.74.16218381104550009
YTRlYzZmYzhjY2FiNGJiNGI2ODIwNjQ2OThjYzk3ZTYuNzQuMTYyMTgzODExMDQ1NTAwMDg=，父追踪片段ID，解码后为：a4ec6fc8ccab4bb4b682064698cc97e6.74.16218381104550009
2，父跨度ID。
b25lbW9yZS1h，父服务名称，解码后为：onemore-a
ZTFkMmZiYjYzYmJhNDMwNDk5YWY4OTVjMDQwZTMyZmVAMTkyLjE2OC4xLjEwMQ==，父服务实例标识，解码后为：e1d2fbb63bba430499af895c040e32fe@192.168.1.101
L29uZW1vcmUtYS9nZXQ=，父服务的端点，解码后为：/onemore-a/get
MTkyLjE2OC4xLjEwMjo4MA==，本请求的目标地址，解码后为：192.168.1.102:80