SignalFx .NET InstrumentationからOpenTelemetryへの移行

Splunk Distribution of OpenTelemetry .NET のエージェントは、SignalFx Instrumentation for .NET の代替です。SignalFx インストルメンテーションから移行するには、次の手順に従います。

互換性と要件

要件の完全なリストについては、「OpenTelemetry .NET インストルメンテーションの互換性と要件」を参照してください。

Splunk Distribution of OpenTelemetry .NETへの移行

SignalFx Instrumentation for .NET から Splunk Distribution of OpenTelemetry .NET に移行するには、以下の手順に従ってください：

SignalFx Instrumentation for .NETをアンインストールします。
Splunk Distribution of OpenTelemetry .NET をインストールし、アクティブ化します。「.NET アプリケーションのインストルメンテーション」を参照してください。
トレースをエクスポートする OpenTelemetry Collector のエンドポイントを指定します。「エクスポート設定」を参照してください。
設定を更新してください。「機能の変更」を参照してください。

手動でコードをOpenTracingでインストルメンテーションした場合は、OTEL_DOTNET_AUTO_OPENTRACING_ENABLED 環境変数を true に設定することで、OpenTracingのサポートを有効にしてください。

機能の変更

以下の各セクションでは、SignalFx Instrumentation for .NET から Splunk Distribution of OpenTelemetry .NET への移行に伴う機能の主な変更点について説明します。

コンフィギュレーション設定の変更

次の表は、SignalFx Instrumentation for .NET 環境変数と、それに相当する OpenTelemetry 環境変数を示しています：


SignalFx 環境変数	OpenTelemetry環境変数
`SIGNALFX_SERVICE_NAME`	`OTEL_SERVICE_NAME=<service_name>`
`SIGNALFX_ENV`	`OTEL_RESOURCE_ATTRIBUTES=deployment.environment=<environment_name>`
`SIGNALFX_VERSION`	`OTEL_RESOURCE_ATTRIBUTES=version=<version>`
`SIGNALFX_GLOBAL_TAGS`	`OTEL_RESOURCE_ATTRIBUTES`
`SIGNALFX_TRACE_{<instrumentation>}_ENABLED`	`OTEL_DOTNET_AUTO_TRACES_DISABLED_INSTRUMENTATIONS`
`SIGNALFX_RECORDED_VALUE_MAX_LENGTH`	`OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT`
SIGNALFX_DISABLED_INTEGRATIONS	`OTEL_DOTNET_AUTO_TRACES_DISABLED_INSTRUMENTATIONS`します。サポートされているインストルメンテーションのリストについては、「Supported libraries」を参照してください。
`SIGNALFX_AZURE_APP_SERVICES`	該当なし
`SIGNALFX_DOTNET_TRACER_HOME`	`OTEL_DOTNET_AUTO_HOME`を使用して無効にすることができます。Linux では、`$HOME/.splunk-otel-dotnet` に設定します。
`SIGNALFX_PROFILER_EXCLUDE_PROCESSES`	`OTEL_DOTNET_AUTO_EXCLUDE_PROCESSES`
`SIGNALFX_PROFILER_PROCESSES`	該当なし
`SIGNALFX_TRACE_CONFIG_FILE`	該当なし
`SIGNALFX_TRACE_ENABLED`	該当なし
`SIGNALFX_METRICS_{<metric>}_ENABLED`	`OTEL_DOTNET_AUTO_METRICS_ENABLED_INSTRUMENTATIONS` `OTEL_DOTNET_AUTO_METRICS_DISABLED_INSTRUMENTATIONS`
`SIGNALFX_ACCESS_TOKEN`	`SPLUNK_ACCESS_TOKEN`
`SIGNALFX_REALM`	`SPLUNK_REALM`
`SIGNALFX_ENDPOINT_URL`	`OTEL_EXPORTER_OTLP_ENDPOINT`
`SIGNALFX_METRICS_ENDPOINT_URL`	`OTEL_EXPORTER_OTLP_ENDPOINT`
`SIGNALFX_TRACE_PARTIAL_FLUSH_ENABLED`	該当なし
`SIGNALFX_TRACE_PARTIAL_FLUSH_MIN_SPANS`	該当なし
`SIGNALFX_TRACE_BUFFER_SIZE`	`OTEL_BSP_MAX_QUEUE_SIZE`を使用して無効にすることができます。デフォルト値は `2048` です。
`SIGNALFX_PROPAGATORS`	`OTEL_PROPAGATORS`します。デフォルト値は `tracecontext, baggage` です。 `b3multi, b3` も使用可能です。
`SIGNALFX_PROFILER_ENABLED`	`SPLUNK_PROFILER_ENABLED`
`SIGNALFX_PROFILER_MEMORY_ENABLED`	`SPLUNK_PROFILER_MEMORY_ENABLED`
`SIGNALFX_PROFILER_LOGS_ENDPOINT`	`SPLUNK_PROFILER_LOGS_ENDPOINT`
`SIGNALFX_PROFILER_CALL_STACK_INTERVAL`	`SPLUNK_PROFILER_CALL_STACK_INTERVAL`

Splunk OTel .NET 設定の詳細については、「Splunk Distribution of OpenTelemetry .NET を設定する」を参照してください。

ライブラリ固有のインストルメンテーション設定

次の表は、SignalFx Instrumentation for .NET と OpenTelemetry のライブラリ固有の環境変数を示しています：


SignalFx 環境変数	OpenTelemetry環境変数
`SIGNALFX_HTTP_CLIENT_ERROR_STATUSES`	該当なし
`SIGNALFX_HTTP_SERVER_ERROR_STATUSES`	該当なし
`SIGNALFX_INSTRUMENTATION_ELASTICSEARCH_TAG_QUERIES`	該当なし
`SIGNALFX_INSTRUMENTATION_MONGODB_TAG_COMMANDS`	環境変数では設定できない
`SIGNALFX_INSTRUMENTATION_REDIS_TAG_COMMANDS`	環境変数では設定できません。
`SIGNALFX_LOGS_INJECTION`	`Microsoft.Extensions.Logging` 変数を使用した場合、ログは相関します。
`SIGNALFX_TRACE_DELAY_WCF_INSTRUMENTATION_ENABLED`	該当なし
`SIGNALFX_TRACE_HEADER_TAGS`	該当なし
`SIGNALFX_TRACE_HTTP_CLIENT_EXCLUDED_URL_SUBSTRINGS`	環境変数では設定できません。
`SIGNALFX_TRACE_KAFKA_CREATE_CONSUMER_SCOPE_ENABLED`	該当なし
`SIGNALFX_TRACE_RESPONSE_HEADER_ENABLED`	`SPLUNK_TRACE_RESPONSE_HEADER_ENABLED`
`SIGNALFX_TRACE_ROUTE_TEMPLATE_RESOURCE_NAMES_ENABLED`	該当なしデフォルトの動作は、以前の設定を `true` に設定するのと同じです。