Enable the Combined Mode for .NET Agent

You can configure the combined mode for .NET Agent (Splunk-only mode and Dual-signal mode). The combined mode is not supported in NuGet-based distributions and Azure AppService Extensions.

Prerequisites

  • Upgrade the AppDynamics .NET APM Agent to version 26.5 or later.

  • Ensure that your .NET application uses a runtime supported by both the AppDynamics and OpenTelemetry (OTel) profilers:

    • .NET 8.0, 9.0, or 10.0

    • .NET Framework 4.7 or later

    • .NET Framework 4.6.2

  • Use a supported platform:

    • Windows or Linux

    • x86 or AMD64 architecture

  • By default, you must install the OpenTelemetry Collector separately to send data to Splunk Observability Cloud.

Enable Dual-signal mode

Ensure your .NET application is running on a supported runtime that is mutually compatible with both AppDynamics and OpenTelemetry (OTEL) profilers.

To enable dual mode, set the AGENT_DEPLOYMENT_MODE=dual environment variables before starting your application.

Enable Splunk-only mode

To enable this mode, set the AGENT_DEPLOYMENT_MODE=otel environment variables before starting your application.

Configure .Net OpenTelemetry Agent

After providing the required environment variables, you must also provide configuration for the OTEL component to successfully report data. At a minimum, you must define:
  • Service Identification: A unique name to identify your service in the observability platform.
  • Telemetry Export Destination: The endpoint (the Splunk Distribution of the OpenTelemetry Collector) where the agent should send telemetry data.
You can additionally define the following environment variables:
  • OTEL_SERVICE_NAME: Specify the service name.
  • OTEL_RESOURCE_ATTRIBUTES: Specify service namespace and deployment environment variables.
  • OTEL_EXPORTER_OTLP_ENDPOINT: This environment variable changes the OTLP endpoint.
Example:
CODE
OTEL_SERVICE_NAME=<service_name>
OTEL_RESOURCE_ATTRIBUTES=service.namespace=<service_namespace>,deployment.environment.name=<environment>
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318