PHP SDK

captureLog

Send a structured log event. Convenience functions are available for each log level.

<?php

use function LogTide\{debug, info, warn, error, critical};

// Log levels: debug, info, warn, error, critical
info('User signed up', ['user_id' => 123, 'plan' => 'pro']);
warn('Rate limit approaching', ['current' => 90, 'max' => 100]);
error('Query timeout', ['query' => 'SELECT ...', 'duration_ms' => 5000]);

// With explicit service name override
info('Payment processed', ['amount' => 99.99], 'payment-service');

captureException

Capture an exception with full stack trace, context, and breadcrumbs.

<?php

use function LogTide\captureException;

try {
    processPayment($orderId);
} catch (\Throwable $e) {
    captureException($e);
}

flush

Flush all pending events. The SDK automatically flushes on shutdown via register_shutdown_function.

<?php

use function LogTide\flush;

// Manually flush pending events
flush();

Global Scope

Configure the global scope to set tags and extras that apply to all events.

<?php

use function LogTide\configureScope;

configureScope(function (\LogTide\State\Scope $scope): void {
    $scope->setTag('region', 'eu-west-1');
    $scope->setExtra('server_id', gethostname());
    $scope->setUser(['id' => 'user-123', 'role' => 'admin']);
});

// All events now include the region tag, server_id, and user context

Isolated Scopes

Create an isolated scope for a block of code. Tags and context set inside don't leak outside.

<?php

use function LogTide\{withScope, info};

withScope(function () {
    \LogTide\LogtideSdk::getCurrentHub()->getScope()->setTag('handler', 'payment');

    info('Processing payment', ['order_id' => 456]);
    // This event includes the 'handler' tag
});

info('Back to global scope');
// This event does NOT include the 'handler' tag

Spans

<?php

use function LogTide\{startSpan, finishSpan, captureException};

$span = startSpan('db.query SELECT users', [
    'kind' => \LogTide\Enum\SpanKind::CLIENT,
]);

$span?->setAttributes([
    'db.system' => 'postgresql',
    'db.statement' => 'SELECT * FROM users WHERE id = $1',
]);

try {
    $result = $db->query('SELECT * FROM users WHERE id = ?', [$userId]);
    $span?->setStatus(\LogTide\Enum\SpanStatus::OK);
} catch (\Throwable $e) {
    $span?->setStatus(\LogTide\Enum\SpanStatus::ERROR, $e->getMessage());
    captureException($e);
}

if ($span !== null) {
    finishSpan($span);
}

Trace Propagation

Framework SDKs automatically extract incoming traceparent headers and inject them into responses for end-to-end trace correlation.

<?php

use function LogTide\{getTraceparent, continueTrace};

// Continue a trace from an incoming request
$traceparent = $_SERVER['HTTP_TRACEPARENT'] ?? '';
if (!empty($traceparent)) {
    continueTrace($traceparent);
}

// Get the current traceparent to propagate to outgoing requests
$outgoingTraceparent = getTraceparent();
// → "00-<trace-id>-<span-id>-01"

$response = $httpClient->request('GET', 'https://api.example.com/data', [
    'headers' => ['traceparent' => $outgoingTraceparent],
]);

LogtideHandler

Forwards Monolog records to LogTide as log events.

<?php

use Monolog\Logger;
use Monolog\Level;
use LogTide\Monolog\LogtideHandler;

// Initialize the SDK first
\LogTide\init(['dsn' => 'https://[email protected]']);

// Create a Monolog logger with the LogTide handler
$logger = new Logger('my-app');
$logger->pushHandler(new LogtideHandler(Level::Debug));

// Use standard Monolog methods — logs are sent to LogTide
$logger->info('User logged in', ['user_id' => $userId]);
$logger->error('Payment failed', ['order_id' => $orderId]);

BreadcrumbHandler

Records Monolog entries as breadcrumbs instead of sending them as log events.

<?php

use Monolog\Logger;
use Monolog\Level;
use LogTide\Monolog\LogtideHandler;
use LogTide\Monolog\BreadcrumbHandler;

$logger = new Logger('my-app');

// Low-level logs become breadcrumbs (trail of events)
$logger->pushHandler(new BreadcrumbHandler(Level::Debug));

// Important logs are sent as events
$logger->pushHandler(new LogtideHandler(Level::Warning));