tbachert/otel-instrumentation-amphp-http-client

OpenTelemetry amphp/http-client instrumentation

dev-main / 0.1.x-dev 2026-02-15 10:40 UTC

Requires

• php: ^8.2
• composer-runtime-api: ^2.0
• amphp/http-client: ^5.0
• league/uri: ^7.0
• open-telemetry/api: ^1.8
• open-telemetry/context: ^1.1
• open-telemetry/opentelemetry-config-http: ^0.1

Requires (Dev)

• amphp/http-server: ^3.3
• amphp/phpunit-util: ^3.0
• phpunit/phpunit: ^9.6
• tbachert/otel-sdk: ^0.1

Apache-2.0

• instrumentation
• opentelemetry
• otel

README

Installation

composer require tbachert/otel-instrumentation-amphp-http-client

Usage

Automatic instrumentation

This instrumentation is enabled by default.

Disable via file-based configuration

instrumentations/development:
  php:
    amphp_http_client: false

Disable via env-based configuration

OTEL_PHP_DISABLED_INSTRUMENTATIONS=amphp-http-client

Manual instrumentation

use Amp\Http\Client\HttpClientBuilder;
use Nevay\OTelInstrumentation\AmphpHttpClient\EventListener\Logs;
use Nevay\OTelInstrumentation\AmphpHttpClient\EventListener\Metrics;
use Nevay\OTelInstrumentation\AmphpHttpClient\EventListener\RequestPropagator;
use Nevay\OTelInstrumentation\AmphpHttpClient\EventListener\Tracing;

$httpClient = (new HttpClientBuilder)
    ->listen(new Tracing($tracerProvider))
    ->listen(new Metrics($meterProvider))
    ->listen(new Logs($loggerProvider))
    ->listen(new RequestPropagator($propagator))
    ->build();

$response = $httpClient->request(...);

Accessing the client span of a request

use OpenTelemetry\API\Trace\SpanInterface;

$span = $response->getRequest()->getAttribute(SpanInterface::class);