andreybrigunet/sentry-tracing

Maintainers

Details

github.com/AndreyBrigunet/sentry-tracing

Homepage

Source

Installs: 3

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 1

1.4.3 2023-04-25 16:37 UTC

Requires

MIT 0cc9e5f03a416bfb8de3b8022099008fec40ef0b

  • Jen Wachter <jwachter.woop@jhu.edu>

This package is auto-updated.

Last update: 2024-04-25 18:54:07 UTC

README

A wrapper library for implementing custom instrumentation of Sentry performance monitoring.

Installation

composer require andreybrigunet/sentry-tracing

Basic usage

<?php

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

// create and start a transaction
$transaction = new SentryTracing\Transaction('transaction name', 'operation.name');

// record a span
$span = new SentryTracing\Span('operation.name');
// do some stuff...
$span->end();

// record another span
$span = new SentryTracing\Span('operation.name');
// do some more stuff...
$span->end();


// end the transaction and send to sentry
$transaction->end();

Using the SENTRY_TRACE constant

To easily enable or disable tracing, define the SENTRY_TRACE before creating any transactions or spans. If the constant is not defined, it will default to true. The advantage of using this constant is that if at any point, you wish to turn off tracing, you can toggle the constant instead of removing all references to transactions and spans within your code base.

// enable tracing
const SENTRY_TRACE = true;

Connecting services

For traces that begin in the backend, connect the front end pageload transaction using meta tags.

<html>
  <head>
    <meta name="sentry-trace" content="<?= $span->getTraceId() ?>" />
    <meta name="baggage" content="<?= $span->getBaggage() ?>" />
    <!-- ... -->
  </head>
</html>

The span referenced should be the one that generates the HTML.