IBM i インスタンスのモニタリング

Instana ホストエージェントをインストールすると、 IBM i インスタンスセンサーが自動的にインストールされます。

設定 」セクションの手順に従って監視用のセンサーを設定すると、 Instana のUIで IBM i に関連するメトリクスを確認できるようになります。

Instana IBM i インスタンスのリモート監視とローカル監視の両方をサポートしています。 個々のメトリクスの利用状況に関する詳細については、 IBM i サービスをご覧ください。 IBM i のホストエージェントをインストールするには、 IBM i の「ホストエージェントのインストール」 を参照してください。

サポート情報

IBM i センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください:

対応バージョンとサポート方針

このセンサーは、 IBM i 7.4 以降のバージョンのローカル監視に対応しています。

このセンサーは、 IBM i 7.3 以降のバージョンのリモート監視に対応しています。

以下の表は、最新のサポート対象バージョンとサポート方針を示しています:

テクノロジー サポート・ポリシー 最新技術バージョン サポートされる最新バージョン
IBM i インスタンス 45 日間 7.6.0 7.6.0

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

の構成

ローカル監視の設定

IBM i をローカルで監視するには、まず IBM i に Instana ホストエージェントをインストールする必要があります。 詳細については、 「 IBM i へのホストエージェントのインストール 」を参照してください。

ホストエージェントをインストールして実行すると、エージェントは自動的にプロセスを検出し、デフォルト設定でセンサーを起動します。 ホストエージェントの設定に関する詳細については、 「ホストエージェントの設定」 を参照してください。

ローカル・モニタリングの設定例を以下に示す:

注: この構成はオプションです。 カスタム・イベントとカスタム・ポーリングを活用するには、以下の設定を有効にしてください。
com.instana.plugin.ibmiseries:
  enabled: true
  local: # Single configuration only
    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/Grids to be disabled in comma(,) separated way' # 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. You can use * as a wild card character in any part of the job name' # example - '*/QUSER/QZDASOINIT, 311353/QLWISVR/ADMIN, 10034*/QUSER/*'
        rowLimit: 20 # Maximum number of rows to fetch from active jobs query. Default value is 20
        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. You can use * as wild card character in any part of the JOB_NAME'  # example - '*/QSYS/QAUTOMON , 137640/QSYS/QBATCH , */QWEBADMIN/* , */QSYS/QAUTO*'
          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 'JOBQ'.
      auditJournal:
        overall:
          timeframe: '24 HOURS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
        event:
          AF:
            timeframe: '1 DAYS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
            event_name:  ## Provide the event_name as per relevance. Example: User Authority failure. (Mandatory)
              violationType: 'Violation Type(s)' ## Provide violation types in comma (,) separated way. Example - 'A, K'. (Optional)
              qualifiedJobName: 'Qualified Job Name(s)' ## Provide qualified job names in comma (,) separated way and * as a wildcard. Example - '*/QUSER/QZDASOINIT, */QUSER/*' (Optional)
              objectLib/Name: 'ObjectLibrary/ObjectName' ## Provide ObjectLibrary/ObjectName pairs in comma (,) separated way and * as a wildcard. Example - 'QSYS/QAUDJRN, QSYS/*' (Optional)
              objectType: 'ObjectType' ## Provide object types in comma (,) separated way. Example - '*JRN, *DIR'. (Optional)
              userProfileName: 'User Profile Name' ## Provide user profile names in comma (,) separated way and * as a wildcard. Example - 'Stan, Inst* (Optional)
              threshold: 1 # Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
          CA:
            timeframe : '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
            event_name: ## Provide the event_name as per relevance. Example: Authority Change Alert. (Mandatory)
              objectLib/Name: 'ObjectLibrary/ObjectName' ## Provide ObjectLibrary/ObjectName pairs in comma separated way and * as a wildcard. e.g. 'QSYS/QAUDJRN, QSYS/*' (Optional)
              objectType: 'ObjectType' ## Provide object types in comma separated way e.g. '*JRN, *DIR'. (Optional)
              userProfileName: 'User Profile Name' ## Provide user profile names in comma separated way and * as a wildcard. e.g. 'Stan, Inst* (Optional)
              objectAuthority: '' ## Provide any of the following object authorities in a comma separated way: EXCLUDE, OPR, MGT, EXIST, ALTER, REF (Optional)
              dataAuthority: '' ## Provide any of the following data authorities in a comma separated way: READ, ADD, UPD, DLT, EXECUTE (Optional)
              commandType: '' ## Provide any of the following command types in a comma separated way: GRANT, GRTUSRAUT, REPLACE, REVOKE (Optional)
              threshold: 1 ## Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
          PW:
            timeframe: '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
            event_name: ## Provide the event_name as per relevance. Example: Password Change Alert. (Mandatory)
              violationType: 'Violation Type(s)' ## Provide violation types in comma separated way e.g. 'A, K' .(Optional)
              auditUsername: 'Audit Username' ## Provide audit usernames in comma separated way and * as a wildcard. e.g. 'Stan, Inst* (Optional)
              threshold: 1 # Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
          CP:
            timeframe: '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
            event_name: ## Provide the event_name as per relevance. Example: User Profile Change Alert. (Mandatory)
              userProfile: 'User Profile Name' ## Provide user profile names in comma separated way and * as a wildcard. e.g. 'ADMIN*, USER01' (Optional)
              changedAuthority: 'Changed Authority' ## Provide authorities in comma separated way e.g. 'ALLOBJ, JOBCTL, SECADM'. (Optional)
              passwordChanged: 'YES/NO' ## Specify if password was changed. Values: 'YES' or 'NO'. (Optional)
              passwordExpired: 'YES/NO' ## Specify if password was expired. Values: 'YES' or 'NO'. (Optional)
              commandType: 'Command Type' ## Provide command types in comma separated way e.g. 'CRT, CHG, RST'. (Optional)
              threshold: 1 ## Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
          OW:
            timeframe: '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
            event_name: ## Provide the event_name as per relevance. Example: User Profile Change Alert. (Mandatory)
              objectLib/Name: 'ObjectLibrary/ObjectName' ## Provide ObjectLibrary/ObjectName pairs in comma separated way and * as a wildcard. e.g. 'QSYS/QAUDJRN, QSYS/*' (Optional)
              objectType: 'ObjectType' ## Provide object types in comma separated way e.g. '*JRN, *DIR'. (Optional)
              previousOwner: "Previous Owner"  # Provide previous owners in comma separated way and * as a wildcard to monitor e.g. 'OLDADMIN, SYSADMIN'
              newOwner: "New Owner"  # Provide previous owners in comma separated way and * as a wildcard to monitor e.g. NEWADMIN, USER*
              threshold: 1 ## Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
      diskStatus:
        operationalState: 'State of the disk which is expected, in comma(,) separated way' #Example 'ACTIVE, BUSY'
      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:
              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:
              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')
          messageQueueInquiryEvent:
            library/queueName: 'Lib-1/queueName1,Lib-2/queueName2'  ## Provide values in comma(,) separated way. (Default Value : None)
            timeWithoutReply: '10 HOURS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
          messageQueueEvent:
            Lib-1/queueName1: ## Provide either library/queueName or just queueName. Example: QSYS/QSYSOPR or QSYSOPR
              Event_name_1 : ## Provide the Event_name as per relevance. Example: Hyper Swap Alerts.  (Mandatory)
                messageType: 'messageType-1,messageType-2' ## Provide message types in comma(,) separated way e.g: 'DIAGNOSTIC,INQUIRY'. (Optional)
                severity: 'severity' ## Provide a severity value or range and comparison operator. e.g: '>=30' or '>=30 AND <90'. (Optional)
                messageIdsInclude: 'messageId-1,messageId-2' ## Message IDs to include for this event. e.g: 'CPC1E*, CPI1E23'. (Optional)
                messageIdsExclude: 'messageId-3,messageId-4' ## Message IDs to exclude from this event e.g: 'CPI1E92, AMQ89*'. (Optional)
                messageText: 'Provide full or partial message text' ## Message text to match within the message. (Optional)
            Lib-2/queueName2: ## Provide either library/queueName or just queueName. Example: QSYS/QSYSOPR or QSYSOPR
              Event_name_3 : ## Provide the Event_name as per relevance. Example: Hyper Swap Alerts.  (Mandatory)
                messageType: 'messageType-1,messageType-2' ## Provide message types in comma(,) separated way e.g: 'DIAGNOSTIC,INQUIRY'. (Optional)
                severity: 'severity' ## Provide a severity value or range and comparison operator e.g: '>=30' or '>=30 AND <90'. (Optional)
                messageIdsInclude: 'messageId-1,messageId-2' ## Message IDs to include for this event e.g: 'CPC1E*, CPI1E23'. (Optional)
                messageIdsExclude: 'messageId-3,messageId-4' ## Message IDs to exclude from this event e.g: 'CPI1E92, AMQ89*'. (Optional)
                messageText: 'Provide full or partial message text' ## Message text to match within the message. (Optional)
            timeFrame: '10 MINUTES'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
      historyLog:
        rowLimit: 10 # Maximum number of history log entries to fetch per query. Default value is 10
        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. You can use * as wild card'   # example- 'QDEVELOP/RATS, */QBASE, QSYS/Q*'
        rowLimit: 20 # Maximum number of rows to fetch from subsystem query. Default value is 20
      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.51.151.81' [Alert will be triggered if TCP state is not LISTEN or Null]
      portStatusEvent:
        Event_name_1:  # Example:  Application Port Status Check Event
          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.51.151.81'
          tcpState: 'Provide the expected TCP states in comma(,) separated way.'  #example- 'LISTEN, ESTABLISHED'
 

リモート監視の設定

IBM i インスタンスの遠隔監視を開始するには、まずお使いのオペレーティングシステムに合わせて Instana エージェントをインストールする必要があります。 詳細については、 「ホストエージェントのインストール」 を参照してください。 次に、以下のエージェント設定ファイル<agent_install_dir>/etc/instana/configuration.yamlを設定します。

  • 「 Instana 」ユーザープロファイルに必要な権限については、 「ユーザー権限 」のセクションを参照してください。

  • フィールド sslEnabled はオプションです。 これは、ホストコンポーネントと安全な接続を確立したい場合にのみ必要です。

  • sslEnabled に設定されている true場合、keytool コマンドを使用して、信頼済み証明書を JRE の cacerts (jvm/jre/lib/security/cacerts) にインポートする必要があります:

    keytool -import -alias ALIAS_NAME -keystore "/path/to/jre/cacerts" -file
    YOUR_CERTIFICATE_NAME.crt
     
  • パスワードを求められたら、デフォルトのパスワードchangeitを入力してください。

