IBM Support

MustGather: Instana .NET Tracer - z/OS

Troubleshooting


Problem

This guide provides essential steps for collecting data related to Instana .NET Tracer - z/OS. Before contacting IBM® support for assistance, please review the information below to familiarize yourself with the troubleshooting process.

Note: On z/OS, tracing is only possible through manual instrumentation using Instana SDK or OpenTelemetry SDK. Auto instrumentation is not supported.

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 - z/OS

Monitored environment details:
 
  • z/OS Architecture, Platform version
  • Any recent updates or patches installed?
 
Application details:
 
  • .NET version
  • SDKs used and their versions (Instana SDK or OpenTelemetry SDK)
  • Application type (Web application, Web APIs, Service, etc.)
  • Application hosting environments (Web hosted, Application hosted, container-hosted, etc.)
  • 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:
 
  • Instana agent type (Static or Dynamic)
  • Installation path of the instana agent
  • Collect <instana-agent-dir>/etc/instana/configuration.yaml 
 
Debug logs & Error messages:
 
  • Instana Agent logs
  • .NET Tracer logs (with prefix="instanaTraces")
  • Application 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":"SSO4JPD","label":"IBM Instana Observability SaaS"},"ARM Category":[{"code":"a8mgJ00000005VxQAI","label":"Tracers"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":""}]

Document Information

Modified date:
12 April 2026

UID

ibm17267955

Page Feedback