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

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. SignalFx Instrumentation for .NETをアンインストールします。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 に設定するのと同じです。

This page was last updated on 2024年01月18日.