リモート・モニタリングについては、以下の設定例を参照してください:

com.instana.plugin.ibmiseries:
  enabled: true
  remote: # multiple configurations supported
    - host: 'remote.host-2.com'
      #For a SSL connection set sslEnabled to either 'true' or 'false'.
      sslEnabled: true/false
      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. You can use * as a wildcard character in any part of the job name' # example - '*/QUSER/QZDASOINIT, 311353/QLWISVR/ADMIN, 10034*/QUSER/*'
          rowLimit: 20 # Maximum number of rows to fetch from active jobs query. Default value is 20
          event:
            identicalJobs:
              jobName/user: 'Provide JOB_NAME_SHORT/JOB_USER values in comma(,) separated way. Use * in user part as wildcard 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 wildcard' # example - 'SIGW/QHTTPSVR,DSC/*,DEQW/QAUTOMON'
            inactiveJobs:  'Provide JOB_NAME in comma(,) separated way. You can use * as wildcard character in any part of the JOB_NAME'  # example - '*/QSYS/QAUTOMON , 137640/QSYS/QBATCH , */QWEBADMIN/* , */QSYS/QAUTO*'
            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'.
        auditJournal:
          overall:
            timeframe: '24 HOURS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
          event:
            AF:
              timeframe: '1 DAYS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
              event_name:  ## Provide the event_name as per relevance. Example: User Authority failure. (Mandatory)
                violationType: 'Violation Type(s)' ## Provide violation types in comma (,) separated way. Example - 'A, K'. (Optional)
                qualifiedJobName: 'Qualified Job Name(s)' ## Provide qualified job names in comma (,) separated way and * as a wildcard. Example - '*/QUSER/QZDASOINIT, */QUSER/*' (Optional)
                objectLib/Name: 'ObjectLibrary/ObjectName' ## Provide ObjectLibrary/ObjectName pairs in comma (,) separated way and * as a wildcard. Example - 'QSYS/QAUDJRN, QSYS/*' (Optional)              
                objectType: 'ObjectType' ## Provide object types in comma (,) separated way. Example - '*JRN, *DIR'. (Optional)
                userProfileName: 'User Profile Name' ## Provide user profile names in comma (,) separated way and * as a wildcard. Example - 'Stan, Inst* (Optional)
                threshold: 1 # Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
            CA:
              timeframe : '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
              event_name: ## Provide the event_name as per relevance. Example: Authority Change Alert. (Mandatory)
                objectLib/Name: 'ObjectLibrary/ObjectName' ## Provide ObjectLibrary/ObjectName pairs in comma separated way and * as a wildcard. e.g. 'QSYS/QAUDJRN, QSYS/*' (Optional)
                objectType: 'ObjectType' ## Provide object types in comma separated way e.g. '*JRN, *DIR'. (Optional)
                userProfileName: 'User Profile Name' ## Provide user profile names in comma separated way and * as a wildcard. e.g. 'Stan, Inst* (Optional)
                objectAuthority: '' ## Provide any of the following object authorities in a comma separated way: EXCLUDE, OPR, MGT, EXIST, ALTER, REF (Optional)
                dataAuthority: '' ## Provide any of the following data authorities in a comma separated way: READ, ADD, UPD, DLT, EXECUTE (Optional)
                commandType: '' ## Provide any of the following command types in a comma separated way: GRANT, GRTUSRAUT, REPLACE, REVOKE (Optional)
                threshold: 1 ## Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
            PW:
              timeframe: '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
              event_name: ## Provide the event_name as per relevance. Example: Password Change Alert. (Mandatory)
                violationType: 'Violation Type(s)' ## Provide violation types in comma separated way e.g. 'A, K' .(Optional)
                auditUsername: 'Audit Username' ## Provide audit usernames in comma separated way and * as a wildcard. e.g. 'Stan, Inst* (Optional)
                threshold: 1 # Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
            CP:
              timeframe: '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
              event_name: ## Provide the event_name as per relevance. Example: User Profile Change Alert. (Mandatory)
                userProfile: 'User Profile Name' ## Provide user profile names in comma separated way and * as a wildcard. e.g. 'ADMIN*, USER01' (Optional)
                changedAuthority: 'Changed Authority' ## Provide authorities in comma separated way e.g. 'ALLOBJ, JOBCTL, SECADM'. (Optional)
                passwordChanged: 'YES/NO' ## Specify if password was changed. Values: 'YES' or 'NO'. (Optional)
                passwordExpired: 'YES/NO' ## Specify if password was expired. Values: 'YES' or 'NO'. (Optional)
                commandType: 'Command Type' ## Provide command types in comma separated way e.g. 'CRT, CHG, RST'. (Optional)
                threshold: 1 ## Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
            OW:
            timeframe: '24 HOURS' ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '24 HOURS')
            event_name: ## Provide the event_name as per relevance. Example: User Profile Change Alert. (Mandatory)
              objectLib/Name: 'ObjectLibrary/ObjectName' ## Provide ObjectLibrary/ObjectName pairs in comma separated way and * as a wildcard. e.g. 'QSYS/QAUDJRN, QSYS/*' (Optional)
              objectType: 'ObjectType' ## Provide object types in comma separated way e.g. '*JRN, *DIR'. (Optional)
              previousOwner: "Previous Owner"  # Provide previous owners in comma separated way and * as a wildcard to monitor e.g. 'OLDADMIN, SYSADMIN'
              newOwner: ""  # Provide previous owners in comma separated way and * as a wildcard to monitor e.g. NEWADMIN, USER*
              threshold: 1 # Event will be triggered once count is greater than the specified threshold value. Default value is 1. (Optional)
        diskStatus:
          operationalState: 'State of the disk which is expected, in comma(,) separated way' #Example 'ACTIVE, BUSY'
        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')
            messageQueueInquiryEvent:
              library/queueName: 'Lib-1/queueName1,Lib-2/queueName2'  ## Provide values in comma(,) separated way. (Default Value : None)
              timeWithoutReply: '10 HOURS'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
            messageQueueEvent:
              Lib-1/queueName1: ## Provide either library/queueName or just queueName. Example: QSYS/QSYSOPR or QSYSOPR
                Event_name_1 : ## Provide the Event_name as per relevance. Example: Hyper Swap Alerts.  (Mandatory)
                  messageType: 'messageType-1,messageType-2' ## Provide message types in comma(,) separated way e.g: 'DIAGNOSTIC,INQUIRY'. (Optional)
                  severity: 'severity' ## Provide a severity value or range and comparison operator. e.g: '>=30' or '>=30 AND <90'. (Optional)
                  messageIdsInclude: 'messageId-1,messageId-2' ## Message IDs to include for this event. e.g: 'CPC1E*, CPI1E23'. (Optional)
                  messageIdsExclude: 'messageId-3,messageId-4' ## Message IDs to exclude from this event e.g: 'CPI1E92, AMQ89*'. (Optional)
                  messageText: 'Provide full or partial message text' ## Message text to match within the message. (Optional)
              Lib-2/queueName2: ## Provide either library/queueName or just queueName. Example: QSYS/QSYSOPR or QSYSOPR
                Event_name_3 : ## Provide the Event_name as per relevance. Example: Hyper Swap Alerts.  (Mandatory)
                  messageType: 'messageType-1,messageType-2' ## Provide message types in comma(,) separated way e.g: 'DIAGNOSTIC,INQUIRY'. (Optional)
                  severity: 'severity' ## Provide a severity value or range and comparison operator e.g: '>=30' or '>=30 AND <90'. (Optional)
                  messageIdsInclude: 'messageId-1,messageId-2' ## Message IDs to include for this event e.g: 'CPC1E*, CPI1E23'. (Optional)
                  messageIdsExclude: 'messageId-3,messageId-4' ## Message IDs to exclude from this event e.g: 'CPI1E92, AMQ89*'. (Optional)
                  messageText: 'Provide full or partial message text' ## Message text to match within the message. (Optional)
              timeFrame: '10 MINUTES'  ## Format is : {value} MINUTES/HOURS/DAYS (Default Value : '10 MINUTES')
        historyLog:
          rowLimit: 10 # Maximum number of history log entries to fetch per query. Default value is 10
          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. You can use * as wild card'   # example- 'QDEVELOP/RATS, */QBASE, QSYS/Q*'
          rowLimit: 20 # Maximum number of rows to fetch from subsystem query. Default value is 20
        netstatEventInfo:
          port/address: 'Provide LOCAL_PORT/LOCAL_ADDRESS in comma(,) separated way. You can use * in LOCAL_ADDRESS as wildcard.'  #example- '427/9.5.105.61, 38695/*, 8475/9.5.151.81' [Alert will be triggered if TCP state is not LISTEN or Null]
        portStatusEvent:
          Event_name_1:  # Example:  Application Port Status Check Event
            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.51.151.81'
            tcpState: 'Provide the expected TCP states in comma(,) separated way.'  #example- 'LISTEN, ESTABLISHED'
 

カスタムポーリングレート

前述の構成ファイルで複数のポーリング率を構成できます。 以下の 3 つのフィールドで構成されます。

  • os_poll_rate: これは、OS メトリックのセンサーのデフォルトのポーリング・レートです。 このフィールドは必須です。
  • db2_poll_rate : これは、 Db2 メトリックのセンサーのデフォルトのポーリング・レートです。 このフィールドは必須です。
  • custom_poll_rate: 定義済みの components (各グリッドはコンポーネントとして扱われます) および events (サポートされるカスタム・イベント) の詳細を使用して、カスタム・ポーリング・レートの値を指定できます。 このフィールドはオプションです。
  • disabled_components : 「 Instana 」のUIに表示したくないコンポーネントのリストを定義できます。 このフィールドはオプションです。 各コンポーネントを区切るには、コンマ (,) を使用します。

イベントをアラートに変換する

Instana を設定することで、Dynamic Focus クエリで設定された条件に基づいてイベントのアラートを送信するようにできます。 Instana でイベントのアラートを送信するように設定するには、以下の手順を実行してください:

  1. Instana のUIにログインし、 「設定 」>「 アラート 」>「 新しいアラート」 の順にクリックします。
  2. イベント・タイプとして 「イベント・タイプに対するアラート」を選択します。
  3. 「イベント・タイプ」として 「警告」 を選択します。
  4. 「範囲」 として 「選択された対象のみ (ダイナミック・フォーカス・クエリー)」を選択します。
  5. 「ダイナミック・フォーカス・クエリー (Dynamic Focus Query)」 セクションで基準を定義します。 以下の例を参照してください。
    • 定義されているすべてのカスタム・イベントのアラートを取得するには、以下の基準を指定します。
      entity.ibmi.os.hostname:XYZ
       
      ここで、 XYZ はサーバーのホスト名です。
    • 特定のホストに対して特定のカスタム・イベントを設定するには、以下の基準を指定します。
      (entity.ibmi.os.hostname:XYZ) AND (event.text:'EventName-ABC')
       
      ここで、 ABC は、カスタム・ポーリング・レート・イベント構成に定義されているイベント名です。
  6. 優先 「アラート・チャネル」「アラート」 セクションに追加します。

