Oracle Real Application Clusters のモニター
Instana ホストエージェントをインストールすると、 Oracle Real Application Clusters (RAC) センサーが自動的にインストールされますが、 「設定 」セクションの手順に従って、 Oracle RAC センサーを設定する必要があります。 その後、 Instana のUIで、 Oracle RACに関連するメトリクスを確認できます。
補足情報
サポート対象のオペレーティング・システム
Oracle のRACセンサーは、 Instana エージェントが実行されているすべてのホストのオペレーティングシステムに対応しています。 各ホストエージェントの「 対応OS 」セクションをご参照ください。例: Unix の対応OS。
サポートされるバージョン
メトリックおよび構成データについては、以下のサポートされるバージョンを参照してください。
- Oracle Database 19c
- Oracle Database 21c
Oracle RAC センサーでは、リモート・モニターのみがサポートされます。
Oracle RACの発見
「 リモート設定 」オプションを使用して、 Instana エージェントをインストールできないホスト上で実行されている Oracle RACデータベースを検出および監視します。
の構成
データベース権限の付与
センサーを Oracle RAC に接続し、メトリックと構成をモニターするには、以下の表に対する read 権限が必要です。
#Create a role
create ROLE INSTANAROLE;
#Note: For Oracle Container Database (CDB), common roles must follow the naming convention C##<role_name>
#Example for CDB: create ROLE C##INSTANAROLE;#Grant privileges to this role for following tables and views
GV_$SESSION, GV_$BGPROCESS, GV_$ACTIVE_SESSION_HISTORY, GV_$SYSSTAT, GV_$SGASTAT, GV_$LIBRARYCACHE, GV_$LATCH, GV_$ROWCACHE, GV_$RESOURCE_LIMIT, GV_$STATNAME, GV_$SESSTAT, GV_$PROCESS, GV_$SQLAREA, GV_$PARAMETER, GV_$SQL, V_$VERSION, GV_$SYS_TIME_MODEL, GV_$SYSTEM_WAIT_CLASS, GV_$INSTANCE, GV_$LOCK, DBA_HIST_SQLTEXT, DBA_HIST_SQLSTAT, DBA_HIST_SNAPSHOT,DBA_HIST_ACTIVE_SESS_HISTORY, DBA_USERS, DBA_OBJECTS, DBA_TABLESPACE_USAGE_METRICS, DBA_DATA_FILES, DBA_TEMP_FILES
eg. GRANT SELECT ON GV_$SESSION to INSTANAROLE;
#Assign this role to a user. Configure the same user in the configuration yaml file. For more information, see the [sensor configuration](#sensor-configuration) section.
GRANT INSTANAROLE to <user>;
#The following tables/views require the Oracle Diagnostic Pack license.
V$ACTIVE_SESSION_HISTORY, DBA_HIST_SNAPSHOT, DBA_HIST_SQLSTAT, DBA_HIST_SQLTEXT, DBA_HIST_ACTIVE_SESS_HISTORY
Oracle のRACセンサーの設定
Oracle RAC を監視するには、 エージェント設定ファイルを使用して、監視情報にアクセスするための認証情報をホストエージェントに通知する必要があります
Oracle のRAC監視を有効にする
Oracle RAC モニターを有効にするには、フラグ enableRacMonitoring を trueに設定する必要があります。
com.instana.plugin.oracledb:
remote: # we support listing multiple Oracle RACs here!
- host: '<ORCL_HOST>' # SCAN_HOSTNAME or SCAN_IP'
port: '<ORCL_PORT>'
user: '<ORCL_USER>' # default is 'sys as sysdba'
password: '<ORCL_PASSWORD>'
databaseServiceName: '<ORCL_DB_SERVICE_NAME>' # for Oracle RAC, SID is not required only ServiceName
availabilityZone: 'Oracle-RAC-AZ' # default is 'Oracle-RAC-AZ
poll_rate: 1
enableRacMonitoring: true # default is false. For Oracle RAC set this to true.
enableUniqueIdentifier: false # Default is false. Set to true only if you are monitoring multiple databases with identical SID/service names. Keep false for standard configurations
ポーリング・レートは、センサーが Oracle RAC メトリックをポーリングする頻度を秒単位で定義します。 デフォルトは 1 秒です。
インフラストラクチャー・マップでは、リモート Oracle RAC インスタンスは、 configuration.yaml ファイル内の availabilityZone キーで指定された名前を持つ別個のボックスとして表示されます。 インスタンスを検索するには、 Instana の「Dynamic Focus」検索バーに entity.type:oracleDB を入力してください。
カスタムポーリングの設定
以下の表に、最大 3 つのゼロ以外のカスタム・ポーリング・レートを構成できるメトリックを示します。 ポーリング・レートがゼロ以下のメトリックは、デフォルトでは無効になっています。 メトリクスを無効にするには、設定ファイルからそのメトリクスの *instanaAgentDir*/etc/instana/configuration.yamlエントリを削除してください。
| 名前 | 説明 |
|---|---|
| 上位 elapsed_time_queries | 上位経過時間照会のリスト。 |
| SQL_ID_CPU使用率上昇 | より多くの CPU を消費する SQL のリスト。 |
| ユーザーの事前開始セッション | アクティブなフォアグラウンド・セッションを表示します。 |
| TOP_10_SQL_HIGH_IO_LAST_1_HR | 過去 1 時間の入出力が高い上位 10 件の SQL のリスト。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 |
| トップ・テナント CPU コンシューム・セッション | 上位 CPU 消費セッションのリスト。 |
| TOP_CPU_CONSUMING_SESSION_LAST_10_MIN | 直近 10 分間にセッションを消費した上位 CPU のリスト。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 |
| 現在のブロック・セッション数 | ブロッキング・セッションに関する情報を表示するために使用されます。 |
| ライブラリー・キャッシュのヒット率 | この比率は、ピン・ヒットになったピン要求の数を示します。 |
| ACTIVE_SESSIONS_RUNNING_MORE_THAN_600_SECS | Oracle データベースで 10 分を超えて実行されているすべてのアクティブ・セッション。 |
| アクティブ・セッションの履歴 | データベース内のサンプル・セッション・アクティビティー。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 |
| TOP_10_SQL_HIGH_IO_LAST_24_HR | 過去 24 時間の入出力が高い上位 10 件の SQL のリスト。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 |
| TOP_CPU_QUERIES_LAST_24_HRS | 過去 24 時間に CPU を消費した上位の照会のリスト。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 |
| バインディング変数を使用していないクエリ | コード内で bind 変数を使用しない照会のリスト。 |
カスタム・ポーリングについては、以下の構成を参照してください。
com.instana.plugin.oracledb:
remote: # Instana supports listing of multiple Oracle RACs.
- host: '<ORCL_HOST>' # SCAN_HOSTNAME or SCAN_IP'
port: '<ORCL_PORT>'
user: '<ORCL_USER>' # default is 'sys as sysdba'
password: '<ORCL_PASSWORD>'
databaseServiceName: '<ORCL_DB_SERVICE_NAME>' # for Oracle RAC, SID is not required, requires only ServiceName
availabilityZone: 'Oracle-RAC-AZ' # default is 'Oracle-RAC-AZ
poll_rate: 1
enableRacMonitoring: true
enableUniqueIdentifier: false # Default is false. Set to true only if you are monitoring multiple databases with identical SID/service names. Keep false for standard configurations
customPolling:
- poll_rate: 30
metrics:
- TOP_CPU_CONSUMING_SESSION_LAST_10_MIN
- ACTIVE_SESSIONS_RUNNING_MORE_THAN_600_SECS
- LIBRARY_CACHE_HIT_RATIO
- CURRENT_BLOCKING_SESSIONS
- poll_rate: 60
metrics:
- TOP_ELAPSED_TIME_QUERIES
- TOP_TEN_CPU_CONSUMING_SESSION
- SQL_ID_CONSUMING_MORE_CPU
- USER_FOREGROUND_SESSIONS
- TOP_10_SQL_HIGH_IO_LAST_1_HR
- ACTIVE_SESSION_HISTORY
- poll_rate: 3600
metrics:
- TOP_10_SQL_HIGH_IO_LAST_24_HR
- TOP_CPU_QUERIES_LAST_24_HRS
- QUERIES_NOT_USING_BINDING_VARIABLES
メトリックの表示
メトリックを表示するには、以下のステップを実行します。
- Instana のUIのサイドバーで 「インフラストラクチャ」 を選択します。
- 特定のモニター対象ホストをクリックします。 収集されたすべてのメトリックとモニター対象プロセスを含むホスト・ダッシュボードを表示できます。
Oracle センサーは、以下のデータをモニターして収集します。
構成データ
Oracle センサーは、以下の構成データを収集します。
| 構成アイテム | 説明 |
|---|---|
| バージョン | Oracle データベースのバージョン番号 |
| SID | システム識別子(SID): Oracle データベースインスタンスの一意の名前 |
| サービス名 | データベースへの接続に使用されるネットワークサービス名 |
| 開始時刻 | データベースインスタンスが起動された時刻 |
| CPU 数 | データベースインスタンスが利用可能なCPUの数 |
| セッションの最大数 | 許可される同時セッションの最大数 |
| DB ブロック・サイズ | データベースブロックのサイズ |
| ポート | TCP Oracle データベースリスナーが接続を受け付けるポート番号(デフォルト:1521) |
| インスタンス数 | Oracle RACクラスタ内の稼働中のインスタンス数 |
パフォーマンス・メトリック
| メトリック | 説明 | 粒度 |
|---|---|---|
| 実行中のプロセス数 | 実行中のプロセスの数。 | 1 秒 |
| プロセス制限使用量 | プロセス・リソースの使用。 プロセスはパーセンテージで表示されます。 | 1 秒 |
| アクティブ・セッション (10 分を超えるもの) | Oracle データベース内のすべてのアクティブ・セッションが 10 分を超えています。 | 30 秒 |
| プロセス最大使用率 | 最後のインスタンス開始後のプロセスの最大使用量。 | 1 秒 |
| プロセスの現在の使用率 | 使用されているプロセスの数。 | 1 秒 |
| プロセス初期割り振り | プロセスの初期割り振り。 この割り振りは、初期設定パラメーター・ファイルでプロセスに指定された値と等しくなります。 | 1 秒 |
| プロセス限界値 | プロセスの最大限界値。 プロセスの値は、この制限内でなければなりません。 | 1 秒 |
| プロセス制限使用量 | 設定されている制限に対するすべての現行プロセスの割合。 | 1 秒 |
| 1 秒当たりの DB 時間 | データベース・ユーザー・レベルの呼び出しの実行に費やされた経過時間。 | 1 秒 |
| DB CPU 時間 | データベース・ユーザー・レベルの呼び出しの実行に費やされた CPU 時間。 | 1 秒 |
| SQL 実行時間 | SQL 照会ステートメントが実行されている間の経過時間。 | 1 秒 |
| 解析時間 | SQL 照会ステートメントの構文解析に費やされた経過時間。 これには、ソフト解析時間とハード解析時間の両方が含まれます。 | 1 秒 |
| データベース CPU 時間比率 | 合計データベース時間によってデータベースで使用された CPU の量。 | 1 秒 |
| 1 秒当たりの待機時間 | ユーザー I/O、その他、システム I/O、並行性、スケジューラー、アプリケーション、コミット、構成、管理、ネットワーク、およびキューイングの 1 秒当たりの待機時間。 | 1 秒 |
| ライブラリー・キャッシュ・ヒット率 (ピン・ヒット数) | この比率は、ピン・ヒットになったピン要求の数を示します。 | 30 秒 |
| SGA 合計メモリー | システム・グローバル域 (SGA) 内の合計メモリー (MB)。 | 1 秒 |
| SGA 使用メモリー | SGA によって使用されているメモリー (MB)。 | 1 秒 |
| SGA 空きメモリー | SGA の空きメモリー (MB)。 | 1 秒 |
| SGA プール名 | システム・グローバル域 (SGA) のプール名。 | 1 秒 |
| SGA プール合計メモリー | SGA プール内の合計メモリー (MB)。 | 1 秒 |
| SGA プール使用メモリー | SGA プール内の使用メモリー (MB)。 | 1 秒 |
| SQL 実行カウント | 実行された SQL 照会の総数。 | 1 秒 |
| SQL 実行平均時間 | 平均 SQL 実行時間。 | 1 秒 |
| SQL 解析数 | ハードおよび合計解析カウント。 | 1 秒 |
| SQL 解析率 | 解析なしでソフト解析を使用して実行された SQL 実行の比率。 | 1 秒 |
| ユーザー呼び出し数 | 呼び出し、コミット、およびロールバックの数。 | 1 秒 |
| バッファー・キャッシュ・ヒット率 | ディスクから読み取る必要がない、バッファー・キャッシュ内で検出されたページのパーセンテージ。 | 1 秒 |
| 物理セッション読み取りと論理セッション読み取り | 物理読み取りおよび論理読み取りの数。 | 1 秒 |
| セッション数 | ユーザー・セッションの数 (アクティブおよび非アクティブ)、およびバックグラウンド・セッションの数。 | 1 秒 |
| テーブル・スペースの使用状況 | 表スペース (永続、一時、および元に戻す) の使用量 (GB)、表スペースの使用量 (%)、表スペースの最大サイズ、および自動拡張可能フラグ。 | 1 秒 |
| アクティブなRACインスタンス | RAC内のアクティブなインスタンス数。 この指標は、標準のダッシュボードでは利用できません。 ただし、このメトリクスを使用して、アクティブなインスタンス数が定義された閾値を下回った際に通知がトリガーされるよう、カスタムダッシュボードを作成したり、イベントやアラートを設定したりすることができます。 | 1 秒 |
| 上位 CPU 照会 (直近 24 時間) | 直近 24 時間の上位 CPU 照会のリスト。CPU 時間 (ミリ秒)、ディスク読み取り数、および照会が実行された合計所要時間が含まれます。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 | 1 時間 |
| バインド変数を使用しない照会 | コード内で bind 変数を使用しない照会のリスト。照会コピーの数、照会実行の数、および SQL 照会によって消費される合計メモリー (MB 単位) が含まれます。 | 1 時間 |
| 経過時間が上位の照会 | SQL ID、SQL 照会、および実行時間 (分単位) を含む上位経過時間照会のリスト。 | 60 秒 |
| アクティブ・セッション履歴 (直近 1 時間) | SQL ID、ロード・パーセンテージ、およびセッション・カウントを使用した、過去 1 時間のデータベース内のサンプル・セッション・アクティビティー。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 | 60 秒 |
| 上位 10 個の CPU 消費セッション | セッション ID、シリアル番号、CPU 時間 (分)、およびオペレーティング・システム・プログラム名を含む、上位 10 件の CPU 消費セッションのリスト。 | 60 秒 |
| 上位の CPU 消費セッション (直近 10 分) | 直近 10 分間における CPU を消費した上位セッションのリスト。セッション ID、シリアル番号、および照会が実行された合計所要時間が示されます。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 | 30 秒 |
| 上位 10 件の入出力 (直近 1 時間) の SQL | SQL ID、ユーザー名、および合計待機時間 (ミリ秒) を含む、過去 1 時間に入出力が高い上位 10 件の SQL 照会のリスト。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 | 60 秒 |
| 現在のブロッキング・セッション | ブロッキング・セッションに関する情報。 | 30 秒 |
| フォアグラウンド・セッション | アクティブなフォアグラウンド・セッション。 | 60 秒 |
| より多くの CPU を消費する SQL | より多くの CPU を使用する SQL 照会のリスト。 | 60 秒 |
| 上位 10 件の SQL (直近 24 時間) | 過去 24 時間に I/O が高い上位 10 件の SQL 照会のリスト。 このメトリクスを表示するには、「データベース権限の付与」 セクションで指定されているビューに対して、 Oracle Diagnostic Packのライセンスが必要です。 | 1 時間 |
正常性シグニチャー
各センサーについて、正常性シグネチャーのキュレートされた知識ベースは、着信メトリックに対して継続的に評価され、ユーザーに影響を与える問題またはインシデントを発生させるために使用されます。
組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、任意のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。 OracleDB センサーの組み込みイベントに関する詳細については、 「組み込みイベントのリファレンス」 を参照してください。