README

This is the official Symfony SDK for Apex Toolbox - Automatic logging, error tracking, and request monitoring for Symfony applications.

Getting Started

Install

composer require apextoolbox/symfony-logger

Configure

Add your token to .env:

APEX_TOOLBOX_TOKEN=your_token_here

Usage

That's it! All logs, exceptions, and HTTP requests are automatically tracked:

// Manually log exceptions with context (no imports needed!)
try {
    processPayment($order);
} catch (PaymentException $e) {
    logException($e, ['order_id' => $order->id]);
    throw $e;
}

// Or using the Apex facade
use ApexToolbox\Symfony\Apex;
Apex::logException($e, ['order_id' => $order->id]);

// Standard Monolog logging works too
$logger->info('User created', ['user_id' => 123]);
$logger->error('Payment failed', ['order_id' => 456]);

// Uncaught exceptions are automatically captured
throw new Exception('Something went wrong');

// HTTP requests are automatically monitored (api/* routes by default)

What's Tracked Automatically

All logs - Via Monolog integration
Exceptions - With full stack traces and code context
HTTP requests - Request/response data, performance metrics
Security - Sensitive data (passwords, tokens) filtered by default

Configuration

The bundle is configured in config/packages/apex_toolbox.yaml (auto-created):

apex_toolbox:
    token: '%env(APEX_TOOLBOX_TOKEN)%'
    enabled: true

    # Customize path filtering
    path_filters:
        include: ['api/*']       # Track API routes
        exclude: ['api/health']  # Skip health checks

    # Security filtering (defaults provided)
    body:
        exclude: ['password', 'token', 'secret']
        mask: ['email', 'phone', 'ssn']

Advanced Options

Path filtering - Control which routes are tracked with wildcards
Data masking - Mask vs exclude sensitive fields (PII, credentials)
Console tracking - Monitor Symfony console commands
Queue tracking - Track Messenger queue jobs

Full configuration options available in config/packages/apex_toolbox.yaml after installation.

apextoolbox / symfony-logger

Maintainers

Details