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
メトリックの表示
メトリックを表示するには、以下のステップを実行します。
- ナビゲーション・メニューで、 「インフラストラクチャー」をクリックします。
- 構成ファイルで定義したアベイラビリティー・ゾーンを見つけます。 アベイラビリティー・ゾーンは、デフォルトで
Tuxedo Domainsに設定されています。 - アベイラビリティー・ゾーンのドメイン・ピラーをクリックします。
ドメイン・ダッシュボードに、選択した 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 | 完了しているサービス要求の数。 サービス要求は、 LDBAL が Yに設定されている場合にのみ返されます。 |
| numQueued | このサービスに現在エンキューされている要求の数。 これらの要求は、 LDBAL が Yに設定されている場合にのみ返されます。 |
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 ユーザーです。
/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 ホストエージェントがインストールされているディレクトリの直下に配置されます。