IBM MQ Managed File Transfer de surveillance

Une fois l'agent hôte d' Instana s installé, le capteur MFT ( IBM MQ Managed File Transfer ) est automatiquement installé, mais vous devez configurer ce capteur MFT d' IBM MQ s comme indiqué dans cette rubrique. Vous pouvez ensuite consulter les indicateurs liés à la solution MFT d' IBM MQ dans l'interface utilisateur d' Instana.

Informations de support

Pour vous assurer que le capteur d' IBM MQ Managed File Transfer s est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Systèmes d'exploitation pris en charge

Les systèmes d'exploitation pris en charge par le capteur MFT d' IBM MQ sont conformes aux exigences des agents hôtes; vous pouvez les consulter dans la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, par exemple dans la section « Systèmes d'exploitation pris en charge » d' Linux.

Versions prises en charge et politique d'assistance

Le capteur prend en charge les versions 1.0 et ultérieures d' IBM MQ MFT 9.0.0, qui sont installées sur toutes les plateformes prises en charge par IBM MQ MFT. Pour plus d'informations, consultez la section « Composants et fonctionnalités de IBM MQ ».

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

Technologie Politique de support Dernière version technologique Dernière version prise en charge
IBM MQ MFT A la demande 9.4.2.1 9.4.0.5

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

Informations complémentaires sur l'assistance

  • Instana ne prend en charge que la surveillance à distance pour une ou plusieurs instances. Chaque instance correspond à un gestionnaire de file d'attente de coordination, qui peut provenir soit de l'environnement traditionnel d' IBM MQ, soit d'un déploiement d' IBM Cloud Pak for Integration dans OpenShift.
  • La fonction de trace n'est pas prise en charge.

Configuration

Pour collecter les données de surveillance à distance d'un MFT d' IBM MQ, vous devez configurer les champs suivants dans le fichier de <agent_install_dir>/etc/instana/configuration.yaml configuration de l'agent comme suit :

L'instance du détecteur MFT se connecte au gestionnaire de files d'attente de coordination et au gestionnaire de files d'attente de commandes à l'aide des canaux de connexion serveur. Vérifiez que les configurations sont correctes. Vous pouvez vérifier cela en ajoutant les gestionnaires de file d'attente distants à partir de l'explorateur d' IBM MQ, et vous assurer que les connexions s'établissent correctement. Le nom d'instance doit respecter le format <COORDINATION_QUEUE_MANAGER_NAME>-<HOST> . Sinon, l'instance sera ignorée et non surveillée.

Consultez les configurations suivantes dans <agent_install_dir>/etc/instana/configuration.yaml:

# IBM MQ Managed File Transfer
com.instana.plugin.ibmmqmft:
  enabled: true
  poll_rate: 10 # Default is 10 seconds
    instances:
      <INSERT_INSTANCE_NAME_HERE>: # Your MFT instance name must be in <COORDINATION_QUEUE_MANAGER_NAME>-<HOST> format
        # transfer_expired_interval: 10 # How long recent completed transfers are retained in minutes.(optional)
        coordinationQueueManager:
          name: '<INSERT_COORDINATION_QUEUE_MANAGER_NAME_HERE>' # Coordination queue manager name
          host: '<INSERT_HOST_HERE>' # Coordination Queue Manager host
          port: <INSERT_PORT_HERE> # Remote server connection channel port
          channel: '<INSERT_CHANNEL_HERE>' # Remote server connection channel
          username: '<INSERT_USERNAME_HERE>' # User ID to connect to the remote queue manager (optional)
          password: '<INSERT_PASSWORD_HERE>' # User password to connect to remote queue manager (optional)
          keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled)
          keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled)
          cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled)
        commandQueueManager:
          name: '<INSERT_COMMAND_QUEUE_MANAGER_NAME_HERE>' # Command queue manager name
          host: '<INSERT_HOST_HERE>' # Command Queue Manager host
          port: <INSERT_PORT_HERE> # Remote server connection channel port
          channel: '<INSERT_CHANNEL_HERE>' # Remote server connection channel
          username: '<INSERT_USERNAME_HERE>' # User ID to connect to the remote queue manager (optional)
          password: '<INSERT_PASSWORD_HERE>' # User password to connect to remote queue manager (optional)
          keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled)
          keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled)
          cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled)
Remarque : le capteur MFT d' IBM MQ ne prend pas en charge la liaison locale lorsque vous vous connectez au gestionnaire de file d'attente d' IBM MQ. Si aucun nom d'utilisateur ni mot de passe n'est spécifié dans le configuration.yaml fichier, l'utilisateur utilisé dépend de la configuration du gestionnaire de file d'attente IBM MQ. Pour plus d'informations sur l'identifiant utilisateur utilisé par un canal de connexion au serveur, consultez la section « Contrôle d'accès pour les clients ».

Affichage des mesures

Pour consulter les indicateurs, sélectionnez « Infrastructure » dans la barre latérale de la console d' Instana, puis recherchez la zone « IBM MQ Managed File Transfer ».

Pour afficher les métriques, procédez comme suit:

  1. Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur la zone « IBM MQ Managed File Transfer ».

Vous pouvez ensuite trouver les instances MFT (Managed file transfer) surveillées pour le gestionnaire de files d'attente de coordination configuré si votre configuration est correcte.

Gestionnaire de file d'attente de coordination

