PHP 애플리케이션을 위해 OpenTelemetry 와 Instana 통합하기

환경 변수를 설정하여 자동 계측 기능을 활성화하면, OpenTelemetry 가 지원되는 PHP 라이브러리를 자동으로 추적할 수 있습니다.

참고로, 여기에서 코딩 없이 PHPWordPress 데모 애플리케이션 계측을 수행하고 OpenTelemetryPHP 와 OpenTelemetry 통합하는 방법을 확인할 Instana 수 있습니다.

다음과 같은 최소한의 환경 변수를 설정하여 자동 계측 기능을 활성화할 수 있습니다:

예

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

이러한 설정이 완료되면 PHP 애플리케이션을 시작할 수 있으며, 해당 애플리케이션에서 생성된 OpenTelemetry 추적 정보는 Instana UI에서 확인할 수 있습니다.

또한 OTLP 엔드포인트를 사용하여 PHP 애플리케이션을 구성함으로써, OpenTelemetry 추적 정보를 Instana 에이전트나 백엔드로 직접 전송하도록 설정할 수 있습니다.

다음과 같은 경우에는 OpenTelemetry SDK를 사용하여 애플리케이션에 수동으로 계측 기능을 추가해야 합니다:

• OTel 이나 Instana 에서 지원하는 PHP 라이브러리 계측 기능을 사용하고 있지 않습니다.
• PHP Tracer 라이브러리의 기능을 확장하고자 합니다.
• 애플리케이션에 계측 기능을 적용하는 데 있어 더 세밀한 제어가 필요합니다.

수동 계측을 설정하려면 다음 단계를 따르십시오:

1. OpenTelemetry, API 및 SDK 패키지를 설치하십시오.

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

2. OpenTelemetry PHP 수동 계측 문서 에 따라 원하는 수동 OpenTelemetry 계측을 PHP 코드에 추가하십시오.

3. 분산 애플리케이션에는 ‘ OpenTelemetry ’ 추적 컨텍스트 전파기를 선택하십시오. Instana 추적 전파를 위해 W3C 추적 헤더와 Instana 네이티브 헤더를 지원합니다.

   • Instana 전파기 사용

     OTEL_PROPAGATORS=instana
     

   • 프로파게이터 tracecontext 사용

     OTEL_PROPAGATORS=tracecontext
     

   프로파게이터를 사용하면 Instana 가 OpenTelemetry 스팬 및 기타 Instana 스팬을 애플리케이션의 단일 추적 정보로 통합할 수 있습니다.

   분산 추적을 위한 예제 계측에 대한 자세한 내용은 ‘분산 추적을 위한 컨텍스트 전파 활성화’를 참조하십시오.

다음의 간단한 예제는 부모 스팬과 자식 스팬을 사용한 수동 계측을 보여줍니다:

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();

‘더 OpenTelemetry 프로파게이터’ 는 해당 PHP 애플리케이션과 함께 사용할 Instana 헤더 전파 및 바게이지 HTTP 전파 기능을 제공합니다. 이 프로파게이터는 Instana 트레이스 상관 관계 헤더를 (X-INSTANA-T/X-INSTANA-S/X-INSTANA-L)OpenTelemetry 로 변환하고, SpanContextOpenTelemetrySpanContext 를 Instana 헤더로 변환합니다.

여기에서 Instana 컨텍스트 전파기를 사용하여 수동 계측을 시연하는 간단한 분산형 PHP 애플리케이션 예제를 확인할 수 있습니다.