Oracle Tuxedo のモニター

Oracle Tuxedo( Unix 向けトランザクション、分散処理対応拡張版)は、さまざまなシステムやプログラミング言語に対応したエンタープライズ・アプリケーション・サーバーです。 Instana Oracle のTuxedoセンサーを使用して、 Oracle のTuxedoを監視します。

Oracle のTuxedoセンサーはローカル監視のみに対応しているため、Tuxedoサーバーに Instana エージェントをインストールする必要があります。 Instana ホストエージェントをインストールすると、 Oracle Tuxedoセンサーが自動的にインストールされます。 「設定 」セクションの手順に従って設定を完了すると、 Instana のUIで Oracle Tuxedoに関連するメトリクスを確認できるようになります。

サポート情報

Oracle のTuxedoセンサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください:

サポート対象のオペレーティング・システム

このセンサーは、以下のオペレーティングシステムに対応しています:

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

対応バージョンとサポート方針

以下の表は、最新のサポート対象バージョンとサポート方針を示しています:

テクノロジー サポート・ポリシー 最新バージョン サポートされる最新バージョン
Oracle タキシード オンデマンド 22.1.1 22.1.1

サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。

の構成

Oracle Tuxedo センサーは、管理情報ベース (MIB) からのデータを照会することによって、Tuxedo ランタイム・アプリケーションをモニターします。 データは、 ud32 および tmadmin コマンド行ユーティリティーを使用して MIB から照会されます。

Oracle Tuxedo からモニター・データを収集するには、以下の例に示すようにエージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yaml を更新します。

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

メトリックの表示

メトリックを表示するには、以下のステップを実行します。

  1. ナビゲーション・メニューで、 「インフラストラクチャー」をクリックします。
  2. 構成ファイルで定義したアベイラビリティー・ゾーンを見つけます。 アベイラビリティー・ゾーンは、デフォルトで Tuxedo Domains に設定されています。
  3. アベイラビリティー・ゾーンのドメイン・ピラーをクリックします。

ドメイン・ダッシュボードに、選択した Tuxedo ドメインについて収集されたすべてのメトリックが表示されます。

タキシード・ドメイン

Oracle のTuxedoセンサーは、Tuxedoドメインの設定およびメトリクスの詳細情報を収集します。

構成データ

次の表は、Tuxedoドメインの設定詳細を示しています:

ドメインの詳細 説明
ドメイン名 ドメインの名前。 この名前は固有でなければなりません。
ドメイン ID ドメインの ID。
TUXCONFIG Tuxedo ドメインのバイナリー構成ファイルです。
IPCKEY システム掲示板内のウェルノウン・アドレスの数字キー。
TUXDIR Tuxedo サーバーのインストール・ディレクトリー。

パフォーマンス・メトリック

次の表は、Tuxedoドメインのメトリックの詳細を示しています:

ドメイン・メトリック 説明
numOfSvrs サーバーの数
numOfSvcs サービス数
numOfReqQue 要求キューの数
numOfSrvGrps サーバー・グループの数
numOfIntfs インターフェースの数
totalIPCQnum キュー内の IPC メッセージの合計数

Tuxedo マシン

Oracle のTuxedoセンサーは、Tuxedoマシンの設定およびメトリクスの詳細情報を収集します。

構成データ

次の表は、Tuxedoマシンの構成詳細を示しています:

マシンの詳細情報 説明
PMID 物理マシン識別子
Lmid 論理マシン ID
状態 ドメイン内のマシンの状態
ロール ドメイン内のマシンの役割

パフォーマンス・メトリック

次の表は、Tuxedoマシンのメトリクスの詳細を示しています:

マシン・メトリック 説明
stateMetric マシンの状態 (1- ACTIVE、2- INACTIVE、および 3- PARTITIONED )。
currLoad このマシンでエンキューされている現在のサービス負荷。
curAccessers 現在アプリケーションにアクセスしているクライアントおよびサーバーの数。
hwAccessers アプリケーションにアクセスしているクライアントおよびサーバーの上限基準数。
numReq このマシンから実行された tpacall () 操作または tpcall () 操作の数。
wkCompleted このマシン上で実行されているサーバーによってデキューされ、正常に処理されたサービス負荷の合計。
wkInitiated このマシン上で実行されているクライアントまたはサーバーによってエンキューされたサービス負荷の合計。
numDequeue このマシンから実行される tpdequeue () 操作のカウント。
numEnqueue このマシンから実行される tpenqueue () 操作の数。
totalQnum 現在キューに含まれている IPC メッセージの総数。