Données de configuration

Détails du gestionnaire de file d'attente de coordination Description
Gestionnaire de file d'attente de coordination Nom du gestionnaire de file d'attente de coordination
Hôte Hôte du gestionnaire de files d'attente de coordination

Métriques de performance

Indicateur de gestion de la file d'attente de coordination Description
Transferts actifs actuels Nombre de transferts actifs en cours après l'activation de cette instance de capteur
Nombre total de transferts Nombre total de transferts après l'activation de cette instance de capteur

Statistiques de transfert

Statistiques de transfert Description
Transferts réussis Nombre de transferts réussis au cours du dernier intervalle de sondage
Transferts ayant échoué Nombre de transferts ayant échoué au cours du dernier intervalle de sondage
Transferts partiellement réussis Nombre de transferts partiellement réussis au cours du dernier intervalle de sondage
Annulé Nombre de virements annulés au cours du dernier intervalle de sondage

Agent MFT

Données de configuration

Détails de l'agent MFT Description
Type Type d'agent
Fuseau horaire Fuseau horaire de l'agent
Nombre maximal de transferts de la source Nombre maximal de transferts simultanés que l'agent source traite à tout moment
Nombre maximal de transferts de la destination Nombre maximal de transferts simultanés traités par l'agent de destination à un moment donné
Nombre maximal de transferts en file d'attente Nombre maximal de transferts en attente pouvant être mis en file d'attente par un agent jusqu'à ce que l'agent rejette une nouvelle demande de transfert
Nom Nom de l'agent MFT
Gestionnaire de file d'attente Nom du gestionnaire de files d'attente auquel l'agent MFT se connecte
Heure de début (UTC) Horodatage de démarrage en temps universel coordonné lors du démarrage de l'agent

Métriques de performance

Métrique d'agent MFT Description
Transferts source Nombre de transferts source via l'agent.
Transferts de destination Nombre de transferts de destination via l'agent.
Statut Statut de l'agent MFT.
Transferts en cours d'exécution Nombre de transferts en cours d'exécution via l'agent.
Nombre total de transferts en cours Nombre total de transferts en cours d'exécution via l'agent.
Nombre total de transferts arrivés à expiration Nombre total de transferts de délai d'attente via l'agent.
Nombre total de nouvelles tentatives de transfert Nombre total de nouvelles tentatives de transfert via l'agent.
Nombre total de transferts en attente de capacité d'agent Nombre total de transferts en attente de capacité d'agent.

Transfert de fichiers en cours

Données de configuration

Détails du transfert MFT Description
ID de transfert ID de transfert
Heure de début Horodatage du début du transfert
Agent source Nom de l'agent sur le système où se trouve le fichier source
Source QueueManager Nom du gestionnaire de files d'attente auquel l'agent source se connecte
Agent de destination Nom de l'agent sur le système vers lequel vous souhaitez transférer le fichier
Destination : QueueManager Nom du gestionnaire de files d'attente auquel l'agent de destination se connecte
Emetteur L'émetteur qui déclenche le transfert
Statut Statut en cours du transfert
Fichier actuel Chemin source du fichier en cours de transfert
Progression Progression du transfert. Par exemple, 2 fichiers doivent être transférés. Si le premier fichier a été transféré, la progression est indiquée sous la forme 1/2. Ensuite, si le premier transfert de fichier est terminé et que le deuxième transfert de fichier démarre, la progression s'affiche sous la forme 2/2.

Métriques de performance

Métrique de transfert MFT Affichage de l'interface utilisateur Description
elapsedSeconds Temps écoulé (s) Nombre de secondes nécessaires pour transférer ces octets
statsTransferredBytes Transféré (b) Nombre d'octets copiés jusqu'à présent
bytesSent Octets envoyés Nombre d'octets copiés jusqu'à présent
currentItem Voir la remarque 1 Index de l'élément en cours de transfert
totalItems Voir la remarque 1 Nombre total d'éléments en cours de transfert
currentItemSize Total (b) Nombre total d'octets de l'élément en cours

Moniteur MFT

Données de configuration

Détails du moniteur MFT Description
Surveillance Nom du moniteur, unique pour cet agent
Agent Nom de l'agent sur lequel le moniteur de ressources est défini
Statut Etat du moniteur
Ressource La ou les ressources surveillées
Evénement déclencheur Condition de déclenchement du transfert associé au moniteur
Masque de fichiers Modèle de correspondance du nom de fichier
Taille de lot Nombre maximal de correspondances de déclencheur incluses dans un lot unique
Intervalle d'interrogation Intervalle de temps entre chaque vérification de la ressource par rapport à la condition de déclenchement

Événements intégrés

Vous pouvez voir les événements suivants:

  • IBM MQ L'agent MFT n'est pas démarré ou est inaccessible

    Lorsqu'un agent n'est pas à l'état Ready ou Active , cet événement est déclenché et associé à l'agent correspondant.

  • IBM MQ Le moniteur MFT n'est pas lancé

    Lorsqu'un moniteur de ressources MFT n'est pas à l'état started , cet événement est déclenché et associé au moniteur correspondant.

  • IBM MQ Échec du transfert de fichiers

    Lorsqu'un transfert de fichier échoue pour une raison quelconque, cet événement est déclenché et affiché dans le gestionnaire de files d'attente de coordination correspondant.