Integrazione di OpenTelemetry con Instana per le applicazioni PHP

È possibile abilitare la strumentazione automatica impostando le variabili d'ambiente; in questo modo, OpenTelemetry traccierà automaticamente le librerie supportate da PHP.

Per ulteriori informazioni, consultare l 'applicazione dimostrativa disponibile all'indirizzo WordPress PHP, che illustra la strumentazione zero-code di OpenTelemetry PHP e l'integrazione di OpenTelemetry con Instana.

È possibile attivare la strumentazione automatica impostando le seguenti variabili d'ambiente minime:

Esempio

OTEL_PHP_AUTOLOAD_ENABLED=true
OTEL_SERVICE_NAME=wordpress_otel_instrumentation
OTEL_TRACES_EXPORTER=otlp
OTEL_EXPORTER_OTLP_PROTOCOL=grpc
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
OTEL_PROPAGATORS=instana,tracecontext

Una volta completate queste configurazioni, è possibile avviare un'applicazione PHP; le tracce OpenTelemetry generate da essa saranno visibili nell'interfaccia utente Instana.

È inoltre possibile configurare le applicazioni PHP in modo che inviino le tracce dell' OpenTelemetry direttamente all'agente Instana o al backend utilizzando gli endpoint OTLP.

È necessario integrare manualmente le applicazioni con l'SDK di OpenTelemetry nei seguenti casi:

• Non stai utilizzando la strumentazione della libreria PHP supportata da OTel o Instana.
• Vuoi ampliare le funzionalità della libreria Tracer di PHP.
• È necessario un controllo più preciso sulla strumentazione delle applicazioni.

Per configurare la strumentazione manuale, procedere come segue:

1. Installa i pacchetti OpenTelemetry, API e SDK.

   composer require open-telemetry/sdk
   composer require open-telemetry/api
   

2. Aggiungi la strumentazione manuale OpenTelemetry desiderata al tuo codice PHP seguendo la documentazione sulla strumentazione manuale disponibile all'indirizzo OpenTelemetry PHP.

3. Scegli un propagatore di contesti di tracciamento di tipo " OpenTelemetry " per le applicazioni distribuite. Instana supporta le intestazioni di tracciamento W3C e le intestazioni native Instana per la propagazione delle tracce.

   • Utilizzo di una cassetta di semina " Instana "

     OTEL_PROPAGATORS=instana
     

   • Utilizzo tracecontext del propagatore

     OTEL_PROPAGATORS=tracecontext
     

   L'uso dei propagatori consente a Instana di unire i segmenti di OpenTelemetry e altri segmenti di Instana in un'unica traccia della tua applicazione.

   Per ulteriori informazioni sugli strumenti di esempio per il tracciamento distribuito, consultare Abilitazione della propagazione del contesto per il tracciamento distribuito.

Il seguente semplice esempio illustra la strumentazione manuale con uno span padre e uno figlio:

use OpenTelemetry\SDK\Registry;
use OpenTelemetry\SDK\Trace\SpanProcessor\SimpleSpanProcessor;
use OpenTelemetry\SDK\Trace\TracerProvider;
use OpenTelemetry\API\Trace\SpanKind;

$tracerProvider = new TracerProvider(
   new SimpleSpanProcessor(
      Registry::spanExporterFactory("otlp")->create()
      )
    );
$tracer = $tracerProvider->getTracer('test');
$rootSpan = $tracer->spanBuilder('rootSpan')->startSpan();
$scope = $rootSpan->activate();

// Do some work
sleep(1);
// Create a child span (automatically becomes a child of the active span)
$childSpan = $tracer->spanBuilder('child-operation')
    ->startSpan();
$childScope = $childSpan->activate();
$childSpan->end();
$childScope->detach();

// Do more work
sleep(1);

// Add string attribute
$rootSpan->setAttribute('string.attribute', 'value');
$scope->detach();
$rootSpan->end();
$tracerProvider->shutdown();

Il propagatore " OpenTelemetry " per Instana fornisce la propagazione dell'intestazione HTTP e la propagazione dei dati di bagaglio da utilizzare con l'applicazione PHP. Questo propagatore converte le intestazioni di correlazione delle tracce (X-INSTANA-T/X-INSTANA-S/X-INSTANA-L)Instana in OpenTelemetrySpanContext e OpenTelemetrySpanContext in Instana.

Qui è possibile trovare un semplice esempio di applicazione distribuita di tipo " PHP " che illustra la strumentazione manuale tramite il propagatore di contesto Instana.