README

logtide/logtide-slim

LogTide middleware for Slim 4 — automatic request tracing, error capture, and breadcrumbs.

Features

• Automatic request spans for every incoming request
• Error capture with full request context via error middleware
• W3C Trace Context propagation (traceparent in/out)
• Route pattern resolution from Slim routing
• Configurable skip paths (e.g. /health, /healthz)
• PSR-15 compliant middleware
• Slim 4 support

Installation

composer require logtide/logtide-slim

Quick Start

use LogTide\Slim\LogtideMiddleware;
use LogTide\Slim\LogtideErrorMiddleware;
use Slim\Factory\AppFactory;

// Initialize LogTide
\LogTide\init([
    'dsn' => 'https://lp_your_key@your-instance.com',
    'service' => 'my-slim-api',
]);

$app = AppFactory::create();

// Add LogTide request tracing middleware
$app->add(new LogtideMiddleware());

// Add routes
$app->get('/hello/{name}', function ($request, $response, $args) {
    $response->getBody()->write("Hello, {$args['name']}!");
    return $response;
});

// Option A: Use Slim's built-in error middleware (LogtideMiddleware captures errors too)
$app->addErrorMiddleware(true, true, true);

// Option B: Use LogtideErrorMiddleware as a standalone alternative
// $app->add(new LogtideErrorMiddleware($app->getResponseFactory()));

$app->run();

How It Works

The middleware runs on every request and:

1. Extracts incoming traceparent header (or generates a new trace)
2. Creates a span named after the request (e.g. HTTP GET /hello/{name})
3. Records breadcrumbs for request and response
4. Calls the next middleware/handler
5. Finishes the span with ok or error based on response status
6. Injects traceparent into the response headers
7. Captures errors for 5xx responses with full context

Configuration

Skip Paths

$middleware = new LogtideMiddleware(
    skipPaths: ['/health', '/healthz', '/metrics'],
);

Error Middleware

LogtideErrorMiddleware is a standalone alternative to Slim's built-in addErrorMiddleware. It captures exceptions, logs them to LogTide, and renders an error response.

use LogTide\Slim\LogtideErrorMiddleware;

// Use instead of $app->addErrorMiddleware()
$app->add(new LogtideErrorMiddleware(
    responseFactory: $app->getResponseFactory(),
    displayErrorDetails: true, // show details in dev
));

License

MIT License - see LICENSE for details.

Links

• LogTide Website
• Documentation
• GitHub