Surveillance des instances IBM i

Le capteur prend en charge la surveillance locale des versions d' IBM i 7.4. et ultérieures.

Le capteur prend en charge la surveillance à distance des modèles d' IBM i 7.3. et ultérieurs.

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Pour surveiller IBM i en local, vous devez d'abord installer l'agent hôte Instana sur IBM i. Pour plus d'informations, consultez la section « Installation de l'agent hôte » sur IBM i.

Lorsque vous installez et exécutez l'agent hôte, celui-ci découvre automatiquement les processus et démarre le capteur avec les configurations par défaut. Pour plus d'informations sur la configuration de l'agent hôte, consultez la section « Configuration de l'agent hôte ».

Un exemple de configuration pour la surveillance locale est présenté dans l'exemple suivant :

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'
 

Pour commencer à surveiller à distance les instances d' IBM i, vous devez d'abord installer l'agent Instana adapté à votre système d'exploitation. Pour plus d'informations, consultez la section « Installation des agents hôtes ». Ensuite, configurez le fichier de configuration de l'agent suivant <agent_install_dir>/etc/instana/configuration.yaml.

• Reportez-vous à la section « Autorisations utilisateur » pour connaître les autorisations requises pour le profil utilisateur « Instana ».

• La zone sslEnabled est facultative. Cela n'est nécessaire que lorsque vous souhaitez établir une connexion sécurisée avec le composant hôte.

• Si sslEnabled est défini sur true, vous devez importer votre certificat de confiance dans le répertoire cacerts (jvm/jre/lib/security/cacerts) de votre JRE à l'aide de la commande keytool :

  keytool -import -alias ALIAS_NAME -keystore "/path/to/jre/cacerts" -file
  YOUR_CERTIFICATE_NAME.crt
   

• Si un mot de passe vous est demandé, entrez le mot de passe par défaut changeit.

Voir l'exemple de configuration suivant pour la surveillance à distance :

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'
 

IBM i 7.6 introduit l'authentification multifactorielle (MFA) pour les profils utilisateur. Ces comptes nécessitent un mot de passe à usage unique basé sur le temps (TOTP) en plus du mot de passe de l'utilisateur pour la connexion. Le profil utilisateur défini dans la configuration utilisateur ne doit pas avoir l'authentification multifactorielle (MFA) activée. En effet, le capteur peut redémarrer (par exemple, lors d'une mise à jour dynamique de l'agent) et devoir se reconnecter; à ce moment-là, tout code TOTP fourni précédemment aurait expiré. Les profils utilisateur qui ne nécessitent pas de TOTP continueront de fonctionner normalement, même si l'authentification multifactorielle (MFA) est activée sur le système. Pour plus d'informations, consultez le site du ministère des Affaires étrangères.

• Nom d'hôte
• Version du système
• Total UC
• Mémoire totale
• UC configurée
• Mémoire configurée
• ID de partition
• Nombre de partitions
• État restreint

Consultez l'exemple de message d'erreur suivant :

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.
 

Ce message d'erreur indique qu'il y a un problème avec le profil utilisateur utilisé pour se connecter à l'hôte. Pour résoudre le problème, assurez-vous que :

• Le profil utilisateur et le mot de passe fournis pour l'hôte sont corrects.
• Le mot de passe du profil utilisateur n'a pas expiré.
  • Pour ce faire, essayez de vous connecter au système avec ce profil. Si le mot de passe a expiré, vous serez invité à en créer un nouveau.
  • Vous pouvez également exécuter la commande DSPUSRPRF <profile> et vérifier que affiche Date password expires une date future valide.
• Le profil utilisateur est activé.
  • Pour ce faire, exécutez la commande DSPUSRPRF <profile> et vérifiez que le Status champ est défini sur *ENABLED.

Consultez l'exemple de message d'erreur suivant :

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.
 

Cette erreur indique que les services de collecte de performances sont activés sur le système, mais qu'ils ne sont pas correctement configurés pour recueillir les métriques d' Db2. Pour résoudre le problème, assurez-vous que :

Le profil des services de recouvrement doit être *STANDARD ou *STANDARDP. Pour vérifier, exécutez la commande CFGPFRCOL CL et appuyez sur F4 pour afficher l'invite. Cochez la case « Profil de collecte par défaut ». Pour plus d'informations, consultez la page « Surveillance d' Db2 » sur IBM i.

Si le profil de collecte par défaut est défini sur *CUSTOM, assurez-vous que la SQL catégorie est ajoutée au profil à l'aide de la commande IBM Navigator pour i. Pour plus d'informations, consultez la section « Création d'un profil personnalisé pour les services de collecte ».