IBM Support

MustGather: Instana .NET Tracer - Linux

Troubleshooting


Problem

This guide provides essential steps for collecting data related to Instana .NET Tracer - Linux. 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, search for issues, access documentation, or visit support forums, head to the IBM® Support page. If you are aware of the affected component, refer to the relevant MustGather details below:
 
MustGather Data Collection Requirements for Instana .NET Tracer - Linux

Monitored environment details:
 
  • Linux version and build number
  • Any recent updates or patches installed?
 
Application details:
 
  • .NET Framework or .NET Core version
  • Application type (Web application, service, etc.)
  • Application hosting environments (Web hosted, Application hosted, container-hosted etc)
  • If this is an issue with the OTLP exporter:
    • Instana.OpenTelemetry.Otlp.Exporter package version
    • Instana OTLP Exporter configuration options details
 
Agent configuration:
 
  • Instana agent type (Static or Dynamic)
  • Installation path of the instana agent
  • Collect <instana-agent-dir>/etc/instana/configuration.yaml 
 
Debug logs & Error messages:
 
Important: The LogCollector button has no functionality from NET Core Sensor version 1.0.89 onwards. If you are using the latest versions of the .NET Core Sensor to collect logs with this tool, please run it manually from the following path: .../instana-agent/data/repo/com/instana/logcollector-util/logcollector.exe
 
  • To collect .NET logs using the LogCollector, follow the steps highlighted in this document using the dedicated buttons on the .NET Process Dashboard
    • The LogCollector tool gathers the following information:
      • Instana Agent logs
      • .NET Tracer logs
      • CLR Profiler logs
 
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"}]

Document Information

Modified date:
15 June 2026

UID

ibm17247731