Configuring additional IBM MQ settings

Configure additional settings to collect specific IBM MQ queue metrics, queue statistics metrics, queue manager performance events, or channel events.

To collect specific IBM MQ metrics, complete the following steps:

1. To collect the queue metrics Last Put Time, Last Get Time, Oldest Message Time, and On Queue Message Time, enable queue statistic at either the queue level or the queue manager level.

   • At the queue level, run the following RUNMQSC command:

     alter ql(QUEUE_NAME) MONQ(LOW)
      

   • At the queue manager level, run the following RUNMQSC command:

     alter qmgr MONQ(LOW)
      

   For more information about the alter qmgr command, see IBM MQ documents.

2. To collect the IBM MQ performance built-in events, such as Queue Depth High, Queue Full, and Queue Service Interval High, enable the queue manager performance events (PERFMEV) by running the following RUNMQSC command:

   alter qmgr PERFMEV(ENABLED) CHLEV(ENABLED)
    

   • To collect built-in events that are related to queue manager, such as Alias Base Queue Type Error, Default Transmission Queue Type Error, Default Transmission Queue Usage Error, Get Inhibited, Not Authorized, Put Inhibited, Queue Manager Not Active, Queue Type Error, Remote Queue Name Error, Transmission Queue Type Error, Transmission Queue Usage Error, Unknown Alias Base Queue, Unknown Default Transmission Queue, Unknown Object Name, Unknown Remote Queue Manager, and Unknown Transmission Queue, enable the following channel events (CHLEV) events:

     • AUTHOREV (Authorization events)
     • INHIBTEV (Inhibition events)
     • LOCALEV (Local events)
     • REMOTEEV (Remote events)
     • STRSTPEV (Storage events)

     Run the following RUNMQSC command:

     alter qmgr AUTHOREV(ENABLED) INHIBTEV(ENABLED) LOCALEV(ENABLED) REMOTEEV(ENABLED) STRSTPEV(ENABLED)
      

     For more information about controlling queue manager events, see Controlling queue manager events.

   • To collect built-in events that are related to channel, such as Bridge stopped, Channel Auto-definition Error, Channel Blocked, Channel Conversion Error, Channel Not Activated, Channel Not Available, Channel SSL Error, Channel SSL Warning, Channel Stopped, and Channel Stopped By User, enable the following channel-related events (CHLEV) events:

     • CHLEV (Channel events)
     • BRIDGEEV (Bridge events)
     • SSLEV (SSL events)
     • CHADEV (Channel auto-definition events)

     Run the following RUNMQSC command:

     alter qmgr CHLEV(ENABLED) BRIDGEEV(ENABLED) SSLEV(ENABLED) CHADEV(ENABLED)
      

     For more information about controlling channel events, see Controlling channel and bridge events.

   For more information about the alter qmgr command, see IBM MQ documents.

3. To collect IBM MQ queue statistics metrics, such as Persistent Put Bytes, Nonpersistent Put Bytes, Persistent Get Bytes, Nonpersistent Get Bytes, Expired Msg Count, Put Fail Count, Put1 Fail Count, and Get Fail Count, complete the following steps in IBM MQ:

   1. At the queue manager level, enable queues statistics data collection for all queues by running the following command:

      alter qmgr STATQ(ON)
       

      At the queue level, enable statistics for a specific queue by running the following Queue_Name command:

      alter qlocal(Queue_Name) STATQ(ON)
       

      You can also change the queue statistics interval by using the IBM MQ queue manager parameter STATINT, which is 1800 seconds by default. For example, to set it to 900 seconds, run the following command:

      alter qmgr STATINT(900)
       

   2. To collect statistics data from the SYSTEM.ADMIN.STATISTICS.QUEUE, grant the get authority to the Instana agent user because the statistics data is collected from this queue.

      For example, run the following command:

      setmqaut -m QmgrName -n SYSTEM.ADMIN.STATISTICS.QUEUE -t q -p user +get
       

      For more information about the setmqaut command, see IBM MQ documents.

4. To collect the MQI failure percentage, complete the following steps in IBM MQ:

   1. At the queue manager level, enable Message Queue Interface (MQI) statistics data collection with a collection interval by running the following command:

      alter qmgr STATMQI(ON)
       

   2. To collect statistics data from the SYSTEM.ADMIN.STATISTICS.QUEUE, grant the get authority to the Instana agent user by running the following command:

      setmqaut -m QmgrName -n SYSTEM.ADMIN.STATISTICS.QUEUE -t q -p user +get
       

      For more information about the setmqaut command, see IBM MQ documents.