Troubleshooting
Problem
This guide provides essential steps for collecting data related to Instana Go tracer. 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 GO Tracer
Monitored environment details:
- Kind of deployment (Single host , Kubernetes, docker, podman, AWS Fargate)
- OS (Linux/ Windows) and version
- Go runtime version
Instana Go Tracer SDK version:
- Collect the version of the Go Tracer SDK used for instrumentation either from the Instana dashboard under the field "Instana sensor version" or from the go.mod file
- Collect the name and version details of the Go Tracer instrumentation libraries used in this particular project from the go.mod file
Debug logs:
- Debug logs are crucial for analyzing the issue. To retrieve the debug logs, enable the environment variable INSTANA_DEBUG and collect the log information from the console output.
Agent logs:
- Collect the Instana agent debug log:
- See the MustGather page for Instana Agent for more details
Agent configuration:
- Collect <instana-agent-dir>/etc/instana/configuration.yaml
Additional output & files to collect:
- SaaS url details:
- If the monitored service is using a serverless acceptor to receive trace data, the SaaS URL can be obtained from the INSTANA_ENDPOINT_URL environment variable.
- Root exit span environment variable status:
- When instrumenting EXIT spans as root spans, enable the environment variable INSTANA_ALLOW_ROOT_EXIT_SPAN to capture trace data.
Document Location
Worldwide
[{"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"}],"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.307","Type":"MASTER"}]
Was this topic helpful?
Document Information
Modified date:
21 September 2025
UID
ibm17245670