Troubleshooting
Problem
This guide provides essential steps for collecting data related to Instana Envoy proxy Sensor/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 Envoy proxy Sensor/Tracer
Monitored environment details:
- Kind of deployment (Single host , Kubernetes, docker, podman, AWS Fargate)
- OS (Linux/ Windows) and version
- SaaS url of the agent monitoring the Envoy proxy
- Envoy Proxy version
-
envoy --version
-
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:
- Envoy Configuration file:
- The file "envoy.yaml" which is used in the command to start the Envoy proxy
- 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.
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":"a8m3p000000UoUBAA0","label":"Sensors - Setup \u0026 Discovery"}],"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"}]
Was this topic helpful?
Document Information
Modified date:
07 October 2025
UID
ibm17247172