Docs » Splunk Observability Cloud でサポートされているインテグレーション » バックエンドアプリケーションをインストルメンテーションして、スパンを Splunk APM に送信する » Splunk Observability Cloud (OpenTelemetry) 用 .NET アプリケーションのインストルメンテーション » Migrate to OpenTelemetry from the SignalFx .NET Instrumentation

注意

The SignalFx Instrumentation for .NET reached End of Support on February 21, 2025. The library has been archived and is no longer maintained.

If you want to instrument the .NET ecosystem use the Splunk Distribution of OpenTelemetry .NET.

Migrate to OpenTelemetry from the 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 に移行するには、以下の手順に従ってください:

  1. Uninstall the SignalFx Instrumentation for .NET.

  2. Splunk Distribution of OpenTelemetry .NETをインストールし、アクティブ化します。.NETアプリケーションのインストルメンテーション を参照してください。

  3. トレースをエクスポートする OpenTelemetry Collector のエンドポイントを指定します。エクスポート設定 を参照してください。

  4. 設定を更新してください。機能の変更 を参照してください。

手動でコードを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 に設定するのと同じです。

このページは 2025年03月25日 に最終更新されました。