Troubleshooting
Problem
This guide provides essential steps for collecting data related to Instana GenAI Observability. 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 GenAI Observarbility
Monitored environment details:
- Kind of deployment (Single host , Kubernetes, etc.)
- OS (Linux/ Windows/Mac, etc.) and version
- Websphere Liberty version
- Java version and vendor
java -version
Agent logs:
- Collect the Instana agent debug log:
- See the MustGather page for Instana Agent for more details
Agent configuration:
- Type of agent (Dynamic or Static)
- Collect <instana-agent-dir>/etc/instana/configuration.yaml
Additional output & files to collect:
- GenAPI Application details:
- Python version used to run the application:
python3 -version
- Collect environment variables defined where the GenAI app with Traceloop is running:
printenv
- Provide a list of all installed Python packages and versions in the python virtual environment where user is trying to run the application:
pip freeze>packages.txt
- Provide the complete console log of the application
- Provide the Traceloop instrumentation steps used in the GenAI application
- For GPU monitoring, collect logs of the OTEL collector that is used to forward the GPU data to instana
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:
30 October 2025
UID
ibm17249213