Surveillance d' Oracle Tuxedo

Oracle Tuxedo (Transactions for Unix Extended for Distributed Operations) est un serveur d'applications d'entreprise compatible avec divers systèmes et langages de programmation. Instana utilise le capteur Tuxedo de Oracle pour surveiller le Tuxedo de Oracle.

Le capteur Tuxedo d' Oracle ne prend en charge que la surveillance locale; vous devez donc installer l'agent Instana sur votre serveur Tuxedo. Une fois l'agent hôte d' Instana s installé, le capteur Tuxedo d' Oracle s est automatiquement installé. Une fois la configuration terminée, comme indiqué dans la section « Configuration », vous pouvez consulter les indicateurs relatifs à Tuxedo d' Oracle dans l'interface utilisateur d' Instana.

Informations de support

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

Systèmes d'exploitation pris en charge

Le capteur est compatible avec les systèmes d'exploitation suivants :

  • AIX 7.2
  • SUSE 12 SP5 x86_64
  • RHEL 7.9 x86_64

Versions prises en charge et politique d'assistance

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
Oracle Smoking A la demande 22.1.1 22.1.1

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

Configuration

Le détecteur Oracle Tuxedo surveille l'application d'exécution Tuxedo en interrogeant les données de la base d'informations de gestion (MIB). Les données sont interrogées à partir de la base d'informations de gestion à l'aide des utilitaires de ligne de commande ud32 et tmadmin .

Pour collecter des données de surveillance à partir d' Oracle Tuxedo, mettez à jour le fichier de configuration de l'agent <agent_install_dir>/etc/instana/configuration.yaml comme illustré dans l'exemple suivant:

com.instana.plugin.tuxedo:
  # Oracle Tuxedo
  enabled: true
  poll_rate: 60 # The mininum poll rate is 60 seconds, the default is 60 seconds.
  tuxdir: <INSERT_TUXEDO_SERVER_INSTALL_DIR_HERE> # The default full qualified path of Oracle Tuxedo installation directory
  tuxuser: <INSERT_OS_ACCOUNT_OF_TUXEDO_DOMAIN_HERE> # The default Unix/Linux account of the Tuxedo domains
  availabilityZone: <INSERT_AVAILABILITYZONE_HERE> # The default availability zone of the Tuxedo Domains
  domains:
    - tuxconfig: <INSERT_TUXCONFIG_OF_FIRST_DOMAIN_HERE> # The full qualified path to the binary configuration file of the Tuxedo domain
      tuxdir: <INSERT_TUXEDO_SERVER_INSTALL_DIR_HERE> # The optional parameter to specify the Tuxedo installation directory if it is different from the default setting.
      tuxuser: <INSERT_OS_ACCOUNT_OF_TUXEDO_DOMAIN_HERE> # The optional parameter to specify the Unix/Linux account of the Tuxedo domain if it is different from the default setting.
      availabilityZone: <INSERT_AVAILABILITYZONE_HERE> # The optional parameter to specify a zone for this Tuxedo domain if it is different from the default setting.
    - tuxconfig: <INSERT_TUXCONFIG_OF_SECOND_DOMAIN_HERE> # The full qualified path to the binary configuration file of the Tuxedo domain

Affichage des mesures

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

  1. Dans le menu de navigation, cliquez sur Infrastructure.
  2. Localisez la zone de disponibilité que vous avez définie dans le fichier de configuration. La zone de disponibilité est définie sur Tuxedo Domains par défaut.
  3. Cliquez sur le pilier de domaine dans la zone de disponibilité.

Vous pouvez voir le tableau de bord de domaine avec toutes les métriques collectées pour le domaine Tuxedo sélectionné.

Domaine Tuxedo

Le capteur Tuxedo d' Oracle recueille les informations de configuration et les métriques du domaine Tuxedo.

Données de configuration

Le tableau suivant présente les détails de configuration du domaine Tuxedo :

Détails du domaine Description
Nom de domaine Nom du domaine. Le nom doit être unique.
ID de domaine Identificateur du domaine.
TUXCONFIG Fichier de configuration binaire du domaine Tuxedo.
IPCKEY Clé numérique de l'adresse connue dans le tableau d'affichage du système.
TUXDIR Répertoire d'installation du serveur Tuxedo.

Métriques de performance

Le tableau suivant présente les détails des indicateurs du domaine Tuxedo :

Métrique de domaine Description
numOfSvrs Nombre de serveurs
numOfSvcs Nombre de services
numOfReqQue Nombre de files d'attente de demandes
numOfSrvGrps Nombre de groupes de serveurs
numOfIntfs Nombre d'interfaces
totalIPCQnum Nombre total de messages IPC dans les files d'attente

Machine Tuxedo

Le capteur Tuxedo d' Oracle recueille les informations de configuration et les métriques de la machine Tuxedo.

Données de configuration

Le tableau suivant présente les détails de configuration de la machine Tuxedo :

Détails de la machine Description
Pmid Identifiant de machine physique
lmid Identificateur de machine logique
état Etat de la machine dans le domaine
rôle Rôle de la machine dans le domaine

Métriques de performance

Le tableau suivant présente les détails des métriques de la machine Tuxedo :

Métrique de la machine Description
stateMetric Etat de la machine: 1- ACTIVE, 2- INACTIVEet 3- PARTITIONED
currLoad La charge de service en cours a été mise en file d'attente sur cette machine.
curAccessers Nombre de clients et de serveurs qui accèdent actuellement à l'application.
hwAccessers Nombre élevé de clients et de serveurs accédant à l'application.
numReq Nombre d'opérations tpacall () ou tpcall () effectuées à partir de cette machine.
wkCompleted Nombre total de charges de service qui sont correctement mises en file d'attente et traitées par les serveurs s'exécutant sur cette machine.
wkInitiated Nombre total de charges de service mises en file d'attente par les clients ou les serveurs exécutés sur cette machine.
numDequeue Nombre d'opérations tpdequeue () effectuées à partir de cette machine.
numEnqueue Nombre d'opérations tpenqueue () effectuées à partir de cette machine.
totalQnum Nombre total de messages IPC actuellement dans les files d'attente.

