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)
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:
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
- 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
ReadyouActive, 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.