Monitoring Oracle Tuxedo

Supported information

Configuring

The Oracle Tuxedo sensor monitors the Tuxedo runtime application by querying data from the Management Information Base (MIB). The data is queried from the MIB with the ud32 and tmadmin command-line utilities.

To collect monitoring data from Oracle Tuxedo, update the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml as shown in the following example:

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

Viewing metrics

To view the metrics, complete the following steps:

1. In the navigation menu, click Infrastructure.
2. Locate the availability zone that you defined in the configuration file. The availability zone is set to Tuxedo Domains by default.
3. Click the domain pillar in the availability zone.

You can see the domain dashboard with all the collected metrics for the selected Tuxedo domain.

Running Tuxedo sensor as a non-root user

You can run the Tuxedo sensor with the non-root Instana agent user on Tuxedo sensor 1.0.2 and later. The tuxedo sensor requires the permission to switch from the agent user to the Tuxedo user. To grant this permission for Tuxedo sensor, update the settings in the /etc/sudoers file if the agent user is not set to root. The agent user runs the tuxedoShell.sh script with different Tuxedo users as shown in the following snippet:

_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

where:

• _agentuser_ is the Instana agent user.

• _tuxuser1_, _tuxuser2_, and _tuxuser3_ are Tuxedo users that are defined in the agent configuration.yaml file with the parameter tuxuser.

If multiple Tuxedo users are there for multiple Tuxedo domains, then all these users must be added in /etc/sudoers file to monitor the corresponding Tuxedo domains.

The Instana agent user can run the tuxedoShell.sh script as any other users with the setting (ALL) in /etc/sudoers file as shown in the following snippet:

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

Use the absolute path of the Instana agent tmp directory and a wildcard as the path of the tuxedoShell.sh script. Usually, the Instana agent tmp directory is in the data directory of the directory where the Instana host agent is installed.