Idiomatic PHP client forStackdriver Trace.

NOTE: This repository is part ofGoogle Cloud PHP. Anysupport requests, bug reports, or development contributions should be directed tothat project.

A distributed tracing system for Google Cloud Platform that collects latencydata from App Engine applications and displays it in near real time in theGoogle Cloud Platform Console.

Installation

To begin, install the preferred dependency manager for PHP,Composer.

Now install this component:

$ composer require google/cloud-trace

This component supports both REST over HTTP/1.1 and gRPC. In order to takeadvantage of the benefits offered by gRPC (such as streaming methods)please see ourgRPC installation guide.

Authentication

Please see ourAuthentication guidefor more information on authenticating your client. Once authenticated, you'llbe ready to start making requests.

Sample

use Google\ApiCore\ApiException;use Google\Cloud\Trace\V2\Client\TraceServiceClient;use Google\Cloud\Trace\V2\Span;use Google\Cloud\Trace\V2\TruncatableString;use Google\Protobuf\Timestamp;// Create a client.$traceServiceClient = new TraceServiceClient();// Prepare the request message.$displayName = new TruncatableString();$startTime = new Timestamp();$endTime = new Timestamp();$request = (new Span())    ->setName($name)    ->setSpanId($spanId)    ->setDisplayName($displayName)    ->setStartTime($startTime)    ->setEndTime($endTime);// Call the API and handle any network failures.try {    /** @var Span $response */    $response = $traceServiceClient->createSpan($request);    printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());} catch (ApiException $ex) {    printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());}

See theOpenCensus documentation for more configurationoptions and features.

Debugging

Please see ourDebugging guidefor more information about the debugging tools.

Version

This component is considered GA (generally available). As such, it will not introduce backwards-incompatible changes inany minor or patch releases. We will address issues and requests with the highest priority.

Next Steps

1. Understand theofficial documentation.
2. Take a look atin-depth usage samples.