動的フィルタリングについて詳しくは、 構文を参照してください。

構成されたリモート IBM i インスタンスは、指定された availabilityZone に別個のボックスとして表示されます。

JDBC 接続ポート

Instana ( IBM i )センサーは、 JDBC 接続と Java Toolkit接続を使用します。 これらの接続は、以下のポートを使用します。

ポート 説明
8470 このポートは、ホストコードページ変換テーブルおよびライセンス機能に使用されます。
8471 このポートはデータベースへのアクセスに使用されます。
8475 このポートは、アプリケーションの管理制限を確認するために使用されます。
8476 このポートは、認証のためのサインオン検証を行うために使用されます。
449 このポートは、サービス名を基にサービスを検索し、ポート番号を返すために使用されます。
446 このポートは、 JDBC を使用して、 IBM i 向けに Db2 へのリモート接続を行う、分散データ管理(DDM)/分散リレーショナルデータベースアーキテクチャ(DRDA)に使用されます。

デフォルトのポーリング・レート

カスタム・プロバイダー名 UI テーブルの説明 デフォルトのポーリング・レート
補助ストレージ・プール (AUXILIARY_STORAGE_POOLS) 補助ストレージ・プール 15 秒
ディスクの状態 HDD、SSD、およびシステム全体のディスク情報 60 秒
履歴ログ 履歴ログ 15 秒
ジョブ・キュー ジョブ・キュー 15 秒
アクション・ジョブの実行 上位アクティブ・ジョブ 15 秒
監査日誌 監査ジャーナル 900秒
ライセンス・プログラム ライセンス・プログラム、グループPTF 8 時間
メモリー・プール アクティブ・メモリー・プール 15 秒
メッセージ・キュー メッセージ・キュー 15 秒
ネットワーク接続の上位受信側 ネットワーク接続 (上位の受信側) 60 秒
ネットワーク接続のトップ送信者 ネットワーク接続 (上位送信者) 60 秒
ネット・ステータス・インターフェース Netstat インターフェース 120 秒
揮発性メモリー (NON_揮発性) Non Volatile Memory Express(NVMe) 情報 60 秒
出力キュー数 出力キュー 15 秒
スプール・スペース 合計スプール・スペース 120 秒
アクティブ・サブシステム アクティブ・サブシステム 15 秒
システム状況 すべての KPI (CPU 率、使用率、スレッド、アクティブ・ジョブ) 15 秒

ユーザー許可

ユーザー構成パラメーター内で指定されるユーザー・プロファイルには、 *JOBCTL 権限が必要です。 Instana が使用する「 IBM i 」ユーザープロファイルに対して、以下の権限を付与する必要があります:

  • QSYS/CHKPFRCOL (パフォーマンス収集検査) コマンドに対する *USE 権限
  • ジョブ制御 (*JOBCTL) 特殊権限
  • QSYS/WRKPTFGRP (プログラム一時修正グループ処理) コマンドに対する *USE 権限
  • QPMCCDATA 権限リストに対する *USE 権限
  • *QSYS/QAUDJRNジャーナルに関するすべての権限
  • *監査ジャーナルのすべてのジャーナル受信者に権限を付与する。 デフォルトでは、これらは QGPL/AUDRCVXXXX という名前で保存されます:
GRTOBJAUT OBJ(QGPL/AUDRCV*) OBJTYPE(*JRNRCV) USER(<user>) AUT(*USE)
 

MFAに関する注意事項

IBM i 7.6 ユーザープロファイルに対して多要素認証(MFA)を導入します。 これらのアカウントでは、サインオン時にユーザーパスワードに加えて、時間ベースの一時パスワード(TOTP)が必要です。 ユーザー設定で指定されたユーザープロファイルでは、MFAを有効にしてはなりません。 これは、センサーが再起動する可能性があり(たとえば、エージェントの動的更新中など)、再接続が必要になる場合があるためです。その時点で、以前に提供されたTOTPはすでに有効期限が切れていることになります。 システムで多要素認証(MFA)が有効になっている場合でも、TOTPを必要としないユーザープロファイルは通常通り機能します。 詳細については、 MFA をご覧ください。

メトリック収集

メトリクスを表示するには、 Instana のユーザーインターフェースのサイドバーで 「Infrastructure」 を選択し、監視対象の特定のホストをクリックします。すると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。

構成データ

  • ホスト名
  • OS バージョン
  • CPU の合計
  • メモリーの合計
  • 構成された CPU
  • 構成されたメモリー
  • パーティション ID
  • パーティションの数
  • 制限状態

パフォーマンス・メトリック

システム・メトリック

Component Name: SYSTEM_STATUS (カスタム・ポーリング率コンポーネント構成用)

メトリック 説明 粒度
CPU 率 平均 CPU 速度はパーセンテージで表され、100% は、プロセッサーがその公称周波数で稼働中であることを示します。 100% 以上の値または以下の値は、プロセッサー・モデルの公称周波数と比較して、プロセッサーのスローダウン (スロットル) または高速化 (ターボ) がどの程度行われたかを示します。 例えば、値 120% は、プロセッサーは公称速度に比べて 20% 速く実行していることを示します。 15 秒
平均 CPU 使用率 すべてのアクティブなプロセッサーの平均 CPU 使用率。 15 秒
最小 CPU 使用率 最小 CPU 使用率を報告したプロセッサーの CPU 使用率。 15 秒
最大 CPU 使用率 最大の CPU 使用率を報告したプロセッサーの CPU 使用率。 15 秒
アクティブ・ジョブ ユーザー・ジョブおよびシステム・ジョブの両方を含む、システム内でアクティブであるジョブ (開始済みであるが終了していないジョブ) の数。 15 秒
対話式ジョブ この論理区画に割り当てられた対話式パフォーマンスの割合。 この値は、物理システム全体で使用可能な合計対話式パフォーマンスのパーセンテージです。 15 秒
合計ジョブ 現在システムにあるユーザー・ジョブおよびシステム・ジョブの合計数。 合計には、ジョブ・キューで処理を待機しているすべてのジョブ、現在アクティブな (処理されている) すべてのジョブ、および実行が完了したが引き続き出力キューに出力を生成しているすべてのジョブが含まれます。 15 秒
最大ジョブ数 システムで使用できる最大ジョブ数。 ジョブ数がこの最大値に達すると、システム上でこれ以上のジョブを投入または開始することはできません。 合計には、ジョブ・キューで処理を待機しているすべてのジョブ、現在アクティブな (処理されている) すべてのジョブ、および実行が完了したが引き続き出力キューに出力を生成しているすべてのジョブが含まれます。 15 秒
使用済み補助ストレージ・プール 現在使用中のシステム・ストレージ・プール (ASP 番号 1) のパーセント。 15 秒
補助ストレージ・プールの容量 システム補助ストレージ・プール (ASP 番号 1) のストレージ容量 (メガバイト単位)。 この値は、永続オブジェクトと一時オブジェクトの両方の記憶域に使用可能なスペースの容量を表します。 15 秒
現在の一時ストレージ 一時オブジェクト用に使用されている記憶域の現在の容量 (メガバイト単位)。 15 秒
最大使用済み一時ストレージ 最後の IPL 以降のある任意の時点における、一時オブジェクトに使用されていた記憶域の最大容量 (メガバイト単位)。 15 秒
一時的アドレス・レート 一時オブジェクト用に割り当て可能な最大アドレス数に対して、現在使用中のアドレスの割合。 15 秒
アクティブ・スレッド ユーザー・スレッドとシステム・スレッドの両方を含む、システム内の初期スレッドおよび 2 次スレッド (開始されているが、まだ終了していないスレッド) の数。 15 秒
合計スプール・スペース 出力キューによって使用される合計スプール・スペース (バイト)。 15 秒

アクティブ・メモリー・プール・メトリック

