Troubleshooting
Problem
This guide provides essential steps for collecting data related to Instana .NET/.NET Core on Azure. Before contacting IBM® support for assistance, please review the information below to familiarize yourself with the troubleshooting process.
Resolving The Problem
To explore potential solutions, refer to IBM Instana documentation, search for known issues, or consult forums. If you are aware of the affected component, refer to the relevant MustGather details below:
MustGather Data Collection Requirements for Instana .NET/.NET Core on Azure
Monitored environment details:
- Azure Environment information
- Azure service type (App Service, Function App, Container App)
- Azure region
- Azure resource group name (if applicable for your issue)
Application details
- .NET Framework version or .NET Core version
- Application type (Web API, Azure Function, etc.)
- Deployment method (direct deploy, container, CI/CD pipeline)
- If this is an issue with the OTLP exporter, please include the following information:
- Instana.OpenTelemetry.Otlp.Exporter package version
- Instana OTLP Exporter configuration options details
Agent information:
- Instana agent version
- Instana enpoint URL
- Installation method used for the instana agent
Diagnostic information:
To troubleshoot .NET applications on Azure, enable detailed logging by configuring environment variables such as INSTANA_DEBUG_TRACER, INSTANA_LOG_SPANS, and INSTANA_CLRLOG_PATH in your Azure service settings
Additional information to collect:
- Issue timeline: When the problem started, whether it's a new installation or previously worked, any recent changes, and if the issue is consistent or intermittent
- Reproduction steps: How to trigger the issue, including specific endpoints or operations
- Expected vs. actual behavior: What should happen versus what's happening, including error messages and screenshots
- Business impact: How this affects your application, percentage of services impacted, and any workarounds in place
Document Location
Worldwide
[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSE1JP5","label":"IBM Instana Observability"},"ARM Category":[{"code":"a8mgJ00000005VxQAI","label":"Tracers"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.0.281;1.0.282;1.0.283;1.0.284;1.0.285;1.0.286;1.0.287;1.0.288;1.0.289;1.0.290;1.0.291;1.0.292;1.0.293;1.0.294;1.0.295;1.0.296;1.0.297;1.0.298;1.0.299;1.0.300;1.0.301;1.0.302;1.0.303;1.0.304;1.0.305;1.0.306;1.0.307;1.0.308"}]
Was this topic helpful?
Document Information
Modified date:
05 April 2026
UID
ibm17249945