lightstep/tracer

此包已被弃用且不再维护。作者建议使用 open-telemetry/opentelemetry 包。

LightStep 仪表化 API

1.1.2 2020-12-10 22:56 UTC

README

此仪表化不再推荐使用。请查阅 OpenTelemetry PHP API 和 SDK 设置与配置文档 了解如何使用 OpenTelemetry 与 PHP。

Latest Stable Version Circle CI MIT license

LightStep PHP 分布式追踪库。

安装

composer require lightstep/tracer

lightstep/tracer 包可在 packagist.org 上找到。

入门

<?php

require __DIR__ . '/vendor/autoload.php';

LightStep::initGlobalTracer('examples/trivial_process', '{your_access_token}');

$span = LightStep::startSpan("trivial/loop");
for ($i = 0; $i < 10; $i++) {
    $span->logEvent("loop_iteration", $i);
    echo "The current unix time is " . time() . "\n";
    usleep(1e5);
    $child = LightStep::startSpan("child_span", array(parent => $span));
    usleep(2e5);
    $child->logEvent("hello world");
    $child->finish();
    usleep(1e5);
}
$span->finish();

查看 lib/api.php 以获取详细的 API 文档。

设置收集器端点和端口

您可以通过在初始化追踪器时设置 collector_hostcollector_port 选项来覆盖默认的端点和端口,以便发送跨度。

例如,当使用全局初始化器时

LightStep::initGlobalTracer('examples/trivial_process', '{your_access_token}', [
    'collector_host' => '<FDQN or IP>',
    'collector_port' => '<port>'
]);

默认情况下,追踪器会通过 TLS 在端口 443 上将跟踪数据安全地发送到公共 LightStep 卫星 collector.lightstep.com

开发者设置

brew install composer
make install
make test