File d'attente Tuxedo IPC

Le capteur Tuxedo d' Oracle recueille les informations de configuration et les métriques de la file d'attente IPC Tuxedo.

Données de configuration

Le tableau suivant présente les détails de configuration de la file d'attente IPC :

Détails de la file d'attente IPC Description
identificateur Identificateur de la file d'attente de messages du système UNIX
senderSrv Nom du dernier processus ayant écrit dans la file d'attente
receiverSrv Nom du dernier processus qui a lu la file d'attente
senderPID Identificateur du dernier processus ayant écrit dans la file d'attente
receiverPID Identificateur du dernier processus lu à partir de la file d'attente

Métriques de performance

Le tableau suivant présente les détails des métriques de la file d'attente IPC :

Détails de la file d'attente IPC Description
octet Nombre d'octets actuellement dans la file d'attente
qnum Nombre de messages dans la file d'attente
utilisation Utilisation de la file d'attente en pourcentage

Serveur Tuxedo

Le capteur Tuxedo d' Oracle recueille les informations de configuration et les métriques du serveur Tuxedo.

Données de configuration

Le tableau suivant présente les détails de configuration du serveur Tuxedo :

Détails du serveur Description
Id Identificateur unique du serveur dans le groupe
nom Nom du fichier exécutable du serveur
grpName Nom de groupe associé au groupe du serveur
grpNo Numéro de groupe associé au groupe du serveur
lmid Identificateur de la machine logique sur laquelle le serveur s'exécute
PID Identificateur de processus du serveur
état Etat du serveur

Métriques de performance

Le tableau suivant présente les détails des indicateurs du serveur Tuxedo :

Détails du serveur Description
stateMetric Etat du serveur: 1- ACTIVE, 2- INACTIVE, 3- MIGRATING, 4- CLEANING, 5- RESTARTING, 6- SUSPENDED, 7- EXITING, 8- PARTITIONEDet 9- DEAD
numCompleted Nombre total de demandes traitées par ce serveur
numQueued Nombre de demandes lancées par ce serveur qui sont toujours actives

Service

Le capteur Tuxedo d' Oracle recueille les informations relatives à la configuration et aux métriques du service Tuxedo.

Données de configuration

Le tableau suivant présente les détails de configuration du service Tuxedo :

Détails du service Description
nom Nom du service
état Etat du service
Métriques de performance

Le tableau suivant présente les détails des indicateurs du service Tuxedo :

Détails du service Description
stateMetric Etat du service: 1- ACTIVEet 2- INACTIVE
numCompleted Nombre de demandes de service terminées. Les demandes de service sont renvoyées uniquement lorsque LDBAL est défini sur Y.
numQueued Nombre de demandes actuellement mises en file d'attente pour ce service. Ces demandes sont renvoyées uniquement lorsque LDBAL est défini sur Y.

Exécuter le capteur Tuxedo en tant qu'utilisateur non root

Vous pouvez exécuter le capteur Tuxedo avec l'utilisateur non-root « Instana » sur les versions 1.0.2 et ultérieures du capteur Tuxedo. Le détecteur Tuxedo requiert le droit de passer de l'utilisateur de l'agent à l'utilisateur Tuxedo. Pour accorder ce droit au détecteur Tuxedo, mettez à jour les paramètres dans le fichier /etc/sudoers si l'utilisateur de l'agent n'est pas défini sur root. L'utilisateur de l'agent exécute le script tuxedoShell.sh avec différents utilisateurs Tuxedo, comme indiqué dans le fragment suivant:

_agentuser_ ALL=(_tuxuser1_)       NOPASSWD:SETENV:/home/agentuser/instana-agent/data/tmp/*/tuxedoShell.sh
_agentuser_ ALL=(_tuxuser2_)       NOPASSWD:SETENV:/home/agentuser/instana-agent/data/tmp/*/tuxedoShell.sh
_agentuser_ ALL=(_tuxuser3_)       NOPASSWD:SETENV:/home/agentuser/instana-agent/data/tmp/*/tuxedoShell.sh

où :

  • _agentuser_ est l'utilisateur de l'agent d' Instana.

  • _tuxuser1_, _tuxuser2_et _tuxuser3_ sont des utilisateurs Tuxedo définis dans le fichier configuration.yaml de l'agent avec le paramètre tuxuser.

Remarque : si plusieurs utilisateurs Tuxedo sont présents pour plusieurs domaines Tuxedo, tous ces utilisateurs doivent être ajoutés dans /etc/sudoers le fichier afin de surveiller les domaines Tuxedo correspondants.

L'utilisateur de l'agent « Instana » peut exécuter le tuxedoShell.sh script comme n'importe quel autre utilisateur si le paramètre (ALL) est défini dans /etc/sudoers le fichier, comme le montre l'extrait de code suivant :

_agentuser_ ALL=(ALL)       NOPASSWD:SETENV:/home/agentuser/instana-agent/data/tmp/*/tuxedoShell.sh
Remarque : utilisez le chemin d'accès absolu du répertoire de tmp l'agent d' Instana et un caractère générique comme chemin d'accès au tuxedoShell.sh script. En général, le répertoire tmp de l'agent « Instana » se trouve dans le data répertoire où est installé l'agent hôte « Instana ».