Surveillance de Tibco EMS

Le capteur TIBCO EMS est automatiquement déployé et installé une fois que vous avez installé l'agent d' Instana.

Informations de support

Pour vous assurer que le capteur TIBCO EMS est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Versions prises en charge et politique d'assistance

Le capteur prend en charge les versions suivantes de TIBCO EMS :

  • 8.3.x
  • 8.4.x
  • 8.5.x
  • 8.6.x

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
TIBCO EMS (Service de messagerie d'entreprise) A la demande 10.4.0 8.6.x

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

Configuration

Le taux d'interrogation de remplacement des métriques est de 5 secondes. Vous pouvez modifier le taux d'interrogation dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.tibcoems:
  poll_rate: 5  # seconds
 
Remarque : si vous réduisez la fréquence d'interrogation, l'utilisation du processeur par le processus TIBCO EMS augmentera.

Si l'instance requiert une autorisation utilisateur/mot de passe, vous devez également les configurer dans le fichier de configuration de l'agent.

com.instana.plugin.tibcoems:
  user: ''      # default is 'admin'
  password: ''
 

L'agent Instana va automatiquement essayer de résoudre le nom d'hôte et le port à partir du fichier de configuration de Tibco EMS. Si un nom d'hôte et un port personnalisés doivent être utilisés, vous pouvez les configurer dans le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.tibcoems:
  hostname: '' # optional
  port: ''     # optional

 

La configuration de la surveillance de plusieurs instances TIBCO EMS est possible via les paramètres de configuration de l'environnement de traitement et des fichiers.

Remarque : Les droits minimum requis pour accéder aux métriques d'un utilisateur non administrateur sont les suivants :

  • view-destination
  • view-server

Pour attribuer ces privilèges à un utilisateur, exécutez les commandes suivantes dans l'outil en ligne de commande tibemsadmin :

grant admin user=${username} view-destination
grant admin user=${username} view-server
 

Pour configurer les rubriques et les files d'attente à surveiller, spécifiez des expressions correspondantes dans le fichier de configuration d'agent <agent_install_dir>/etc/instana/configuration.yaml. Par exemple :

com.instana.plugin.tibcoems:
   queuesRegex: 'bar.>'
   topicsRegex: 'foo.>'
 

Pour plus d'informations sur l'utilisation des caractères génériques pour sélectionner des files d'attente et des sujets, consultez la documentation officielle de TIBCO EMS

Activer les statistiques

Pour collecter des mesures, l'agent requiert que les statistiques soient activées.

Ajoutez la ligne suivante au fichier tibemsd.conf et redémarrez le serveur :

statistics = enabled
 

Vous pouvez également utiliser tibemsadmin et exécuter la commande suivante :

set server statistics=enabled
 

Fourniture des pilotes

Lorsque l'agent démarre et reconnaît un serveur Tibco EMS où le pilote n'a pas été fourni, l'agent consigne ce message :

Cannot monitor Tibco EMS without the following drivers: tibjms-<version>.jar, tibjmsadmin-<version>.jar
For licensing reasons they cannot be provided by Instana and
need to be manually obtained and added to the agent
 

Généralement, les pilotes sont disponibles dans les fichiers <tibco installation dir>/lib/tibjms.jar et <tibco installation dir>/lib/tibjmsadmin.jar .

Pour ajouter les pilotes à l'agent, ajoutez-les aux emplacements suivants, respectivement <agent_install_dir>/system/com/tibco/tibjms/tibjms/<version>/tibjms-<version>.jar et <agent_install_dir>/system/com/tibco/tibjms/tibjmsadmin/<version>/tibjmsadmin-<version>.jar.

Collecte des métriques

Pour consulter les métriques, sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana, cliquez sur un hôte surveillé spécifique, puis vous verrez s'afficher un tableau de bord de l'hôte contenant toutes les métriques collectées et les processus surveillés.

Données de configuration

  • Nom du serveur
  • Version
  • PID
  • Heure de début / Temps d'activité
  • Ports
  • Etat
  • Nombre max de connexions
  • Rubriques
  • Files d'attente

Métriques de performance

Serveur

Métrique Description Granularité
Connexions Nombre total de connexions sur le serveur, collecté à partir de ServerInfo. 1 seconde
Sessions Nombre total de sessions sur le serveur, collecté à partir de ServerInfo. 1 seconde
Durables Nombre total d'éléments durables sur le serveur, collecté à partir de ServerInfo. 1 seconde
Taux d'opérations de lecture Nombre d'opérations de lecture par seconde sur le serveur, collecté à partir de ServerInfo. 1 seconde
Taux d'opérations d'écriture Nombre d'opérations d'écriture par seconde sur le serveur, collecté à partir de ServerInfo. 1 seconde
Nombre de messages en attente Nombre total de messages en attente sur le serveur, collecté à partir de ServerInfo. 1 seconde
Taille des messages en attente Taille totale des messages en attente sur le serveur, collecté à partir de ServerInfo. 1 seconde
Mémoire des messages Quantité de mémoire utilisée pour stocker les messages sur le serveur, collecté à partir de ServerInfo. 1 seconde
Nombre de messages entrants Nombre total de messages entrants sur le serveur, collecté à partir de ServerInfo. 1 seconde
Nombre de messages sortants Nombre total de messages sortants sur le serveur, collecté à partir de ServerInfo. 1 seconde
Débit des messages entrants Nombre de messages entrants par seconde sur le serveur, collecté à partir de ServerInfo. 1 seconde
Débit des messages sortants Nombre de messages sortants par seconde sur le serveur et collectés à partir de ServerInfo. 1 seconde

Rubriques

Métrique Description Granularité
Abonnés Nombre total d'abonnés à la rubrique, collecté à partir de TopicInfo. 1 seconde
Nombre de messages en attente Nombre total de messages en attente sur la rubrique, collecté à partir de TopicInfo. 1 seconde
Taille des messages en attente Taille totale des messages en attente sur la rubrique, collectée à partir de TopicInfo. 1 seconde
Nombre de messages entrants Nombre total de messages entrants dans la rubrique, collecté à partir de TopicInfo. 1 seconde
Nombre de messages sortants Nombre total de messages sortants dans la rubrique, collecté à partir de TopicInfo. 1 seconde
Débit des messages entrants Nombre de messages entrants par seconde dans la rubrique, collecté à partir de TopicInfo. 1 seconde
Débit des messages sortants Nombre de messages sortants par seconde dans la rubrique, collecté à partir de TopicInfo. 1 seconde

Files d'attente

Métrique Description Granularité
Récepteurs Nombre total de récepteurs dans la file d'attente, collecté à partir de QueueInfo. 1 seconde
Nombre de messages en attente Nombre total de messages en attente dans la file d'attente, collecté à partir de QueueInfo. 1 seconde
Taille des messages en attente Taille totale des messages en attente dans la file d'attente, collecté à partir de QueueInfo. 1 seconde
Nombre de messages entrants Nombre total de messages entrants dans la file d'attente, collecté à partir de QueueInfo. 1 seconde
Nombre de messages sortants Nombre total de messages sortants dans la file d'attente, collecté à partir de QueueInfo. 1 seconde
Débit des messages entrants Nombre de messages entrants par seconde dans la file d'attente, collecté à partir de QueueInfo. 1 seconde
Débit des messages sortants Nombre de messages sortants par seconde dans la file d'attente, collecté à partir de QueueInfo. 1 seconde

Signatures d'intégrité

Pour chaque capteur, il existe une base de connaissances des signatures d'intégrité qui sont évaluées en permanence par rapport aux métriques entrantes et qui sont utilisées pour traiter les problèmes ou les incidents en fonction de l'impact sur l'utilisateur.

Les événements intégrés déclenchent des tickets ou des incidents en cas de signatures d'intégrité défaillantes sur des entités, tandis que les événements personnalisés déclenchent des tickets ou des incidents en fonction des seuils définis pour les métriques individuelles d'une entité donnée.

Pour plus d'informations sur les événements intégrés de TIBCO EMS, consultez le guide de référence des événements intégrés.