IBM Support

MustGather: Instana IBM i Sensor

Troubleshooting


Problem

This guide provides essential steps for collecting data related to Instana IBM i Sensor. 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 IBM i Sensor

Monitored environment details:
 
  • IBM i System Information:
    • Which IBM i OS version is running?
      • SELECT OS_VERSION, OS_RELEASE FROM SYSIBMADM.ENV_SYS_INFO
    • What is the current PTF Group level installed?
      • SELECT MAX(PTF_GROUP_LEVEL) as
PTF_GROUP_LEVEL
FROM QSYS2.GROUP_PTF_INFO
WHERE PTF_GROUP_NAME = 'XXX'
AND PTF_GROUP_STATUS = 'INSTALLED’;
        • NOTE: PTF_GROUP_NAME value will be dependent on the OS Version:
          • OS Version 7.2: SF99702
            OS Version 7.3: SF99703
            OS Version 7.4: SF99704
            OS Version 7.5: SF99950
  • System Resources:
    • CPU and Memory configuration
      • SELECT 
  TOTAL_CPUS, 
  CONFIGURED_CPUS, 
  TOTAL_MEMORY, 
  CONFIGURED_MEMORY 
FROM SYSIBMADM.ENV_SYS_INFO;
    • Current system status
      • SELECT TOTAL_JOBS_IN_SYSTEM, ACTIVE_JOBS_IN_SYSTEM, AVERAGE_CPU_UTILIZATION, SYSTEM_ASP_USED FROM TABLE(QSYS2.SYSTEM_STATUS())
 
Agent logs:
 
  • Collect debug log of Instana agent:
    • See the MustGather page for Instana Agent for more details
 
Agent configuration:
 
  • Collect <instana-agent-dir>/etc/instana/configuration.yaml file 
 
Additional output & files to collect:
 
  • Db2 for i Information (if Db2 monitoring is enabled):
    • Is Db2 for i available and accessible?
    • What version of Db2 for i is running?
  • Available System Services:
    • SELECT SERVICE_SCHEMA_NAME, SERVICE_NAME FROM QSYS2.SERVICES_INFO

Related Information

Instana IBM i Troubleshooting

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;1.0.308;1.0.309;1.0.310"}]

Document Information

Modified date:
02 December 2025

UID

ibm17253365

Page Feedback