Docs » Instrument back-end applications to send spans to Splunk APM » Instrument a .NET application for Splunk Observability Cloud

Instrument a .NET application for Splunk Observability Cloud 🔗

The SignalFx Tracing Library for .NET provides an OpenTracing-compatible tracer and automatically configures instrumentations for popular .NET libraries and frameworks. It supports .NET Core 2.0+ on Linux and Windows and .NET Framework 4.5+ on Windows.

The library implements the Profiling API and only requires your application environment’s basic configuration. For all available configuration options and their default values, see the README file.

Note

To instrument Azure app services with extensions, see Instrument Azure app services with extensions.

Start the integration 🔗

To start a .NET integration, follow these steps:

  1. In the Observability Cloud main menu, select Data Setup.

  2. In the CATEGORIES menu, select APM Instrumentation.

  3. Click .NET Tracing.

  4. Click Add Connection. The integration wizard appears.

  5. Follow the steps in the guided setup.

  6. At the end of the guided setup, go to APM to see a live view of your data flowing into the application.

Instrument Azure app services with extensions 🔗

You can automatically instrument an Azure web app running .NET Core or ASP.NET with the SignalFx .NET Tracing library. The extension is a modified version of the SignalFx Tracing Library for .NET.

Compatibility and requirements 🔗

The SignalFx .NET Tracing Library supports the following runtime versions:

  • .NET Core 3.1

  • .NET Core 2.1

To instrument an Azure app service with the SignalFx .NET Tracing library, check the following settings:

Setting

Value

Comment

Target

Code

The extension isn’t compatible with Docker.

Operating system

Windows

The extension isn’t compatible with Linux.

Note

For Docker images, use the SignalFx .NET Tracing Library.

Instrument an Azure web app 🔗

Follow these steps to instrument an Azure web app:

  1. Log in to the Microsoft Azure portal.

  2. Go to Home > App Services and select the service you want to instrument.

  3. From the Development Tools section, click Extensions.

  4. Add the SignalFx .NET Tracing.

  5. From the Extensions page, confirm that you successfully installed the extension.

  6. From the Settings section of the navigation menu for the app service, click Configuration.

  7. Add the following application settings to the app service:

    Name

    Value description

    SIGNALFX_SERVICE_NAME

    The name of the service.

    SIGNALFX_ACCESS_TOKEN

    The access token for your SignalFx organization. Providing a token lets you send traces to a SignalFx ingest endpoint.

    SIGNALFX_ENDPOINT_URL

    The host name and port for a SignalFx Smart Agent or OpenTelemetry Collector.

  8. (Optional) You can set more configuration values. For more information, see the Configuration values on GitHub.

  9. Restart the app service.