Pre-checks

A list of pre-checks for the user to complete before installing the .NET zero-code instrumentation agent.

Before installing the .NET zero-code instrumentation agent, complete the following pre-checks.

Verify platform compatibility

Make sure that your platform is compatible with the OpenTelemetry Collector. See the following table for action items corresponding to your platform:

Platform

Pre-checks

All platforms

Kubernetes

  • Verify that you are using a supported Kubernetes distribution. See Supported Kubernetes distributions.

  • Review the prerequisites and requirements for installing the instrumentation using the Helm chart. See Auto-instrumentation in the Splunk OpenTelemetry Collector for Kubernetes repository on GitHub.

Verify .NET runtime compatibility

Verify that you are using a supported version of .NET. See Ensure you are using supported .NET versions.

Verify automatic discovery compatibility

Make sure that your platform is compatible with automatic discovery. See the following table for details:

Platform

Pre-check

Kubernetes

Verify automatic discovery compatibility for Kubernetes. See Automatic discovery and configuration for back-end applications in Kubernetes.

Linux

Verify automatic discovery compatibility for Linux. See Zero-code instrumentation for back-end applications in Linux.

Windows

Verify automatic discovery compatibility for Windows. See Zero-code instrumentation for back-end applications in Windows.

Review core dependencies

Make sure that your application’s dependencies are compatible with the .NET instrumentation.

  1. Verify whether your target applications have the same dependencies as the zero-code instrumentation. See OpenTelemetry.AutoInstrumentation and OpenTelemetry.AutoInstrumentation.AdditionalDeps . If there are conflicts, consider installing using the NuGet packages. Otherwise, you must resolve all the dependencies before manually installing the instrumentation.

  2. Verify whether your target applications have the same dependencies as the NuGet packages. See the NuGet dependencies in the NuGet documentation. If there are conflicts, you must resolve them before installing the instrumentation using the NuGet packages.

Review supported libraries

Make sure that your target application uses supported libraries. Complete the following steps:

  1. Review the list of automatically instrumented libraries supported by the Splunk distribution of the OpenTelemetry .NET instrumentation. See Supported libraries.

  2. Review the community-supported extended list of automatically instrumented libraries in the OpenTelemetry Ecosystem. See the OpenTelemetry Registry .

Verify networking requirements

Verify that your platform is configured according to the following networking requirements:

Platform

Pre-check

All platforms

Verify that your firewall rules allow for communication with the elected Splunk Observability Cloud instance.

Kubernetes

Verify that the manager nodes have access to worker nodes on port 9443/tcp.