tbachert/otel-instrumentation-doctrine-dbal

OpenTelemetry doctrine/dbal instrumentation

dev-main / 0.1.x-dev 2026-02-17 19:45 UTC

Requires

• php: ^8.2
• composer-runtime-api: ^2.0
• ext-mbstring: *
• doctrine/dbal: ^4.0
• open-telemetry/api: ^1.1
• phpmyadmin/sql-parser: ^6.0

Requires (Dev)

• phpunit/phpunit: ^11.3
• tbachert/otel-sdk: ^0.1

Apache-2.0

• instrumentation
• opentelemetry
• otel

README

Installation

composer require tbachert/otel-instrumentation-doctrine-dbal

Usage

Automatic instrumentation

This instrumentation is enabled by default.

Disable via file-based configuration

instrumentations/development:
  php:
    doctrine_dbal: false

Disable via env-based configuration

OTEL_PHP_DISABLED_INSTRUMENTATIONS=doctrine-dbal

Manual registration

use Doctrine\DBAL\Configuration;
use Doctrine\DBAL\DriverManager;
use Nevay\OTelInstrumentation\DoctrineDbal\TracingMiddleware;

$config = new Configuration();
$config->setMiddlewares([
    new TracingMiddleware($tracerProvider),
]);
$connection = DriverManager::getConnection($params, $config);