README

这是一个为OpenZipkin提供的非官方PHP库。

状态

不完整，仅有一个传输方式，没有集成。此库仅包含向Zipkin发送跟踪信息的非常简单的实现。

入门指南

推荐通过Composer安装PHP-Zipkin

composer require drefined/php-zipkin

示例用法

<?php
$client   = new \GuzzleHttp\Client();
$logger   = new \Drefined\Zipkin\Transport\HTTPLogger($client);
$tracer   = new \Drefined\Zipkin\Tracer($logger, 1.0, true);
$endpoint = new \Drefined\Zipkin\Core\Endpoint('127.0.0.1', 8080, 'test-trace');
$trace    = new \Drefined\Zipkin\Core\Trace($tracer, $endpoint);

$trace->createNewSpan('test-server-trace');

$trace->record(
    [Annotation::generateServerRecv()],
    [BinaryAnnotation::generateString('server.request.uri', '/server')]
);

$trace->record(
    [Annotation::generateServerSend()],
    [BinaryAnnotation::generateString('server.response', 200)]
);

Laravel集成（简单）

在适当的位置添加中间件和服务提供者。

<?php // laravel-project/app/Http/Kernel.php

namespace App\Http;

use ...
use Drefined\Zipkin\Instrumentation\Laravel\Middleware\EnableZipkinTracing;

class Kernel extends HttpKernel
{
    ...
    protected $middleware = [
        ...
        EnableZipkinTracing::class,
    ];
    ...
}

<?php // laravel-project/config/app.php

use Drefined\Zipkin\Instrumentation\Laravel\Providers\ZipkinTracingServiceProvider;

return [
    ...
    'providers' => [
        ...
        ZipkinTracingServiceProvider::class,
    ],
    ...
];

待办事项

• 添加完整的Laravel集成（目前支持简单实现，不涉及应用环境配置）
• 添加Symfony集成
• 添加Redis封装
• 添加HTTP封装
• 添加PDO封装
• 添加Scribe传输
• 添加Kafka传输

灵感来源

• Tolerance/Tolerance
• Jimdo/hoopak

参考

• 库的监测
• 核心数据结构
• openzipkin/zipkin-api

生成PHP thrift类

• ls thrift/ | xargs -I {} thrift --gen php thrift/{}

许可协议

贡献者

• David Phruksukarn