Troubleshooting
Problem
This guide provides essential steps for collecting data related to Instana Self-Hosted Synthetic PoP. 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. For 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:
If you are aware of the affected component, refer to the relevant MustGather details below:
MustGather Data Collection Requirements for Instana Self-Hosted Synthetic PoP
Monitored environment details:
- Kubernetes version
- Helm chart version
helm list -n <namespace>
Additional output & files to collect:
- Run the pdcollect.sh script and upload the output to the support case
- For additional information, please follow the instructions
- To increase log level to debug (if needed):
- If the initial pdcollect.sh output does not provide enough information for analysis, you may be asked to increase the log level, reproduce the issue, and run pdcollect.sh again.
- To change the trace level of each component, you can pass the traceLevel values via helm as follows to make an upgrade on your PoP:
--set controller.traceLevel="DEBUG" \ --set http.traceLevel="DEBUG" \ --set javascript.traceLevel="DEBUG" \ --set browserscript.traceLevel="DEBUG" \ --set ism.traceLevel="DEBUG" \ --set redis.traceLevel="DEBUG"
- You can also dynamically change the trace level of PoP controller without restarting the pod by running the set_trace_level.sh command in the container.
- Exec into the synthetic-pop-controller pod
kubectl exec -it -n <namespace> <pop_controller_pod_name> -- bash
- run set_trace_level.sh command to change trace level to DEBUG
./set_trace_level.sh DEBUG
- Exec into the synthetic-pop-controller pod
- Capture Synthetic Locations page and Synthetic PoP health page screenshots
- In addition to collecting logs using pdcollect.sh, capture screenshots of the Synthetic Locations page and the PoP health page
- Login to Instana UI
- Go to Synthetic monitoring
- Click on Locations tab
- Capture a screenshot
- If the Location name is clickable, click on the Location name, capture a screenshot of the PoP health page
- In addition to collecting logs using pdcollect.sh, capture screenshots of the Synthetic Locations page and the PoP health page
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":"a8mKe000000XZQ5IAO","label":"MustGather"}],"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"}]
Was this topic helpful?
Document Information
Modified date:
29 October 2025
UID
ibm17249207