Monitoring IBM i 實例

支援的版本

支援的 IBM i 平台包括: 7.2 (層次 11 或更新版本)、 7.3、 7.4及 7.5。

附註: 目前，我們僅支援遠端監視 IBM i 實例。 如需個別度量可用性的相關資訊，請參閱 本文件。

配置

若要開始監視 IBM i 實例，您需要在代理程式配置檔 <agent_install_dir>/etc/instana/configuration.yaml中配置下列欄位:

附註: 在使用者配置參數內指定的使用者必須具有 *SECOFR 權限。 對於不同的使用者類別 (例如 *USER) ，請提供在 使用者許可權 區段中提供的許可權。

com.instana.plugin.ibmiseries:
  enabled: true
  remote: # multiple configurations supported
    - host: 'remote.host-2.com'
      user: 'username'
      password: 'password'
      availabilityZone: 'IBM i Remote Monitoring'
      poll_rate_configuration: #Values are in seconds.
        os_poll_rate: 15 #This is default OS poll rate. Provide the values in seconds.
        db2_poll_rate: 15 #This is default DB2 poll rate. Provide the values in seconds.
        disabled_components:
          components: '<Names of the components or grids to be disabled>' # Use comma (,) to separate them. Example - 'HISTORY_LOGS, JOB_QUEUES'.
        custom_poll_rate: #Multiple Poll Rate is supported. (Optional)
          poll_rate_1:
            polling_rate: 'Custom Poll Rate value' #Values in seconds. Example- 30
            components: 'Components/Grid Names in comma(,) separated way' #Refer documentation for components name.
            events: 'Names of the events in comma(,) separated way' #Refer documentation for events name.
          poll_rate_2:
            polling_rate: 'Custom Poll Rate value' #Values in seconds. Example- 60
            components: 'Components/Grid Names in comma(,) separated way' #Refer documentation for components name.
            events: 'Names of the events in comma(,) separated way' #Refer documentation for events name.
      user_specification: # For user inputs (Optional)
        activeJobs:
          jobs: 'comma separated list of job names' # example - '100345/QUSER/QZDASOINIT,QLWISVR/ADMIN2'
          event:
            identicalJobs:
              jobName/user: 'Provide JOB_NAME_SHORT/JOB_USER values in comma(,) separated way. Use * in user part as wild card character' # example - 'CT_AGENT/QAUTOMON,QZDASOINIT/*'
              threshold: 5 # Event will be triggered if jobs with same name & user in the running status is less than threshold value.
            runningStatus: 'Provide JobStatus/Subsystem values in comma(,) separated way. You can Use * in subsystem part as wild card' # example - 'SIGW/QHTTPSVR,DSC/*,DEQW/QAUTOMON'
            inactiveJobs:  'Provide JOB_NAME in comma(,) separated way'  # example - '141714/QSYS/QAUTOMON , 137640/QSYS/QBATCH'
            enableInactiveJOBQStatus: #Allowed value 'true' or 'false'. Alert will be triggered for the inactive jobs if JOB_QUEUE_STATUS is 'RELEASED' or 'SCHEDULED' and JOB_STATUS is 'OUTQ'.
        messageQueue:
          filter: # User defined filter for Message Queue table
            library/queueName: 'Lib-1/queueName1,Lib-2/queueName2'  ## Provide values in comma(,) separated way. (Default Value : 'QSYS/QSYSOPR')
            timeFrame: '10 HOURS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
          event: # User defined Event for Message Queue
            messageQueueIdEvent:
              Lib-1/queueName1: ## example:  QSYS/QSYSOPR
                Event_Name_1 : 'messageId-1,messageId-2'  ##Example: Hyper Swap Alerts : 'CPC1E1D, CPI1E23'
                Event_Name_2 : 'messageId-3,messageId-4'  ##Example: Error in Device BackUp: 'CPI1E92, AMQ89*'. You can provide * in case you want to provide partial message id
              Lib-2/queueName2:
                Event_Name_3 : 'messageId-5'              ## You can provide the Event_Name as per relevance
            timeFrame: '15 MINUTES'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
            messageQueueTextEvent:
              Lib-1/queueName1: ## example:  QSYS/QSYSOPR
                Event_Name_1 : 'Provide fully or partial message text' ## example: Clean up : 'messages deleted'
                Event_Name_2 : 'Provide fully or partial message text' ## example: IBM MQ Issue : 'Queued Publish/Subscribe Daemon'
              Lib-2/queueName2:
                Event_Name_3 : 'Provide fully or partial message text' ## You can provide the Event_Name as per relevance
            timeFrameText: '15 MINUTES'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
        historyLog:
          filter:
            timeFrame: '1 DAYS'  ## Format is : {value} MINUTES / HOURS / DAYS (Default Value : '10 MINUTES')
        subsystem:
          subsystem_list: 'Provide SUBSYSTEM_DESCRIPTION_LIBRARY/SUBSYSTEM_DESCRIPTION in comma(,) separated way'   # example -'QDEVELOP/RATS,QINMEDIA/QBASE'
        netstatEventInfo:
          port/address: 'Provide LOCAL_PORT/LOCAL_ADDRESS in comma(,) separated way. You can use * in LOCAL_ADDRESS as wild card.'  #example- '427/9.5.105.61, 38695/*, 8475/9.5.151.81' [Alert will be triggered if TCP state is not LISTEN or Null]

JDBC 連線埠

IBM i 的 Instana 遠端感應器使用遠端 JDBC 連線及 Java Toolkit 遠端連線。 這些連線使用下列埠:

預設輪詢率

使用者許可權

您需要將下列權限授與 Instana 使用的 IBM i 使用者帳戶:

• 檢查效能資料收集 (CHKPFRCOL)
• 工作控制 (*JOBCTL)
• 使用暫時修正程式群組 (WRKPTFGRP)

度量值集合

若要檢視度量值，請在「Instana 使用者」介面的資訊看板中選取 基礎架構 ，按一下特定的受監視主機，然後您可以看到包含所有已收集度量值及受監視處理程序的主機儀表板。

messageQueueIDEvent:
    QSYS/QSYSOPR
        Hyper Swap Alerts : 'CPC1E1D, CPI1E23'

messageQueueTextEvent:
    QSYS/QSYSOPR
        IBM MQ Issue : 'queue disconnected'