IBM Support

MustGather: Instana .NET/.NET Core Tracer - Kubernetes

Troubleshooting


Problem

This guide provides essential steps for collecting data related to Instana .NET/.NET Core Tracer - Kubernetes. 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 Tracer - Kubernetes

Monitored environment details:
 
  • Kubernetes Environment Information:
    • Kubernetes version
    • Container runtime (Docker, containerd, etc.)
    • Cluster type (managed service like EKS, AKS, GKE, or self-hosted)

 

Application Details:

  • .NET Core version
  • Application type (Web API, gRPC service, etc.)
  • Container image details (base image, Dockerfile)
  • Deployment configuration (YAML files)
  • 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 configuration/logs:
 
  • Collect the Instana agent configuration and debug logs:
    • See the MustGather page for Instana Agent for more details
 
Debug logs & error messages:
 
  • Run the target application with debug enabled (INSTANA_DEBUG='true')
    • Example to enable:
      • kubectl -n <app-namespace> set env deployment/<app-namespace>set env deployment/<dotnet-app-deployment> 
INSTANA_NET_LOG_PATH=/tmp/instana \
INSTANA_NET_LOG_LEVEL=DEBUG \
INSTANA_NET_CORE_LOG_LEVEL=DEBUG \
INSTANA_TRACER_ENTEREXIT_LOGGING=true
    • Example to disable (debug mode needs to be disabled after capturing mustgather to avoid disk storage fill up):
      • kubectl -n <app-namespace> set env deployment/<app-namespace>set env deployment/<dotnet-app-deployment> 
INSTANA_NET_LOG_PATH- \ 
INSTANA_NET_LOG_LEVEL- \ 
INSTANA_NET_CORE_LOG_LEVEL- \ 
INSTANA_TRACER_ENTEREXIT_LOGGING-
  • Target application logs:
    • Kubernetes: pod logs
    • Docker: container logs
  • Autotrace webhook pod log and webhook configuration. For more information, please see the Autotrace Webhook MG doc
  • Share stack traces, initialization errors, or warnings related to Instana.

  • Include the full error message (not just a snippet)

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"}]

Document Information

Modified date:
13 May 2026

UID

ibm17247746

Page Feedback