README

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

状态

不完整，只有一个传输方式，没有集成。这个库只包含了一个向zipkin发送span的非常简化的实现。

入门

推荐通过 Composer 安装PHP-Zipkin。

composer require blackhades/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集成（简单）

更新ENV

ZIPKIN_ENDPOINT_URL=https://:9411/api/v2/span

ZIPKIN_APP_NAME=zipkin-app

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

<?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/{}

许可

分支自

• drefined/php-zipkin

贡献者

• David Phruksukarn