Pre-checks π
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 .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.
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.
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:
Review the list of automatically instrumented libraries supported by the Splunk distribution of the OpenTelemetry .NET instrumentation. See Supported libraries.
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 |