設定

OpenTelemetry PHP Distro は、標準的な OpenTelemetry SDK の設定と Distro 固有のオプションをサポートしています。

設定方法

PHP プロセスで利用可能な環境変数を使用して設定します。

• OTEL_*：OpenTelemetry 標準オプション
• OTEL_PHP_*：Distro 固有のオプション

例:

export OTEL_EXPORTER_OTLP_ENDPOINT="https://your-endpoint:443/"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer <token>"
export OTEL_PHP_LOG_LEVEL_STDERR="INFO"

OpenTelemetry オプション

Distro は標準的な OpenTelemetry PHP SDK オプションをサポートしています。

Distro 固有のオプション（OTEL_PHP_*） {#distro-specific-options-otelphp}

すべての OTEL_PHP_* オプションは環境変数または php.ini で設定できます。

php.ini の場合は、opentelemetry_distro. 接頭辞とオプション名の小文字を使用してください。

例:

export OTEL_PHP_ENABLED=true

opentelemetry_distro.enabled=true

全般設定

非同期データ送信

ロギング

トランザクションスパン

属性ベースの計装

スコープ付き依存関係ブリッジ

推論スパン

中央設定（OpAMP）

サポータビリティ

注記

• バックグラウンド転送は OTLP HTTP/protobuf モードで動作します。
• OTEL_PHP_AUTOLOAD_ENABLED は Distro ランタイムによって有効として強制されます。
• Distro パッケージには複数の依存関係（OpenTelemetry SDK、各種自動計装パッケージ、およびそれらの推移的依存関係）が含まれています。 アプリケーション自体の依存関係との名前空間の衝突を防ぐため、Distro はデフォルトでスコープ付き（名前空間接頭辞付き）の依存関係を使用します。 スコープなしの依存関係にフォールバックするには、OTEL_PHP_SCOPED_DEPS_ENABLED=false を設定してください。

スコープ付き依存関係ブリッジの相互運用

デフォルトでは、Distro の OpenTelemetry ランタイムはスコープ付きです。 そのクラスは固有の名前空間接頭辞の下に配置され、アプリケーションが Composer 経由でインストールする標準的な OpenTelemetry\* クラスとは分離されています。 その結果、アプリケーション自体の OpenTelemetry 使用は別のランタイムに対して実行され、そのスパンはエクスポートされず、Distro のトレースにも接続されません。

OTEL_PHP_SCOPED_DEPS_BRIDGE_ENABLED=true を設定すると、2つのランタイムがブリッジされます。 アプリケーションの Composer オートローダーが実行される前に、Distro はスコープなしの OpenTelemetry\* API をスコープ付き実装にマッピングするクラスエイリアスを登録します。 これにより、アプリケーション自体の OpenTelemetry 使用は Distro のトレーサープロバイダーとコンテキストを透過的に使用するようになり、そのスパンはエクスポートされ、Distro のトレース内で正しく親子関係が設定されます。

このオプションは、スコープが無効な場合（OTEL_PHP_SCOPED_DEPS_ENABLED=false）は効果がありません。 スコープなしの場合、Distro はすでにスコープなしの OpenTelemetry\* クラスを使用しているため、ブリッジなしで共有が行われます。

ファイルベースの設定（宣言型）

環境変数のかわりに、OTEL_CONFIG_FILE 環境変数を設定することで、YAML 設定ファイルを使用して SDK を設定できます。

export OTEL_CONFIG_FILE=/path/to/otel-config.yaml

OTEL_CONFIG_FILE が設定されている場合:

• SDK は個別の OTEL_* 環境変数のかわりに、YAML ファイルからすべての設定を読み込みます。
• YAML ファイル内では環境変数の置換（${MY_VAR:-default}）がサポートされています。
• 中央設定（OpAMP）は自動的に無効化されます。ファイルベースの設定とリモート設定は相互に排他的です。
• Distro 固有のオプション（OTEL_PHP_*）はネイティブエクステンションのオプションであり、SDK から独立しているため、引き続き動作します。

Distro リソースディテクター

Distro は telemetry.distro.name と telemetry.distro.version のリソース属性を追加する distro リソースディテクターを提供しています。 ファイルベースの設定でこれを有効にするには、resource.detection/development.detectors セクションに追加してください。

file_format: '1.0-rc.2'

resource:
  attributes:
    - name: service.name
      value: my-service
  detection/development:
    detectors:
      - distro: {}

propagator:
  composite:
    - tracecontext:
    - baggage:

tracer_provider:
  processors:
    - batch:
        exporter:
          otlp_http:
            endpoint: http://localhost:4318/v1/traces

meter_provider:
  readers:
    - periodic:
        exporter:
          otlp_http:
            endpoint: http://localhost:4318/v1/metrics

logger_provider:
  processors:
    - batch:
        exporter:
          otlp_http:
            endpoint: http://localhost:4318/v1/logs

完全な YAML スキーマについては、OpenTelemetry Configuration Schema を参照してください。

制限事項

• ファイルベースの設定がアクティブな場合、中央設定（OpAMP）は利用できません。
• Registry::registerResourceDetector() 経由で登録されたリソースディテクター（たとえば opentelemetry-php-contrib のクラウドプロバイダーディテクター）は自動的には有効化されません。 ComponentProvider を提供し、YAML の resource.detection/development.detectors セクションに明示的に記載する必要があります。