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:
- Dans le menu de navigation, cliquez sur Infrastructure.
- Localisez la zone de disponibilité que vous avez définie dans le fichier de configuration. La zone de disponibilité est définie sur
Tuxedo Domainspar défaut. - 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 fichierconfiguration.yamlde l'agent avec le paramètre tuxuser.
/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
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 ».