Talaria
Docs

PHP errors, logs, and breadcrumbs

captureException, PSR-3 Talaria\Logger, breadcrumbs, and user context on talaria/talaria.

talaria/talariaerrorslogsbreadcrumbsidentity

Errors

Uncaught throwables are captured when default integrations are on. Catch recoverable work yourself:

php
try {
    charge();
} catch (Throwable $e) {
    Talaria::captureException($e, [
        'tags' => ['area' => 'billing'],
    ]);
    throw $e;
}
php
Talaria::captureMessage('Checkout failed closed', 'error');

minLevel of warning drops info and debug messages. Exceptions are errors, so they still pass.

Logs

Talaria\Logger implements PSR-3. Severity methods on the facade send the same stream.

php
$log = Talaria::logger([
    'name' => 'billing',
    'tags' => ['area' => 'billing'],
]);
$log->warning('Payment method missing');

Talaria::error('Charge declined');

Levels are debug, info, warning, error, and fatal. warn is warning. A scoped logger may use a lower minLevel than the client unless enforceDefaultLevel is true.

php
Talaria::addBreadcrumb([
    'type' => 'default',
    'category' => 'billing',
    'message' => 'Charge started',
    'level' => 'info',
]);

Guzzle, PDO, and Redis helpers add their own crumbs. The trail is attached to the next error (up to 50).

Identity and context

setUser and setTags live on the client. Prefer a processor when the PHP process is long-lived and the user changes every request. resetRequestState() clears request scope between requests.

php
$client = Talaria::getClient();
$client->setUser('user_42');
$client->setTags(['area' => 'billing']);

Set release and commitSha in init. Fingerprints are computed on the server.

Call Talaria::flush() before a CLI script exits.