IBM Support

MustGather: Instana Self-Hosted Synthetic PoP

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:
 
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 
  • 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
         

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"}]

Document Information

Modified date:
29 October 2025

UID

ibm17249207