mangoweb/monolog-tracy-handler

Integrates Tracy into Monolog, supports uploading Tracy bluescreens to AWS S3

v2.0.0 2026-04-19 06:48 UTC

Requires

• php: ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
• mangoweb/clock: ~0.2.0
• monolog/monolog: ~3.0
• tracy/tracy: ~2.10

Requires (Dev)

• mockery/mockery: ~1.6.12
• nette/tester: ~2.5.7
• phpstan/phpstan: ~2.1

MIT

README

• Integrates Tracy into Monolog
• Supports uploading Tracy bluescreens to AWS S3

Installation

composer require mangoweb/monolog-tracy-handler

Usage with Symfony

Install symfony/monolog-bundle and add to config/services.yaml

services:
    Mangoweb\MonologTracyHandler\TracyProcessor:
        tags:
            - { name: monolog.processor }

    Mangoweb\MonologTracyHandler\TracyHandler:
        arguments:
            $localBlueScreenDirectory: '%kernel.logs_dir%'
        tags:
            - { name: monolog.logger }

monolog:
    handlers:
        tracy:
            type: service
            id: Mangoweb\MonologTracyHandler\TracyHandler

You can optionally configure remote storage for Tracy bluescreens.

services:
    Mangoweb\MonologTracyHandler\RemoteStorageDriver:
        class: Mangoweb\MonologTracyHandler\RemoteStorageDrivers\AwsS3RemoteStorageDriver
        arguments:
            $region: '...'
            $bucket: '...'
            $prefix: 'tracy/'
            $accessKeyId: '...'
            $secretKey: '...'

    Mangoweb\MonologTracyHandler\RemoteStorageRequestSender:
        class: Mangoweb\MonologTracyHandler\RemoteStorageRequestSenders\ExecCurlRequestSender

Usage with Nette

Install contributte/monolog and add to app/config/config.neon

extensions:
    monolog: Contributte\Monolog\DI\MonologExtension

monolog:
    channel:
        default:
            processors:
                - Mangoweb\MonologTracyHandler\TracyProcessor

            handlers:
                - Mangoweb\MonologTracyHandler\TracyHandler('%appDir%/../log')

You can optionally configure remote storage for Tracy bluescreens.

services:
    monologTracyStorageDriver:
        type: Mangoweb\MonologTracyHandler\RemoteStorageDriver
        factory: Mangoweb\MonologTracyHandler\RemoteStorageDrivers\AwsS3RemoteStorageDriver
        arguments:
            region: '...'
            bucket: '...'
            prefix: 'tracy/'
            accessKeyId: '...'
            secretKey: '...'

    monologTracyRequestSender:
        type: Mangoweb\MonologTracyHandler\RemoteStorageRequestSender
        factory: Mangoweb\MonologTracyHandler\RemoteStorageRequestSenders\ExecCurlRequestSender