README

用于Stackdriver Trace的PHP语言的惯用客户端。

• API 文档

注意： 此存储库是Google Cloud PHP的一部分。任何支持请求、错误报告或开发贡献应指向该项目。

Google Cloud Platform的一个分布式跟踪系统，它从App Engine应用程序收集延迟数据，并在Google Cloud Platform控制台中实时显示。

安装

首先，安装PHP的首选依赖管理器 Composer。

现在安装此组件

$ composer require google/cloud-trace

此组件支持HTTP/1.1上的REST和gRPC。为了利用gRPC提供的优势（如流方法），请参阅我们的gRPC安装指南。

身份验证

请参阅我们的身份验证指南以获取有关验证客户端的更多信息。身份验证后，您即可开始发送请求。

示例

require 'vendor/autoload.php';

use Google\Cloud\Trace\TraceClient;

$traceClient = new TraceClient();

// Create a Trace
$trace = $traceClient->trace();
$span = $trace->span([
    'name' => 'main'
]);
$span->setStartTime();
// some expensive operation
$span->setEndTime();

$trace->setSpans([$span]);
$traceClient->insert($trace);

// List recent Traces
foreach($traceClient->traces() as $trace) {
    var_dump($trace->traceId());
}

创建跟踪

use Google\Cloud\Trace\TraceClient;

$client = new TraceClient();
$trace = $client->trace();
$span = $trace->span(['name' => 'main']);
$trace->setSpans([$span]);

$client->insert($trace);

使用OpenCensus

我们强烈建议使用OpenCensus项目来为您的应用程序添加代码。OpenCensus是一个开源的分布式跟踪框架，它维护与流行的框架和工具的集成。OpenCensus为Stackdriver Trace提供了数据导出器，该导出器使用此库。如果您使用的是google/cloud-trace <= v0.3.3或google/cloud <= 0.46.0，请查看迁移指南到OpenCensus。

使用composer安装或将其添加到您的composer.json中。

$ composer require opencensus/opencensus opencensus/opencensus-exporter-stackdriver

opencensus/opencensus提供了一种与服务无关的实现。请确保还需要opencensus/opencensus-exporter-stackdriver以启用将跟踪导出到Stackdriver Trace。

use OpenCensus\Trace\Exporter\StackdriverExporter;
use OpenCensus\Trace\Tracer;

Tracer::start(new StackdriverExporter());

有关更多配置选项和功能，请参阅OpenCensus文档。

版本

此组件被视为GA（一般可用）。因此，它不会在任何次要或修补程序版本中引入不兼容的更改。我们将优先解决问题和请求。

下一步

1. 了解官方文档。
2. 查看深入使用示例。