Component Name: MEMORY_POOLS (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
使用中のストレージ プール中の主記憶域の容量(メガバイト)。 15 秒
予約済みストレージ システム用に予約されているプール内のストレージの量 (メガバイト単位)。 例えば、保管または復元操作用のプールです。 15 秒
定義済みストレージ 共用プール、サブシステム記述、またはシステム値 QMCHPOOLに定義されているプールのサイズ (メガバイト単位)。 定義されたサイズを持たないプールの場合は、NULL 値が入ります。 15 秒
アクティブ・スレッド 現在プールを使用しているスレッドの数。 15 秒
不適格スレッド数 プールでの不適格スレッドの数。 15 秒
最大スレッド数 任意の時点でプール内でアクティブにすることができるスレッドの最大数。 15 秒
時間が経過したデータベース障害数 データベース・アクセスを含むページに対する 1 秒当たりのページ・フォールトの数。 15 秒
時間が経過した合計障害数 1 秒当たりのデータベース・ページ・フォールトと非データベース・ページ・フォールトの合計数。 15 秒
時間が経過した非データベース障害数 非データベース・アクセスに対する 1 秒当たりのページ・フォールトの数。 15 秒
注:IBM i センサーは、メモリプールの最初の20件のエントリのみを収集します。

出力キューのメトリック

Component Name: OUTPUT_QUEUES (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
キュー名 出力待ち行列の名前。 15 秒
ライブラリー名 出力待ち行列が入っているライブラリーの名前。 15 秒
状況 出力待ち行列の状況。 15 秒
キュー内のファイル 現在この出力待ち行列上にあるスプール・ファイルの総数。 15 秒
書き込みプログラム・ジョブ名 書き出しプログラム・ジョブの修飾ジョブ名。 複数の書き出しプログラムが開始される場合、これは、最初の書き出しプログラムの名前です。 この待ち行列用の書き出しプログラム・ジョブが開始されていない場合は、NULL 値が入ります。 15 秒
書き込みプログラム・ジョブ状況 書き出しプログラム・ジョブの状況。 複数の書き出しプログラムが開始される場合、これは、最初の書き出しプログラムの状況です。 15 秒
注:IBM i センサーは、各出力キューに含まれるスプールファイルの数に基づき、最初の20個の出力キューのみを収集します。

上位スプール・スペース使用量

スプール・スペースを消費している上位 20 人のユーザー。

Component Name: SPOOL_SPACE (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
ユーザー スプール・ファイルを作成したユーザー・プロファイルの名前。 120 秒
スプール・スペース ユーザーのスプール・ファイルのサイズ (バイト)。 120 秒

スプール領域の総使用量

Component Name: SPOOL_SPACE (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
合計スプール・スペース 出力キューによって使用される合計スプール・スペース (バイト)。 120 秒

上位アクティブ・ジョブ

user_specification:activeJobs:jobsで指定された値と一致するジョブ名とともに、システムで現在実行されている上位 20 個のアクティブ・ジョブ。

Component Name: TOP_ACTIVE_JOBS (カスタム・ポーリング率コンポーネント構成用) アクティブ・サブシステム カスタム・イベント:

  • Event Name: IDENTICAL_JOBS_EVENT (カスタムポーリングレートイベントの設定用) Instana エージェントの設定ファイルの セクション user_specification:activeJobs:event:identicalJobs で、 threshold および jobName/user を指定できます。 その後、アクティブ・ジョブのカウントが任意の時点で指定されたしきい値を下回ると、構成で定義されているジョブに対してイベントがトリガーされます。
    • ワイルドカードサポート: 特定のジョブを、ユーザーに関係なく検証します。threshold価値、使用*ユーザー部分について。 たとえば、「QZDASOINIT/*」 IBM i 7.2 では、IDENTICAL_JOBS_EVENT フィールドの使用はサポートされていません。
  • Event Name: RUNNING_JOB_STATUS_EVENT (カスタムポーリングレートイベントの設定用) Instanauser_specification:activeJobs:event:runningStatus エージェントの設定ファイルのセクションで、フィールド runningStatus を指定できます。 JobStatus/Subsystemこのフィールドは、の組み合わせです。 その後、定義された基準に一致するジョブに対してイベントがトリガーされます。
    • ワイルドカードサポート: 利用可能なすべてのジョブステータスで特定のジョブステータスを検証するには、Subsystem 、 使用*の中にSubsystem一部。
    • MSGW+: パラメータに JobStatusMSGW+ 指定して、MSGWステータスのジョブをフィルタリングします。 このフィルターは、メッセージへの返信が不要なエントリを除外します。
  • Event Name: INACTIVE_JOBS_EVENT (カスタムポーリングレートイベントの設定用) InstanainactiveJobsuser_specification:activeJobs:event:inactiveJobs エージェントの設定ファイルのセクションにあるフィールドで、 JOB_NAME フィールドを指定できます。 その後、その時点においてシステム内で特定の状態 Active になっていないジョブに対してイベントがトリガーされます。
    • ワイルドカードのサポート: 非アクティブなジョブイベントをトリガーするには、JOB_NAME 、 使用*のどの部分でも接頭辞または接尾辞としてJOB_NAME一部。
  • Event Name: INACTIVE_JOBS_IN_JOBQ_EVENT (カスタムポーリングレートイベントの設定用) Instana エージェントの設定ファイルの user_specification:activeJobs:event:enableInactiveJOBQStatus セクションで、 enableInactiveJOBQStatus フィールドを有効または無効にできます。 enableInactiveJOBQStatus フィールドが有効になっている場合、任意の時点で JOB_QUEUE_STATUSJOBQ または RELEASED であり SCHEDULEDかつJOB_STATUSが であるジョブに対してイベントがトリガーされます。 IBM i 7.2 enableInactiveJOBQStatus フィールドの使用はサポートされていません。
メトリック ** 説明 粒度
ジョブ名 ジョブの修飾名。 15 秒
ユーザー名 この時点で初期スレッドが実行されているユーザー・プロファイル。 ユーザー・プロファイルをスワップするジョブの場合、このユーザー・プロファイル名と、ジョブを開始したユーザー・プロファイルは異なることがあります。 15 秒
経過 CPU パーセンテージ 測定時間間隔中にこのジョブに起因した処理装置時間のパーセント。 15 秒
一時ストレージ ユーザーのスプール・ファイルのサイズ (キロバイト)。 15 秒
ジョブ状況 ジョブの初期スレッドの状況。 15 秒
ジョブ・タイプ アクティブ・ジョブのタイプ。 15 秒
スレッド数 ジョブ中で活動状態のスレッドの数。 15 秒
注:IBM i センサーは、UI上にアクティブなジョブのうち最初の20件のみを表示します。 ただし、イベントの評価(例えば、 IDENTICAL_JOBS_EVENT、および RUNNING_JOB_STATUS_EVENT)においては、センサーはUIに表示されているジョブだけでなく、システム内のすべてのジョブを対象とします。

監査ジャーナル

Audit Journalは、 IBM i 上のシステムおよびユーザーのアクティビティログを記録し、セキュリティ、コンプライアンス、およびシステム利用状況の監視を支援します。

Component Name: AUDIT_JOURNAL

メトリック 説明 粒度
エントリー・タイプ 監査仕訳の区分または分類。 15 分間
エントリー・タイプ詳細 監査仕訳の仕訳種別の説明。 15 分間
エントリー数 指定されたタイプおよび詳細に対するエントリーの総数。 15 分間

カスタムイベント:

  • Event Name: AF_EVENT

    エージェント設定ファイルの セクション auditJournal:event:AF で、 qualifiedJobName, objectLib/Name, objectType, userProfileName, violationType, および threshold の値を指定できます。 監査ジャーナル内の「AF」というエントリタイプを持つエントリが、指定されたすべてのフィルタ条件を満たす場合、定義されたイベントが Event Nameトリガーされます。 すべてのフィルターは任意であり、それらを自由に組み合わせて使用できます。 以下の定義例を考えてみます。

    AF:
    timeframe: '24 HOURS'
    User Authority failure:
      violationType: 'A,K'
      qualifiedJobName: '*/QUSER/QZDASOINIT,*/QUSER/*'
      objectLib/Name: 'QUSRSYS/QEZJOBLOG,QSYS/*'
      objectType: '*FILE,*OUTQ'
      userProfileName: 'GUEST,TEMP*'
      threshold: 5
     

    この例では、監査ジャーナル内の「権限障害(AF)」エントリが以下の条件を満たす場合、イベント User Authority failure 名「」のイベントがトリガーされます:

    • このエントリはAF型です。
    • 違反の種類は、 A (読み取り操作) または K (検索操作) のいずれかです。
    • 完全一致するジョブ名は、 /QUSER/QZDASOINIT またはパターンに一致する /QUSER/*ものです。
    • オブジェクトは、 QSYS/QAUDJRN またはQSYSライブラリ内の任意のオブジェクトです。
    • オブジェクトのタイプは、または *FILE*DIRいずれかです。
    • ユーザープロファイル名は であるか、 GUEST または で始まる TEMP
    • 指定された期間内に、少なくとも5件の記録が存在します。
    • これらの投稿は過去24時間以内に行われました。
  • Event Name: CA_EVENT

    エージェント設定ファイルの セクション auditJournal:event:CA で、 objectType, userProfileName, objectAuthority, dataAuthority, commandType, objectLib/Name, および threshold の値を指定できます。 監査ジャーナル内の「CA」というエントリタイプを持つエントリが、指定されたすべてのフィルタ条件を満たす場合、 Event Name定義されたイベントがトリガーされます。 すべてのフィルターは任意であり、それらを自由に組み合わせて使用できます。 以下の定義例を考えてみます。

    CA:
    timeframe : '24 HOURS'
    Changed Authority Alert:
      objectLib/Name: 'MYLIB/MYOBJ,QSYS/*'
      objectType: '*FILE,*PGM'
      userProfileName: 'QUSER,*PUBLIC'
      objectAuthority: 'EXIST,ALTER,REF'
      dataAuthority: 'READ,EXECUTE'
      commandType: 'GRANT,REPLACE'
      threshold: 5
     

    この例では、監査ジャーナル内の「認証局の変更(CA)」エントリが以下の条件を満たす場合、イベント Changed Authority Alert 名「」のイベントがトリガーされます:

    • このエントリはCA型です。
    • そのオブジェクトは、 MYLIB/MYOBJ か、 QSYS ライブラリ内の任意のオブジェクトのいずれかです。
    • オブジェクトのタイプは、または *FILE*PGMいずれかです。
    • ユーザープロファイル名は「QUSER」か、あるいは権限の変更対象は *PUBLIC.でした。
    • 以下のオブジェクト権限のうち、少なくとも1つが変更されました: *OBJEXIST, *OBJALTER, *OBJREF
    • 以下のデータ管理者のうち、少なくとも1つが変更されました: *READ, *EXECUTE
    • 使用されたコマンドの種類は、 GRANTREPLACE
    • 指定された期間内に、少なくとも5件の記録が存在します。
    • これらの投稿は過去24時間以内に行われました。
  • Event Name: PW_EVENT

    パスワード変更イベントを監視するには、 エージェント設定ファイルの セクション auditJournal:event:PW を設定してください。 「 violationTypeauditUsername」、「 threshold」などのオプションのフィルターを指定できます。 監査ジャーナル内の「PW」というエントリタイプを持つエントリが、指定されたすべてのフィルタ条件を満たす場合、 Event Name定義されたイベントがトリガーされます。 すべてのフィルターは任意であり、それらを自由に組み合わせて使用できます。 以下の定義例を考えてみます。

    PW:
    timeframe : '24 HOURS'
    Password Changed Alert:
      violationType: 'P,U'
      auditUsername: 'TESTUSER , USER*'
      threshold: 5
     

    この例では、監査ジャーナル内の「パスワード変更(PW)」エントリが以下の条件を満たす場合、イベント Password Changed Alert 名「」のイベントがトリガーされます:

    • このエントリのタイプはPWです。
    • 違反の種類は、 P または です U
    • 監査用ユーザー名は、または TESTUSERUSER*いずれかです。
    • 指定された期間内に、少なくとも5件の記録が存在します。
    • これらの投稿は過去24時間以内に行われました。
  • Event Name: CP_EVENT

    エージェント設定ファイルの セクション auditJournal:event:CP で、 event_name, userProfile, changedAuthority, passwordChanged, passwordExpired, commandTypetimeframe,, および threshold の値を指定できます。

    監査ジャーナルのエントリのうち、エントリタイプが のものが指定された CP すべてのフィルタ条件を満たす場合、定義された でイベントが Event Nameトリガーされます。 すべてのフィルターは任意であり、それらを自由に組み合わせて使用できます。 以下の例は、設定のサンプルを示しています:

    CP:
      timeframe: '24 HOURS'
      User Profile Change Alert:
        userProfile: 'ADMIN*, USER01'
        changedAuthority: 'ALLOBJ, JOBCTL, SECADM'
        passwordChanged: 'YES'
        passwordExpired: 'NO'
        commandType: 'CRT, CHG, RST'
        threshold: 1
     

    この例では、監査ジャーナル内の「Change Profile (CP)」エントリが以下の条件を満たす場合、イベント User Profile Change Alert 名「」のイベントがトリガーされます:

    • エントリのタイプは CP.
    • ユーザープロファイル名は で ADMIN 始まるか、または です USER01
    • 変更された権限には、以下のいずれか少なくとも1つが含まれます:、 JOBCTLALLOBJ、または SECADM
    • パスワードが変更されました(YES)。
    • パスワードの有効期限は切れていません(NO)。
    • 使用されたコマンドの種類は、次のいずれかでした: CRT (作成)、 CHG (変更)、または RST (復元)。
    • 指定された期間内に、少なくとも1件の記録が存在します(threshold: 1)。
    • これらの投稿は過去24時間以内に行われました。
  • Event Name: OW_EVENT

    エージェント設定ファイルの セクション auditJournal:event:OW で、 event_name, objectLib/Name, objectType, previousOwner, newOwner, timeframe, および threshold の値を指定できます。

    監査ジャーナルのエントリのうち、エントリタイプが のものが指定された OW すべてのフィルタ条件を満たす場合、定義された でイベントが Event Nameトリガーされます。 すべてのフィルターは任意であり、それらを自由に組み合わせて使用できます。 以下の例は、設定のサンプルを示しています:

    OW:
      timeframe: '24 HOURS'
      Ownership Change Alert:
        objectLib/Name: 'MYLIB/MYOBJ,QSYS/*'
        objectType: '*FILE,*PGM'
        previousOwner: 'USER01, SYSADMIN'
        newOwner: 'SYSADMIN, USER*'
        threshold: 1
     

    この例では、監査ジャーナル内の「Change Profile (CP)」エントリが以下の条件を満たす場合、イベント User Profile Change Alert 名「」のイベントがトリガーされます:

    • エントリのタイプは OW.
    • そのオブジェクトは、 MYLIB/MYOBJ か、 QSYS ライブラリ内の任意のオブジェクトのいずれかです。
    • オブジェクトのタイプは、または *FILE*PGMいずれかです。
    • 前の所有者は、 USER01SYSADMIN どちらかでした。
    • 新しい所有者は、あるいは SYSADMIN のいずれか USER*だった。
    • 指定された期間内に、少なくとも1件の記録が存在します(threshold: 1)。
    • これらの投稿は過去24時間以内に行われました。

補助ストレージ・プール

補助記憶域プール (ASP) に関する情報。

Component Name: AUXILIARY_STORAGE_POOLS (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
ASP番号 ASP の固有 ID。 可能な値は 1 から 255 です。 15 秒
装置記述名 独立 ASP (IASP) をvaryon/アクティブ状態にした装置記述の名前。 15 秒
ASP タイプ ASP に割り当てられている用途。 15 秒
ASP の状態 ASP の装置構成状況。 15 秒
ディスク装置の数 ASP 内のディスク装置の総数。 ASP 内のディスク装置のミラー保護がアクティブな場合、装置のミラー保護された対は 1 つとしてカウントされます。 15 秒
合計容量 ASP 内の使用済みメガバイト数と未使用のメガバイト数の合計。 このフィールドのサイズを超過している場合は、特殊値 -2 が返されます。 15 秒
合計容量使用率 ASP 内の合計容量の使用率。 15 秒
保護されている容量 ミラーリングまたは装置パリティーによって保護されている、ASP 内の使用済みメガバイト数と未使用のメガバイト数の合計。 値が大きすぎて返せない場合は、特殊値 -2 が返されます。 容量を判別できない場合は、NULL 値が入ります。 15 秒
保護されている容量使用率 ASP 内の保護されている容量の使用率。 15 秒
保護されていない容量 ミラーリングによっても装置パリティーによっても保護されていない、ASP 内の使用済みメガバイト数と未使用のメガバイト数の合計。 値が大きすぎて返せない場合は、特殊値 -2 が返されます。 容量を判別できない場合は、NULL 値が入ります。 15 秒
保護されていない容量使用率 ASP 内の保護されていない容量の使用率。 15 秒
注:IBM i センサーは、最初の20個のASPのみを収集します。

アクティブ・サブシステム

アクティブ・サブシステムに関する情報

Component Name: ACTIVE_SUBSYSTEMS (カスタム・ポーリング・レート・コンポーネント構成用)

  • Event Name: SUBSYSTEM_STATUS (カスタムポーリングレートイベントの設定用) 設定ファイルで subsystem_list これを指定 user_specification:subsystemできます。 その場合、指定されたサブシステムが指定 Active されたステータスにない場合、イベントが発生します。
  • Wildcard Support: に基づいて非アクティブなサブシステムイベントをトリガーするには、 または SUBSYSTEM_DESCRIPTION_LIBRARY SUBSYSTEM_DESCRIPTION の部分の SUBSYSTEM_DESCRIPTION_LIBRARY/SUBSYSTEM_DESCRIPTION任意の箇所で、 を接頭辞または接尾辞として * 使用します。
メトリック 説明 粒度
名前 情報が返されるサブシステムの名前。 15 秒
ライブラリー名 サブシステム記述があるライブラリーの名前。 15 秒
アクティブ・ジョブ サブシステム内で現在アクティブなジョブの数。 この数には保留中のジョブが含まれますが、2 次ジョブの転送またはグループ・ジョブの転送のために切断または中断されたジョブは除外されます。 状況が非アクティブの場合は 0 が返されます。 15 秒
最大アクティブ・ジョブ数 サブシステムで同時に実行できる、または同時にリソースを使用できるジョブの最大数。 サブシステム記述で *NOMAX が指定されている場合は、最大値がないことを示す NULL 値が入ります。 15 秒
説明 サブシステム記述のテキスト記述。 15 秒
注:IBM i センサーは、アクティブなサブシステムのうち最初の20個のみを収集します。 ただし、イベントの評価(例えば、 ACTIVE_SUBSYSTEMS)においては、システムはUIに表示されているサブシステムだけでなく、すべてのサブシステムを考慮します。

ジョブ・キュー

ジョブ・キューに関する情報

Component Name: JOB_QUEUES (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
ジョブ・キュー名 ジョブ・キューの名前。 15 秒
ジョブ・キュー・ライブラリー ジョブ・キューが含まれているライブラリーの名前。 15 秒
サブシステム名 このジョブ・キューからジョブを受け取ることができるサブシステムの名前。 このジョブ・キューがアクティブなサブシステムに関連付けられていない場合は、NULL 値が入ります。 15 秒
サブシステム・ライブラリー名 サブシステム記述があるライブラリー。 このジョブ・キューがアクティブなサブシステムに関連付けられていない場合は、NULL 値が入ります。 15 秒
ジョブの数 キュー内のジョブの数。 15 秒
アクティブ・ジョブ このジョブ・キュー項目から入ってきた、現在アクティブなジョブの数。 このジョブ・キューがアクティブなサブシステムに関連付けられていない場合は、NULL 値が入ります。 15 秒
最大アクティブ・ジョブ数 このジョブ・キュー項目から同時にアクティブにすることができるジョブの最大数。 値 -1 は *NOMAX を示し、ジョブの最大数が定義されません。 このジョブ・キューがアクティブなサブシステムに関連付けられていない場合は、NULL 値が入ります。 15 秒
ジョブ・キュー状況 ジョブ・キューの状況。 HELD: キューが保留されています。 RELEASED: キューが解放されています。 15 秒
テキスト記述 ジョブ・キューを記述するテキスト。 ジョブ・キューにテキスト記述がない場合は、NULL 値が入ります。 15 秒
保留されているジョブ 現在 *HELD 状況にあるジョブの数。 10 個ある HELD_JOBS_PRIORITY_n 列の合計です。 15 秒
解放されたジョブ 現在 *RELEASED 状況にあるジョブの数。 10 個ある RELEASED_JOBS_PRIORITY_n 列の合計です。 15 秒
スケジュールされたジョブ 現在 *SCHEDULED 状況にあるジョブの数。 10 個ある SCHEDULED_JOBS_PRIORITY_n 列の合計です。 15 秒
注:IBM i センサーは、各ジョブキューに含まれるジョブ数およびアクティブなジョブ数に基づき、最初の20個のジョブキューに関する情報のみを収集します。

ライセンス・プログラム

ライセンスプログラムは、製品ライセンスに関する情報を管理します。

Component Name: ライセンス・プログラム

メトリック 説明 粒度
製品 ID 製品の ID。 8分
ライセンス条項 製品の許容使用期限の満了。 8分
免許の有効期限 ライセンスの有効期限。 8分
フィーチャーID プロダクトの機能番号。 8分
インストール済み この製品の機能番号のインストール状況。 8分
商品テキスト プロダクトまたは機能の説明。 8分
期限までの日数 ライセンスの有効期限までの日数。 8分
注:IBM i センサーは、有効期限までの残日数順に優先順位付けされた、最初の40件のプログラムについてのみ、ライセンスプログラム情報を収集します。

グループ PTF

グループプログラムの一時的な修正に関する情報。

Component Name: GROUP_PTFS

メトリック 説明 粒度
PTFグループ名 グループ名:PTF。 15 分間
PTFグループ・レベル 特定のグループPTFのバージョン。 15 分間
PTFグループ・ステータス インストール状況の概要。 15 分間
PTFグループの説明 グループPTFの概要。 15 分間
PTFグループ・ターゲット・リリース グループPTFの計画的なリリース。 15 分間
注:IBM i センサーは、最初の40個のPTFについてのみグループPTF情報を収集します。

個人向けPTF

各PTFグループ名およびPTFグループレベルに含まれるすべての個別プログラム一時修正プログラムに関する情報を提供します。

Component Name: INDIVIDUAL_PTFS

メトリック 説明 粒度
PTF ID PTF の ID。 15 分間
製品 ID 製品の ID。 15 分間
PTFリリース PTF のリリース・レベル。 15 分間
状況 インストール状況の概要。 15 分間
注: 収集されたグループPTFごとに、「 IBM i 」センサーは、それに関連する10個の個別PTFを取得します。

ネットワーク・インターフェース

IPv4 インターフェースおよび IPv6 インターフェースに関する情報

Component Name: NETSTAT_INTERFACES (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
IP アドレス インターフェースの IP アドレス。 120 秒
サブネット・マスク インターフェースのサブネットワークを定義する IP アドレスの、ネットワーク、サブネット、ホスト・アドレスのフィールドに対するサブネット・マスク。 IPv6 接続の場合は NULL が入ります。 120 秒
接続タイプ 接続のタイプ (IPV4、IPV6)。 120 秒
インターフェースの回線タイプ インターフェースで使用されている回線のタイプ。 120 秒
回線記述 インターフェースに関連付けられている物理ネットワークを識別する通信回線記述の名前。 120 秒
VLAN ID インターフェースが属している仮想 LAN。 120 秒
状況 論理インターフェースの現在の状況。 120 秒
注:IBM i センサーは、最初の20個のインターフェースについてのみネットワークインターフェース情報を収集します。

状況値のマッピング

メトリック値 状況
0 ENDING
1 アクティブ
2 失敗
3 FAILED_TCP
4 非アクティブ
5 RCYCNL
6 RCYPND
7 STARTING
8 ACQUIRING
9 ACQUIRING
10 ACQUIRING

ネットワーク接続 (上位の受信側)

ローカル側で受信されたバイト数に関する Netstat 情報

Component Name: NETWORK_CONNECTIONS_TOP_RECEIVERS (カスタム・ポーリング率コンポーネント構成の場合)

  • Event Name: ACTIVE_PORTS_LISTENING_STATUS (カスタムポーリングレートイベントの設定用) この LOCAL_PORT/LOCAL_ADDRESS フィールドは、 user_specification:netstatEventInfoInstana エージェントの設定ファイルのセクションで指定できます。 その後、定義されたポートのいずれかが または Null の状態 LISTEN にない場合、設定で定義されたポートに対してイベントが発生します。

    • ワイルドカードのサポート: 特定のPort Numberに関係なくLocal Address、 使用*住所部分について。 例: '38695/*'
  • Event Name: PORTS_STATUS (カスタムポーリングレートイベントの設定用) Instana エージェントの設定ファイルの セクション user_specification:portStatusEvent で、 および tcpStates フィールド LOCAL_PORT/LOCAL_ADDRESS を指定できます。 定義されたポートのいずれかが、設定された状態になく、または非アクティブである場合、設定に従ってそのポートに対してイベントが発生します。

    • ワイルドカードのサポート:特定の を Local AddressPort Number に関係なく検証するには、アドレスのワイルドカードとして * を使用します。 例えば、「38695/*」など。
メトリック 説明 粒度
リモート・ポート & アドレス この列は、リモート・ポートとリモート・アドレスの組み合わせです。 リモート・ポートはリモート・ホストのポート番号です。 値 0 は、接続が listen ソケットまたは UDP ソケットであるために、このフィールドが該当しないことを意味します。 リモート・アドレスはリモート・ホストの IP アドレスです。 IPv4 の場合は、IPv4 アドレス・フォーマットのアドレスになります。 値 0.0.0.0 は、接続が開くのをシステムが待機しているか、UDP ソケットが使用中であることを示します。 値 0 は、接続が listen ソケットまたは UDP ソケットであるために、このフィールドが該当しないことを意味します。 IPv6 の場合は、IPv6 アドレス・フォーマットのアドレスになります。 値 :: は、接続が listen ソケットであるために、このフィールドが該当しないことを意味します。 60 秒
バインド・ユーザー ソケットのソケット API bind() を最初に実行したローカル・システム上のジョブのユーザー・プロファイル。 60 秒
ローカル・ポート & アドレス この列は、ローカル・ポートとローカル・アドレスの組み合わせです。 ローカル・ポートはローカル・システムのポート番号です。 ローカル・アドレスは、このシステム上のこの接続のローカル・アドレスです。 IPv4 の場合は、IPv4 アドレス・フォーマットのアドレスになります。 値 0.0.0.0 は、接続が開くのをシステムが待機しているか、UDP ソケットが使用中であることを示します。 IPv6 の場合は、IPv6 アドレス・フォーマットのアドレスになります。 値 :: は、任意のローカル IP アドレスを使用できることをローカル・アプリケーションが指定したことを意味します。 60 秒
リモート・ポート名 サブシステム記述があるライブラリー。 このジョブ・キューがアクティブなサブシステムに関連付けられていない場合は、NULL 値が入ります。 60 秒
ローカル・ポート名 ローカル・システムのウェルノウン・ポート名、またはサービス・テーブル項目に含まれる名前。 ウェルノウン・ポート名がない場合は、NULL が入ります。 60 秒
リモート側での送信バイト数 リモート・ホストに送信したバイト数。 60 秒
ローカル側での受信バイト数 リモート・ホストから受信したバイト数。 60 秒
プロトコル 接続プロトコルのタイプを示します。 TCP: 伝送制御プロトコル (TCP) 接続または TCP ソケット。 UDP: User Datagram Protocol (UDP) ソケット。 60 秒
TcpState 接続の状態。 CLOSED: 接続が終了しました。 CLOSE-WAIT: ローカル・ユーザーからの接続終了要求を待機しています。 CLOSING: リモート・ホストからの接続終了要求の肯定応答を待機しています。 ESTABLISHED: データ転送が行われる正常な状態です。 FIN-WAIT-1: ローカル・システムの接続終了要求にリモート・ホストが応答するのを待機しています。 FIN-WAIT-2: リモート・ホストの接続終了要求を待機しています。 LAST-ACK: リモート・ホストによる接続終了要求の応答を待機しています。 LISTEN: あらゆるリモート・ホストからの接続要求を待機しています。 SYN-RECEIVED: 接続要求の肯定応答の確認を待機しています。 SYN-SENT: 接続要求を送信した後に、対応する接続要求を待機しています。 TIME-WAIT: リモート・ホストがローカル・システムによる接続終了の応答を受信するまでの間待機しています。 プロトコルが UDP の場合は NULL が入ります。 60 秒
注:IBM i センサーは、ローカルで受信したバイト数に基づき、ネットワーク接続(上位の受信元)に関する情報を最初の20件のみ収集します。 ただし、イベントの評価(例えば、 ACTIVE_PORTS_LISTENING_STATUS、および PORTS_STATUS)においては、システムはUIに表示されている接続だけでなく、すべてのネットワーク接続を考慮します。

ネットワーク接続 (上位の送信側)

ローカル側で送信されたバイト数に関する Netstat 情報

Component Name: NETWORK_CONNECTIONS_TOP_SENDERS (カスタム・ポーリング率コンポーネント構成用)

メトリック 説明 粒度
リモート・ポート & アドレス この列は、リモート・ポートとリモート・アドレスの組み合わせです。 リモート・ポートはリモート・ホストのポート番号です。 値 0 は、接続が listen ソケットまたは UDP ソケットであるために、このフィールドが該当しないことを意味します。 リモート・アドレスはリモート・ホストの IP アドレスです。 IPv4 の場合は、IPv4 アドレス・フォーマットのアドレスになります。 値 0.0.0.0 は、接続が開くのをシステムが待機しているか、UDP ソケットが使用中であることを示します。 値 0 は、接続が listen ソケットまたは UDP ソケットであるために、このフィールドが該当しないことを意味します。 IPv6 の場合は、IPv6 アドレス・フォーマットのアドレスになります。 値 :: は、接続が listen ソケットであるために、このフィールドが該当しないことを意味します。 60 秒
バインド・ユーザー ソケットのソケット API bind() を最初に実行したローカル・システム上のジョブのユーザー・プロファイル。 60 秒
ローカル・ポート & アドレス この列は、ローカル・ポートとローカル・アドレスの組み合わせです。 ローカル・ポートはローカル・システムのポート番号です。 ローカル・アドレスは、このシステム上のこの接続のローカル・アドレスです。 IPv4 の場合は、IPv4 アドレス・フォーマットのアドレスになります。 値 0.0.0.0 は、接続が開くのをシステムが待機しているか、UDP ソケットが使用中であることを示します。 IPv6 の場合は、IPv6 アドレス・フォーマットのアドレスになります。 値 :: は、任意のローカル IP アドレスを使用できることをローカル・アプリケーションが指定したことを意味します。 60 秒
リモート・ポート名 サブシステム記述があるライブラリー。 このジョブ・キューがアクティブなサブシステムに関連付けられていない場合は、NULL 値が入ります。 60 秒
ローカル・ポート名 ローカル・システムのウェルノウン・ポート名、またはサービス・テーブル項目に含まれる名前。 ウェルノウン・ポート名がない場合は、NULL が入ります。 60 秒
リモート側での送信バイト数 リモート・ホストに送信したバイト数。 60 秒
ローカル側での受信バイト数 リモート・ホストから受信したバイト数。 60 秒
プロトコル 接続プロトコルのタイプを示します。 TCP: 伝送制御プロトコル (TCP) 接続または TCP ソケット。 UDP: User Datagram Protocol (UDP) ソケット。 60 秒
TcpState 接続の状態。 CLOSED: 接続が終了しました。 CLOSE-WAIT: ローカル・ユーザーからの接続終了要求を待機しています。 CLOSING: リモート・ホストからの接続終了要求の肯定応答を待機しています。 ESTABLISHED: データ転送が行われる正常な状態です。 FIN-WAIT-1: ローカル・システムの接続終了要求にリモート・ホストが応答するのを待機しています。 FIN-WAIT-2 : リモート・ホスト要求が接続を終了するのを待機しています。 LAST-ACK: リモート・ホストによる接続終了要求の応答を待機しています。 LISTEN: あらゆるリモート・ホストからの接続要求を待機しています。 SYN-RECEIVED: 接続要求の肯定応答の確認を待機しています。 SYN-SENT: 接続要求を送信した後に、対応する接続要求を待機しています。 TIME-WAIT: リモート・ホストがローカル・システムによる接続終了の応答を受信するまでの間待機しています。 プロトコルが UDP の場合は NULL が入ります。 60 秒
注:IBM i センサーは、ローカルで送信されたバイト数に基づいて、ネットワーク接続(上位送信元)情報を最初の20件のみ収集します。

メッセージ・キュー

メッセージ・キュー内の各メッセージに関する情報。 Instana メッセージキュー内のメッセージが、ユーザーがファイル configuration.yaml で指定した仕様(キューライブラリ、キュー名、メッセージID)に一致するたびに、イベントが生成されます。

Component Name: MESSAGE_QUEUES(カスタム・ポーリング・レート・コンポーネント構成の場合)

カスタムイベント: MESSAGE_QUEUE_ID_EVENT Event NameInstana エージェントの設定ファイルのセクション user_specification:messageQueue:event では、カンマ区切りで複数の Message Id 値を指定できます。 このイベントは、定義されたメッセージ・ライブラリーおよびメッセージ・キュー内のメッセージに、定義されたメッセージ ID 値のいずれかが含まれている場合に、定義された Event Name でトリガーされます。 以下の定義例を考えてみます。

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

この例では、メッセージ・ライブラリー QSYS およびメッセージ待ち行列 QSYSOPR 内のメッセージにメッセージ ID CPC1E1D または CPI1E23のいずれかがある場合に、イベント名 Hyper Swap Alerts でイベントがトリガーされます。 メッセージ・イベントには、以下の条件が適用されます。

  • メッセージは、ライブラリーおよびキュー ( configuration.yaml ファイルに定義されている) に入っています。
  • メッセージ ID はライブラリー/待ち行列定義にリストされます。

Event Name: MESSAGE_QUEUE_TEXT_EVENT この Message Text 値は、 user_specification:messageQueue:eventInstana エージェントの設定ファイルのセクションで指定できます。 定義されたメッセージ・ライブラリーおよびメッセージ待ち行列内のメッセージに定義されたメッセージ・テキストのいずれかが含まれている場合、イベントは定義された Event Name でトリガーされます。 以下の定義例を考えてみます。

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

この例では、メッセージ・ライブラリー QSYS およびメッセージ待ち行列 QSYSOPR 内のメッセージにメッセージ・テキスト「queue disconnected」が含まれている場合に、イベント名 IBM MQ Issue でイベントがトリガーされます。 メッセージ・イベントには、以下の条件が適用されます。

  • メッセージは、ライブラリーおよびキュー ( configuration.yaml ファイルに定義されている) に入っています。
  • メッセージ・テキストはライブラリー/待ち行列定義にリストされます。

Event Name: MESSAGE_QUEUE_INQUIRY_EVENTInstana エージェントの設定ファイルのセクション user_specification:messageQueue:event:messageQueueInquiryEvent で、および timeWithoutReplyLibrary/QueueName の値を指定できます。 定義されたメッセージライブラリおよびメッセージキュー内のメッセージ INQUIRY に がなく、 REPLY かつ指定された期間より古い場合、このイベントが発生します。 以下の定義例を考えてみます。

messageQueueInquiryEvent:
  library/queueName: 'QSYS/QSYSOPR'
  timeWithoutReply: '5 MINUTES'
 

この例では、メッセージライブラリ「QSYS」およびメッセージキュー「QSYSOPR」内のメッセージ INQUIRY が、5分経過しても REPLY 処理されない場合、イベントが発生します。 メッセージ・イベントには、以下の条件が適用されます。

  • そのメッセージは、いずれかのメッセージキュー(ファイル configuration.yaml で定義されている)にあります。
  • このメッセージは、…を持たないメッセージ INQUIRYREPLY です。
  • メッセージは(ファイル configuration.yaml で定義された)期間よりも古いものです。

Event Name: MESSAGE_QUEUE_EVENTInstana エージェントの設定ファイルのセクション user_specification:messageQueue:event で、 severitymessageIdsIncludemessageIdsExclude、、および messageTextmessageType の値を指定できます。 指定されたメッセージキュー内のメッセージが、指定されたすべてのフィルタ条件を満たす場合、定義されたイベントが Event Nameトリガーされます。 すべてのフィルターは任意であり、それらを自由に組み合わせて使用できます。 以下の定義例を考えてみます。

messageQueueEvent:
  QSYS/QSYSOPR:
    Detached Alert :
      messageType: 'INFORMATIONAL,DIAGNOSTIC'
      severity: '>=30 AND <90'
      messageIdsInclude: 'CPI1E92,CPF*'
      messageIdsExclude: 'CPF1234'
      messageText: 'detached'
  timeFrame: '10 MINUTES'
 

この例では、メッセージライブラリ QSYS およびメッセージキュー QSYSOPR 内のメッセージが以下の条件を満たす場合、 Detached Alert イベント名 のイベントがトリガーされます

  • メッセージはライブラリとキュー(ファイル configuration.yaml で定義されている)にあります
  • メッセージは または DIAGNOSTIC タイプ INFORMATIONAL です
  • このメッセージの重大度値は30から89の間です
  • メッセージIDは であるか、 CPI1E92CPF または で始まるが、 CPF1234
  • メッセージ本文に「detached」という文字列が含まれています
  • このメッセージは過去10分以内に送信されました
メトリック 説明 粒度
メッセージ ID このメッセージのメッセージ ID。 これが即時メッセージであるか、MESSAGE_TYPE が REPLY である場合は、NULL 値が入ります。 15 秒
メッセージ・タイプ メッセージのタイプ。 値は、COMPLETION、DIAGNOSTIC、ESCAPE、INFORMATIONAL、INQUIRY、NOTIFY、REPLY、REQUEST、SENDER です。 15 秒
重大度 メッセージに割り当てられた重大度。 15 秒
メッセージ・キュー・ライブラリー メッセージ待ち行列が入っているライブラリーの名前です。 15 秒
メッセージ待ち行列名 メッセージが入っているメッセージ待ち行列の名前。 15 秒
メッセージ・タイム・スタンプ メッセージが送信されたときのタイム・スタンプ。 15 秒
メッセージ・テキスト トークンを含むメッセージの第 1 レベル・テキスト、または即時メッセージ・テキスト。 MESSAGE_TYPE が REPLY の場合、またはメッセージ・ファイルにアクセスできなかった場合は、NULL 値が入ります。 15 秒
メッセージ第 2 レベル・テキスト トークンを含むメッセージの第 2 レベル・テキスト。 MESSAGE_ID が NULL の場合、メッセージに第 2 レベル・テキストがない場合、またはメッセージ・ファイルにアクセスできなかった場合は、NULL 値が入ります。 15 秒
メッセージ・キー メッセージに割り当てられているキー。 キーは、メッセージを送信するコマンドまたは API によって割り当てられます。 詳しくは、QMHRCVM API のメッセージ・タイプとメッセージ・キーを参照してください。 15 秒
注:IBM i センサーは、デフォルトでQSYS/OSYSOPRからのメッセージを収集します。収集対象は、メッセージのタイムスタンプに基づき、過去10分間の最初の20件のレコードに限定されます。 ただし、イベントの評価(例えば、 MESSAGE_QUEUE_ID_EVENT、および MESSAGE_QUEUE_TEXT_EVENT)においては、システムはUIに表示されているメッセージだけでなく、定義されたキュー内のすべてのメッセージを考慮します。

ヒストリー・ログ

ヒストリー・ログ内の各メッセージに関する情報。

Component Name: HISTORY_LOGS (カスタム・ポーリング率コンポーネント構成用)

メトリック 説明 粒度
メッセージ ID このメッセージのメッセージ ID。 これが即時メッセージであるか、MESSAGE_TYPE が REPLY である場合は、NULL 値が入ります。 15 秒
メッセージ・タイプ メッセージのタイプ。 値は、COMPLETION、DIAGNOSTIC、ESCAPE、INFORMATIONAL、INQUIRY、NOTIFY、REPLY、REQUEST、または SENDER です。 15 秒
重大度 メッセージに割り当てられている重大度。 15 秒
ユーザー メッセージが送信されたときのジョブの現行ユーザー。 15 秒
ジョブ メッセージが送信されたときの修飾ジョブ名。 15 秒
プログラム メッセージを送信したプログラム。 15 秒
メッセージ・タイム・スタンプ メッセージが送信されたときのタイム・スタンプ。 15 秒
メッセージ・テキスト トークンを含むメッセージの第 1 レベル・テキスト、または即時メッセージ・テキスト。 MESSAGE_ID が NULL の場合、またはメッセージ・ファイルにアクセスできなかった場合は、NULL 値が入ります。 15 秒
メッセージ第 2 レベル・テキスト トークンを含むメッセージの第 2 レベル・テキスト。 MESSAGE_ID が NULL の場合、メッセージに第 2 レベル・テキストがない場合、またはメッセージ・ファイルにアクセスできなかった場合は、NULL 値が入ります。 15 秒
注:IBM i センサーは、デフォルトで履歴ログ情報を収集します。 メッセージのタイムスタンプに基づき、過去10分間の最初の10件のレコードのみが収集対象となります。

ハードディスク情報(詳細)

以下の表は、 IBM i オペレーティング・システム 7.3 (Level-22)、 7.4 (Level-10)、およびそれ以降のバージョンのハード・ディスクに関する情報を示しています。

Component Name: DISK_STATUS この設定は、カスタムポーリングレートコンポーネントにのみ適用されます。

メトリック 説明 粒度
装置番号 ディスクの装置番号。 60 秒
リソース名 システムによって割り当てられた、ディスク装置の固有の名前。 60 秒
ASP番号 記憶域プール (ASP) 番号を指定します。 60 秒
ディスク・タイプ ディスクのディスク・タイプ番号。 60 秒
ユニット・メディア容量 Gb 単位のストレージ容量 (単位: 10 億バイト)。 60 秒
使用率(%) ディスクユニットの使用率。 60 秒
ディスク・モデル ディスクの型式番号。 60 秒
経過パーセントが使用中です 経過時間中にディスク装置が使用されている時間の推定パーセンテージ。 60 秒
1秒あたりの読み取り回数 経過時間中にディスクユニットからデータを読み取るための1秒あたりの平均リクエスト数。 60 秒
1秒あたりの書き込み回数 経過時間中にディスクユニットへのデータ書き込みが行われた1秒あたりの平均リクエスト数。 60 秒
1秒あたりのデータ読み取り量 経過時間中にディスクユニットから読み込まれた1秒あたりの平均データ量。 60 秒
1秒あたりの書き込みデータ量 経過時間中にディスクユニットへ書き込まれた1秒あたりの平均データ量。 60 秒
注:IBM i センサーは、使用済み領域の割合に基づいてHDD情報を収集しますが、収集されるレコード数は最初の20件に限定されます。

ハードディスク情報(基本)

以下の表は、 IBM i オペレーティング・システム 7.3 (Level-22)、 7.4 (Level-10)、およびそれ以降のバージョンのハード・ディスクに関する情報を示しています。

Component Name: DISK_STATUS この設定は、カスタムポーリングレートコンポーネントにのみ適用されます。

メトリック 説明 粒度
装置番号 ディスクの装置番号。 60 秒
ASP番号 記憶域プール (ASP) 番号を指定します。 60 秒
ディスク・タイプ ディスクのディスク・タイプ番号。 60 秒
ユニット・ストレージ容量 装置ストレージ容量は、構成されたディスク装置の装置メディア容量と同じ値です。 未構成の装置の場合、この値はゼロになります。 60 秒
使用率(%) ディスク装置の使用スペース (パーセント)。 60 秒
注:IBM i センサーは、使用済み領域の割合に基づいてHDD情報を収集しますが、収集されるレコード数は最初の20件に限定されます。

SSDに関する情報(詳細)

以下の表は、 IBM i OS バージョン 7.3 (Level-22)、 7.4 (Level-10) 以降を使用するソリッド・ステート・ディスクに関する情報を示しています。

Component Name: DISK_STATUS (カスタムポーリングレートコンポーネントの設定用)

メトリック 説明 粒度
装置番号 ディスクの装置番号です。 60 秒
リソース名 システムによって割り当てられた、ディスク装置の固有の名前。 60 秒
ストレージ容量 記憶域プール (ASP) の番号。 60 秒
使用率(%) ディスク装置によって消費されたパーセンテージ。 60 秒
シリアル番号 ディスク装置の製造番号です。 60 秒
ASP番号 記憶域プール (ASP) 番号。 60 秒
SSD 残存耐用量 SSD デバイスの残りの存続時間 (パーセンテージ)。 60 秒
SSD 電源オン日数 SSD デバイスがシステム上でアクティブな状態を維持する日数。 60 秒
SSD でサポートされる書き込みバイト数 SSD が物理的に書き込むと予想される存続時間のバイト数 (ギガバイト単位)。 60 秒
SSD 書き込みバイト数 この特定の SSD ディスク装置内の NAND メモリーに物理的に書き込まれる存続時間バイト数 (ギガバイト単位)。 60 秒
SSD 読み取り/書き込み保護 装置が読み取り保護または書き込み保護されている。 60 秒
SSD PFA 警告 ログに記録される事前障害分析警告メッセージ。 60 秒
1秒あたりの読み取り回数 経過時間中にディスクユニットからデータを読み取るための1秒あたりの平均リクエスト数。 60 秒
1秒あたりの書き込み回数 経過時間中にディスクユニットへのデータ書き込みが行われた1秒あたりの平均リクエスト数。 60 秒
1秒あたりのデータ読み取り量 経過時間中にディスクユニットから読み込まれた1秒あたりの平均データ量。 60 秒
1秒あたりの書き込みデータ量 経過時間中にディスクユニットへ書き込まれた1秒あたりの平均データ量。 60 秒
注:IBM i センサーは、使用済み領域の割合に基づいてSSD情報を収集しますが、収集されるレコードは最初の20件に限定されます。

ソリッドステートドライブに関する情報(基本)

以下の表は、 IBM i OS バージョン 7.2、 7.3 (Level-22)、および 7.4 (Level-10) のソリッド・ステート・ディスクに関する情報を示しています。

Component Name: DISK_STATUS (カスタムポーリングレートコンポーネントの設定用)

メトリック 説明 粒度
装置番号 ディスクの装置番号です。 60 秒
ASP番号 記憶域プール (ASP) の番号。 60 秒
ディスク・タイプ ディスクのディスク・タイプ番号。 60 秒
ユニット・ストレージ容量 構成済みディスク装置の場合には, 装置記憶容量は装置媒体容量と同じ値になります。 非構成装置の場合には, この値は 0 です。 60 秒
使用率(%) ディスク装置使用率 (%)。 60 秒
注:IBM i センサーは、使用済み領域の割合に基づいてSSD情報を収集しますが、収集されるレコードは最初の20件に限定されます。

不揮発性メモリ・エクスプレス

以下の表は、 IBM i OS バージョン 7.4 (Level-10) 以降での不揮発性メモリーに関する情報を示しています。

Component Name: NON_揮発性 le_memory (カスタム・ポーリング・レート・コンポーネント構成用)

メトリック 説明 粒度
リソース名 NVMe デバイスのリソース名です。 60 秒
型式番号 装置の製造メーカーによって割り当てられた型式番号。 60 秒
残り寿命 メーカーによって割り当てられたままの NVMe デバイス存続時間のパーセンテージ。 60 秒
予備容量 この NVMe デバイスに使用可能な残りの予備容量のパーセンテージ (0 から 100)。 60 秒
予備容量のしきい値 この NVMe デバイスのスペア容量のしきい値パーセンテージ (0 から 100)。 60 秒
使用される名前空間 使用される名前空間の数量。 60 秒
電源サイクル NVMe デバイスの電源がオン/オフになっている回数。 60 秒
電源オン時間 NVMe デバイスの電源がオンになっている時間数。 60 秒
メディア・エラー コントローラーがリカバリーされていないデータ保全性エラーを検出した回数。 60 秒
アンセーフ・シャットダウン シャットダウン通知が送信されずに電源喪失が発生した回数。 60 秒
ファームウェア・レベル NVMe デバイスで実行されているコードのレベル。 60 秒
注:IBM i センサーは、使用済み領域の割合に基づいて、最初の20件に限定してNVMe情報を収集します。

ディスク全体の状態

以下の表に、 IBM i OS バージョン 7.4 以降での全体的なディスク状況に関する情報を示します。

Component Name: DISK_STATUS (カスタムポーリングレートコンポーネントの設定用)

カスタムイベント: DISK_STATUS_EVENT Event NameInstana エージェントの設定ファイルのセクション user_specification:diskStatus:operationalState で、カンマ区切りで複数の予想 Disk Status 値を指定できます。 パーティション内のディスク(HDD/SSD)のいずれかが所定の状態にない Event Name 場合、このイベントが発生します。

注: このイベントは、 IBM i OSのバージョン 7.4 以降で適用されます。
メトリック 説明 粒度
リソース名 システムによって割り当てられた、ディスク装置の固有の名前。 60 秒
使用率(%) ディスクユニットの使用率。 60 秒
ディスク・タイプ ディスク・タイプ番号。 60 秒
装置番号 ディスクの装置番号です。 60 秒
ASP番号 記憶域プール (ASP) 番号。 60 秒
経過パーセントが使用中です 経過時間中にディスク装置が使用されている時間の推定パーセンテージ。 60 秒
1秒あたりの読み取り回数 経過時間中にディスクユニットからデータを読み取るための1秒あたりの平均リクエスト数。 60 秒
1秒あたりの書き込み回数 経過時間中にディスクユニットへのデータ書き込みが行われた1秒あたりの平均リクエスト数。 60 秒
1秒あたりのデータ読み取り量 経過時間中にディスクユニットから読み込まれた1秒あたりの平均データ量。 60 秒
1秒あたりの書き込みデータ量 経過時間中にディスクユニットへ書き込まれた1秒あたりの平均データ量。 60 秒
ディスク装置のタイプ ディスク装置のタイプ (SSD、HDD)。 60 秒
注:IBM i センサーは、使用済み領域の割合に基づいて、ディスク関連情報を収集します(最初の20件に限定されます)。 ただし、イベントの評価(例えば、 DISK_STATUS_EVENT)においては、システムはUIに表示されているディスクだけでなく、存在するすべてのディスクを考慮します。

セキュリティー・システム値

IBM i セキュリティシステムのポリシーは、監査、パスワード規則、オブジェクトの復元制限、ユーザー権限、セッション制限、および SSL / TLS ポリシーなどの重要なセキュリティ制御を定義し、適用することで、システムを保護するとともに、コンプライアンスとリスク管理を支援します。

Component Name: SYSTEM_VALUE_INFO

メトリック 説明 粒度
システム値の名前 特定のシステム構成またはセキュリティ制御を表す、一意の IBM i 識別子。 10 分
説明 システム値の説明。 10 分
システム値 IBM i システムで設定されている、アクティブな動作を決定する現在の値。 10 分
出荷時のデフォルト値 システムのインストール時または初期化時に、 IBM i によって提供される元のデフォルト値。 10 分

トラブルシューティング

IBM i センサーの使用中に発生する可能性のある一般的な問題のトラブルシューティング方法をご覧ください。

No X11 DISPLAY 変数が設定されました

以下のエラーメッセージの例をご覧ください:

2025-06-25T13:43:28.190-07:00 | ERROR | fd2-0719-4f71-b094-2063cbbe0b2d) | IbmISeries       | com.instana.sensor-ibmiseries - 1.0.63 | Something went wrong with DB2 on IBM i Series sensor configuration for host: <host>. Error message:
No X11 DISPLAY variable was set, but this program performed an operation which requires it.
 

このエラーメッセージは、ホストへの接続に使用されているユーザープロファイルに問題があることを示しています。 この問題を解決するには、以下の点を確認してください:

  • ホスト用に指定されたユーザープロファイルとパスワードは正しいです。
  • ユーザープロファイルのパスワードは有効期限が切れていません。
    • そのためには、そのプロファイルでシステムにサインインしてみてください。 パスワードの有効期限が切れている場合は、新しいパスワードの設定を求められます。
    • あるいは、コマンドを実行 DSPUSRPRF <profile> し、が有効な将来 Date password expires の日付を表示していることを確認してください。
  • ユーザープロファイルが有効になっています。
    • これを行うには、コマンド DSPUSRPRF <profile> を実行し、フィールド Status がに設定されている *ENABLEDことを確認してください。

Db2 データが欠落しています

以下のエラーメッセージの例をご覧ください:

2025-06-17T10:47:12.654+02:00 | ERROR | ana-global-scheduler-thread-4-25 | b2DataRepository | com.instana.sensor-ibmiseries - 1.0.62 | host: <host>, Error while obtaining Record data for collection service library QPFRDATA and file name QAPMSQLPC: CPF3012 File QAPMSQLPC in library QPFRDATA not found.
 

このエラーは、システムでパフォーマンス収集サービスが有効になっているものの、 Db2 のメトリクスを収集するための設定が適切に行われていないことを示しています。 この問題を解決するには、以下の点を確認してください:

回収サービスのプロファイルは、または *STANDARD である必要があります *STANDARDP。 確認するには、CL CFGPFRCOL コマンドを実行し、プロンプトが表示されるまで F4 待ちます。 「 デフォルトのコレクションプロファイル 」フィールドを確認してください。 詳細については、 「 IBM i における Db2 の監視 」を参照してください。

デフォルトの収集プロファイルが に設定されている場合は、 IBM Navigator*CUSTOM を参照し、そのプロファイルに カテゴリ SQL が追加されていることを確認してください。 詳細については、 「コレクション サービスのカスタム プロファイルの作成」 を参照してください。