IBM Support

MustGather: Instana .NET Tracer - Docker

Troubleshooting


Problem

This guide provides essential steps for collecting data related to Instana .NET Tracer on Docker. 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 Tracer on Docker
 
Monitored environment details:
 
  • Environment information
    • Platform details (Kubernetes based services, DC/OS etc)
    • Check the Linux version, if agent is installed in Linux host
    • Docker daemon health
    • Docker version
     

Application Details:

  • .NET Core version
  • Application type (Web application, Windows service, etc.) 
  • If this is an issue with the OTLP exporter:
    • Instana.OpenTelemetry.Otlp.Exporter package version
    • Instana OTLP Exporter configuration options details
 
Agent information:
 
  • Instana agent type (Static or Dynamic)
  • Installation path of the Instana agent
  • Collect instana-agent-dir/etc/instana/configuration.yaml
  • Collect the Instana agent log:
    • If the instana agent is installed on the host system, please follow the MustGather page for more details
    • If the Instana Agent is installed on Docker container, collect the docker logs for the container
 
Debug logs & Error messages:
 
  • To collect the .NET Tracer logs and CLR Debug logs it is recommended to use a Docker Bind Mount with an existing host path
    • Ensure that you have a valid host path with write permissions for the container
    • Run your docker container with the Bind Mount and the .Net tracer and CLR Debug log path environment variables pointed to the mapped path
      • Here's an example for a webapi application logging to the bind mount configured with host path: /var/log/instana
        • docker run -d \ 
          	   -p 8080:8080 \ 
          	   -v /var/log/instana:/var/tmp \ 
          	   --env=INSTANA_CLRLOG_PATH="/var/tmp/clr_" \ 
          	   --env=INSTANA_NET_LOG_PATH="/var/tmp" \ 
          	   --name simpleapinet8 \ 
          	   myuser/simpleapinet8:v2.0
 
Additional information to collect:
 
  • When did the issue start?
  • Steps to reproduce the problem
  • Expected vs. actual behavior
  • Impact on your application or monitoring

 

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

Document Information

Modified date:
05 April 2026

UID

ibm17249947