SDK 設定

SDK レベルの設定（リソース、プロパゲーター、エクスポーター）は、application.yaml 内で標準の宣言的設定スキーマを直接使用します。 システムプロパティや環境変数でも値をオーバーライドできます。 環境変数によるオーバーライドを参照してください。

otel:
  file_format: '1.0'

  resource:
    attributes:
      - name: deployment.environment
        value: dev
      - name: service.name
        value: cart
      - name: service.namespace
        value: shop

  propagator:
    composite:
      - tracecontext:
      - b3:

テスト目的などでスターターを無効にするには、otel.disabled を true に設定します。

注意：宣言的設定では、プロパティ名は otel.sdk.disabled ではなく otel.disabled です。

otel:
  file_format: '1.0'
  disabled: true

宣言的設定では、リソースプロバイダーは resource.detection/development.detectors 配下のディテクターとして明示的に設定します。 リストに含まれたディテクターのみが有効になり、SPI による自動検出は行われません。

otel:
  resource:
    detection/development:
      detectors:
        - container: # container.id
        - host: # host.name, host.arch
        - host_id: # host.id
        - os: # os.type, os.description
        - process: # process.pid, process.executable.path, process.command_line
        - process_runtime: # process.runtime.name/version/description
        - service: # service.name, service.instance.id
        - spring: # service.name (from spring.application.name), service.version (from build-info)

属性 telemetry.distro.name と telemetry.distro.version は、トラブルシューティングのためにスターターによって常に自動的に追加されます。

サービス名は、含めるリソースディテクターによって決まります（リソースプロバイダーを参照）。

1. otel.resource.attributes の service.name（最も優先度が高い）：

   otel:
     resource:
       attributes:
         - name: service.name
           value: my-spring-app
   

2. service ディテクター — 含まれている場合、OTEL_SERVICE_NAME から自動検出します：

   otel:
     resource:
       detection/development:
         detectors:
           - service:
   

3. spring ディテクター — 含まれている場合、spring.application.name と build-info.properties から検出します：

   otel:
     resource:
       detection/development:
         detectors:
           - spring:
   

4. デフォルト値は unknown_service:java（最も優先度が低い）