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