使用PHP进行分布式追踪：Zipkin与Jaeger集成

讲座主题：PHP分布式追踪的魔法之旅 —— Zipkin与Jaeger集成

开场白

嘿，大家好！欢迎来到今天的“PHP分布式追踪”讲座。如果你曾经在调试分布式系统时感到头疼，那今天的内容绝对会让你眼前一亮！我们将一起探索如何通过Zipkin和Jaeger为你的PHP应用添加分布式追踪功能，让你像侦探一样轻松找到问题的根源。

别担心，我会用轻松诙谐的语言和通俗易懂的例子带你入门，还会附上一些代码片段和表格帮助你理解。准备好了吗？让我们开始吧！

第一部分：为什么需要分布式追踪？

假设你正在开发一个电商网站，用户下单后会经过以下步骤：

用户访问前端页面。
前端调用后端API获取商品信息。
后端API查询数据库并调用支付服务完成订单。
支付服务返回结果给后端API，再由前端展示给用户。

如果某个环节出了问题（比如支付服务超时），你会怎么排查？手动检查每个服务的日志？太麻烦了吧！这就是分布式追踪的作用所在——它能帮你记录整个请求链路，快速定位问题。

第二部分：认识Zipkin和Jaeger

1. Zipkin

Zipkin是由Twitter开源的一个分布式追踪系统。它的核心思想是通过Span（跨度）和Trace（追踪）来记录请求的路径。简单来说：

Trace 是一次完整的请求旅程。
Span 是Trace中的一个步骤，比如“查询数据库”或“调用支付服务”。

2. Jaeger

Jaeger是Uber开源的另一个分布式追踪工具，功能更强大且支持更多的后端存储选项。它和Zipkin类似，但提供了更丰富的UI和分析能力。

第三部分：PHP集成Zipkin与Jaeger

1. 安装依赖

首先，我们需要安装一些必要的PHP库。以下是两个常用的库：

openzipkin/zipkin-php：用于Zipkin集成。
jaeger-client-php：用于Jaeger集成。

可以通过Composer安装：

composer require openzipkin/zipkin-php
composer require ubermensch/jaeger-client-php

2. 配置Zipkin客户端

下面是一个简单的Zipkin配置示例：

use OpenZipkinZipkin;
use OpenZipkinReporterCurlHttpReporter;
use OpenZipkinTracer;

// 配置Zipkin Reporter
$reporter = new CurlHttpReporter([
    'endpoint' => 'http://localhost:9411/api/v2/spans',
]);

// 创建Tracer
$tracer = new Tracer([
    'serviceName' => 'my-php-service',
    'reporter' => $reporter,
]);

// 获取当前Span
$span = $tracer->newTrace();
$span->setName('process-order');
$span->annotate('Start processing order');
$span->finish();

echo "Trace sent to Zipkin!";

3. 配置Jaeger客户端

接下来是Jaeger的配置示例：

use UbermenschJaegerClient;

// 初始化Jaeger Client
$client = new Client([
    'service_name' => 'my-php-service',
    'sampler_type' => 'const', // 恒定采样
    'sampler_param' => 1,      // 1表示100%采样
    'agent_host' => 'localhost',
    'agent_port' => 6831,
]);

// 创建Span
$scope = $client->startActiveSpan('process-order');
$scope->span()->log(['event' => 'Start processing order']);
$scope->close();

echo "Trace sent to Jaeger!";

第四部分：实战演练——构建一个简单的分布式系统

假设我们有一个简单的PHP微服务架构，包含两个服务：

Order Service：处理订单逻辑。
Payment Service：处理支付逻辑。

1. Order Service代码

require 'vendor/autoload.php';

use OpenZipkinZipkin;
use OpenZipkinReporterCurlHttpReporter;
use OpenZipkinTracer;

$reporter = new CurlHttpReporter([
    'endpoint' => 'http://localhost:9411/api/v2/spans',
]);

$tracer = new Tracer([
    'serviceName' => 'order-service',
    'reporter' => $reporter,
]);

$span = $tracer->newTrace();
$span->setName('create-order');

// 调用Payment Service
$paymentSpan = $tracer->newChild($span->getContext());
$paymentSpan->setName('call-payment-service');
file_get_contents('http://localhost:8081/pay'); // 模拟调用
$paymentSpan->finish();

$span->annotate('Order created successfully');
$span->finish();

echo "Order processed!";

2. Payment Service代码

require 'vendor/autoload.php';

use UbermenschJaegerClient;

$client = new Client([
    'service_name' => 'payment-service',
    'sampler_type' => 'const',
    'sampler_param' => 1,
    'agent_host' => 'localhost',
    'agent_port' => 6831,
]);

$scope = $client->startActiveSpan('process-payment');
$scope->span()->log(['event' => 'Payment processed']);
$scope->close();

echo "Payment completed!";

第五部分：对比Zipkin与Jaeger

特性	Zipkin	Jaeger
开发者	Twitter	Uber
存储支持	内置MySQL、Cassandra等	更多选择（Elasticsearch等）
UI功能	简单直观	功能丰富，支持高级分析
采样策略	简单恒定采样	多种采样策略

第六部分：总结与展望

通过今天的讲座，我们学会了如何使用Zipkin和Jaeger为PHP应用添加分布式追踪功能。虽然Zipkin更简单易用，但Jaeger的功能更强大，适合复杂的生产环境。

最后送给大家一句话：“没有追踪，就没有真相！” 希望你能用这些工具更好地理解和优化你的分布式系统。

谢谢大家！如果有任何问题，欢迎提问！