Stackdriver Trace V2 Client - Class TraceServiceClient (1.5.3)

$traceServiceClient = new TraceServiceClient();
try {
    $formattedName = $traceServiceClient->projectName('[PROJECT]');
    $spans = [];
    $traceServiceClient->batchWriteSpans($formattedName, $spans);
} finally {
    $traceServiceClient->close();
}

Methods

projectName

spanName

parseName

__construct

batchWriteSpans

use Google\ApiCore\ApiException;
use Google\Cloud\Trace\V2\Span;
use Google\Cloud\Trace\V2\TraceServiceClient;
use Google\Cloud\Trace\V2\TruncatableString;
use Google\Protobuf\Timestamp;

/**
 * @param string $formattedName The name of the project where the spans belong. The format is
 *                              `projects/[PROJECT_ID]`. Please see
 *                              {@see TraceServiceClient::projectName()} for help formatting this field.
 * @param string $spansName     The resource name of the span in the following format:
 *
 *                              * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
 *
 *                              `[TRACE_ID]` is a unique identifier for a trace within a project;
 *                              it is a 32-character hexadecimal encoding of a 16-byte array. It should
 *                              not be zero.
 *
 *                              `[SPAN_ID]` is a unique identifier for a span within a trace; it
 *                              is a 16-character hexadecimal encoding of an 8-byte array. It should not
 *                              be zero.
 *                              .
 * @param string $spansSpanId   The `[SPAN_ID]` portion of the span's resource name.
 */
function batch_write_spans_sample(
    string $formattedName,
    string $spansName,
    string $spansSpanId
): void {
    // Create a client.
    $traceServiceClient = new TraceServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $spansDisplayName = new TruncatableString();
    $spansStartTime = new Timestamp();
    $spansEndTime = new Timestamp();
    $span = (new Span())
        ->setName($spansName)
        ->setSpanId($spansSpanId)
        ->setDisplayName($spansDisplayName)
        ->setStartTime($spansStartTime)
        ->setEndTime($spansEndTime);
    $spans = [$span,];

    // Call the API and handle any network failures.
    try {
        $traceServiceClient->batchWriteSpans($formattedName, $spans);
        printf('Call completed successfully.' . PHP_EOL);
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedName = TraceServiceClient::projectName('[PROJECT]');
    $spansName = '[NAME]';
    $spansSpanId = '[SPAN_ID]';

    batch_write_spans_sample($formattedName, $spansName, $spansSpanId);
}

createSpan

use Google\ApiCore\ApiException;
use Google\Cloud\Trace\V2\Span;
use Google\Cloud\Trace\V2\TraceServiceClient;
use Google\Cloud\Trace\V2\TruncatableString;
use Google\Protobuf\Timestamp;

/**
 * @param string $name   The resource name of the span in the following format:
 *
 *                       * `projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]`
 *
 *                       `[TRACE_ID]` is a unique identifier for a trace within a project;
 *                       it is a 32-character hexadecimal encoding of a 16-byte array. It should
 *                       not be zero.
 *
 *                       `[SPAN_ID]` is a unique identifier for a span within a trace; it
 *                       is a 16-character hexadecimal encoding of an 8-byte array. It should not
 *                       be zero.
 *                       .
 * @param string $spanId The `[SPAN_ID]` portion of the span's resource name.
 */
function create_span_sample(string $name, string $spanId): void
{
    // Create a client.
    $traceServiceClient = new TraceServiceClient();

    // Prepare any non-scalar elements to be passed along with the request.
    $displayName = new TruncatableString();
    $startTime = new Timestamp();
    $endTime = new Timestamp();

    // Call the API and handle any network failures.
    try {
        /** @var Span $response */
        $response = $traceServiceClient->createSpan($name, $spanId, $displayName, $startTime, $endTime);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * This sample has been automatically generated and should be regarded as a code
 * template only. It will require modifications to work:
 *  - It may require correct/in-range values for request initialization.
 *  - It may require specifying regional endpoints when creating the service client,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $name = '[NAME]';
    $spanId = '[SPAN_ID]';

    create_span_sample($name, $spanId);
}

Constants

SERVICE_NAME

Value: 'google.devtools.cloudtrace.v2.TraceService'

SERVICE_ADDRESS

Value: 'cloudtrace.googleapis.com'

DEFAULT_SERVICE_PORT

Value: 443

CODEGEN_NAME

Value: 'gapic'