Tuxedo IPC キュー

Oracle のTuxedoセンサーは、Tuxedo IPCキューの設定およびメトリクスの詳細情報を収集します。

構成データ

次の表は、IPCキューの設定詳細を示しています:

IPC キューの詳細 説明
id UNIX システム・メッセージ・キューの ID
senderSrv キューに書き込んだ最後のプロセスの名前
receiverSrv キューから読み取られた最後のプロセスの名前
senderPID キューに書き込んだ最後のプロセスの ID
receiverPID キューから読み取られた最後のプロセスの ID

パフォーマンス・メトリック

次の表は、IPCキューのメトリクスの詳細を示しています:

IPC キューの詳細 説明
CBYTE 現在キューにあるバイト数
キュー番号 キュー内のメッセージ数
使用量 キュー使用率 (%)

Tuxedo サーバー

Oracle のTuxedoセンサーは、Tuxedoサーバーの設定およびメトリクスの詳細情報を収集します。

構成データ

次の表は、Tuxedoサーバーの設定詳細を示しています:

サーバーの詳細 説明
ID グループ内のサーバーの固有 ID
名前 サーバー実行可能ファイルの名前
grpName サーバーのグループに関連付けられているグループ名
grpNo サーバーのグループに関連付けられているグループ番号
Lmid サーバーが実行されている論理マシンの ID
PID サーバーのプロセス ID
状態 サーバーの状態

パフォーマンス・メトリック

次の表は、Tuxedoサーバーのメトリクスの詳細を示しています:

サーバーの詳細 説明
stateMetric サーバーの状態: 1- ACTIVE、2- INACTIVE、3- MIGRATING、4- CLEANING、5- RESTARTING、6- SUSPENDED、7- EXITING、8- PARTITIONED、および 9- DEAD
numCompleted このサーバーによって完了された要求の合計数
numQueued このサーバーによって開始され、まだアクティブな要求の数

サービス

Oracle のTuxedoセンサーは、Tuxedoサービスの構成およびメトリクスの詳細情報を収集します。

構成データ

次の表は、Tuxedo サービスの構成の詳細を示しています:

サービスの詳細 説明
名前 サービスの名前
状態 サービスの状態
パフォーマンス・メトリック

次の表は、Tuxedo サービスのメトリクスの詳細を示しています:

サービスの詳細 説明
stateMetric サービスの状態 (1- ACTIVE、および 2- INACTIVE )
numCompleted 完了しているサービス要求の数。 サービス要求は、 LDBALYに設定されている場合にのみ返されます。
numQueued このサービスに現在エンキューされている要求の数。 これらの要求は、 LDBALYに設定されている場合にのみ返されます。

Tuxedoセンサーをroot以外のユーザーとして実行する

Tuxedo Sensor 1.0.2 以降では、非rootユーザーである Instana エージェントユーザーとしてTuxedo Sensorを実行できます。 tuxedo センサーには、エージェント・ユーザーから Tuxedo ユーザーに切り替える権限が必要です。 Tuxedo センサーに対してこの権限を付与するには、エージェント・ユーザーが rootに設定されていない場合は、 /etc/sudoers ファイル内の設定を更新します。 エージェント・ユーザーは、以下のスニペットに示すように、さまざまな Tuxedo ユーザーとともに tuxedoShell.sh スクリプトを実行します。

_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

ここで、それぞれ以下のとおりです。

  • _agentuser_ Instana のエージェントユーザーです。

  • _tuxuser1__tuxuser2_、および _tuxuser3_ は、パラメーター tuxuserを使用してエージェントの configuration.yaml ファイルに定義されている Tuxedo ユーザーです。

注: 複数のTuxedoドメインに対して複数のTuxedoユーザーが存在する場合、対応するTuxedoドメインを監視するには、これらのユーザーをすべてファイル /etc/sudoers に追加する必要があります。

Instana エージェントのユーザーは、以下のスニペットに示すように、ファイルの設定を( /etc/sudoers ALL)に設定することで、他のユーザーと同様に tuxedoShell.sh スクリプトを実行できます

_agentuser_ ALL=(ALL)       NOPASSWD:SETENV:/home/agentuser/instana-agent/data/tmp/*/tuxedoShell.sh
注: tuxedoShell.sh スクリプトのパスには、 Instanatmp エージェントディレクトリの絶対パスとワイルドカードを使用してください。 通常、 Instanatmp エージェントのディレクトリは、 Instanadata ホストエージェントがインストールされているディレクトリの直下に配置されます。