SignalFx .NET Instrumentationからの移行 🔗

Splunk Distribution of OpenTelemetry .NET のエージェントは、SignalFx Instrumentation for .NET の代替です。SignalFx Instrumentation から移行するには、以下の手順に従ってください。

互換性と要件 🔗

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

Splunk Distribution of OpenTelemetry .NETへの移行 🔗

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

SignalFx Instrumentation for .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`.サポートされているインストルメンテーションのリストについては、対応ライブラリを参照してください。
`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` に設定するのと同じです。

このページは 2024年01月18日に最終更新されました。

Related Topics

SignalFx .NET Instrumentationからの移行 🔗

互換性と要件 🔗

Splunk Distribution of OpenTelemetry .NETへの移行 🔗

機能の変更 🔗

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

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

Was this topic useful?

Splunk

Related Topics