当社のOracle Database 統合 は、デフォルトでは、データベース、テーブルスペース、およびメモリに関する主要なパフォーマンスメトリクスを収集します。設定をカスタマイズしてさらに多くのメトリクスを収集することで、データベースのパフォーマンスを詳細に把握することができます。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
当社のインテグレーションは、Oracle データベース バージョン 11.2 から 23 まで互換性があります。
統合をインストールする前に、次の要件を満たしていることを確認してください。
- Linux distro インフラストラクチャとの互換性 、RHEL/CentOS/OEL のバージョンが 7 以下の場合を除く。
- インフラストラクチャエージェントをインストールします。
- Oracle Instant Client をエージェントボックスに設置します。
- rootユーザーの正しいディレクトリに
ORACLE_HOME
が設定されたOracleデータベース。 - 必要なグローバル ビューに対するCONNECTとSELECTの両方の権限を持つ Oracle データベース ユーザー。
- リモート接続から監視するように構成された
listener.ora
ファイルを含むOracleデータベース。デフォルトでは、OracleDatabaseはlocalhostのみをリッスンします。
重要
ARM64アーキテクチャには対応していません。
インストールしてアクティブ化する
Oracle Databaseインテグレーションをインストールするには
インフラストラクチャ エージェントをインストールし、
INTEGRATION_FILE_NAME
変数をnri-oracledb
に置き換えます。ディレクトリを統合フォルダに変更します。
bash$cd /etc/newrelic-infra/integrations.dサンプル構成ファイルをコピーします。
bash$sudo cp oracledb-config.yml.sample oracledb-config.yml構成設定の説明に従って、
oracledb-config.yml
ファイルを編集します。
その他の注意事項:
- Advanced: tarball ファイルから統合をインストールすることもできます。 これにより、インストールと設定のプロセスを完全に制御できるようになります。
- On-host integrations do not automatically update. 最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。
このドキュメントはインストールの役に立ちましたか?
構成
Oracle DB Serverの有効化
Oracle データベースで、次のステートメントを実行して新しいユーザーを作成し、ユーザー権限を割り当てます。USERNAME および同様のユーザー固有の値を置き換える必要があります。
お持ちのデータベースの種類を選択してください。ユーザーの保守に関する質問については、 Oracle のドキュメントを参照するか、システム管理者またはデータベース管理者に問い合わせてください。
ユーザーに
CONNECT
権限を付与します。GRANT CONNECT TO USERNAME;次のグローバルビューでユーザーに
SELECT
権限を付与します。cdb_data_files
cdb_pdbs
cdb_users
gv_$sysmetric
gv_$pgastat
gv_$instance
gv_$filestat
gv_$parameter
sys.dba_data_files
gv_$session
gv_$sesstat
gv_$statname
gv_$rowcache
gv_$sga
gv_$sysstat
v_$database
gv_$librarycache
gv_$sqlarea
gv_$system_event
dba_tablespaces
gv_$session_wait
gv_$rollstat
v_$instance
次の SQL ステートメントを 1 つのスクリプトでまとめて実行するか、個別に実行します。
GRANT SELECT ON cdb_data_files TO USERNAME;GRANT SELECT ON cdb_pdbs TO USERNAME;GRANT SELECT ON cdb_users TO USERNAME;GRANT SELECT ON gv_$sysmetric TO USERNAME;GRANT SELECT ON gv_$pgastat TO USERNAME;GRANT SELECT ON gv_$instance TO USERNAME;GRANT SELECT ON gv_$filestat TO USERNAME;GRANT SELECT ON gv_$parameter TO USERNAME;GRANT SELECT ON sys.dba_data_files TO USERNAME;GRANT SELECT ON DBA_TABLESPACES TO USERNAME;GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO USERNAME;GRANT SELECT ON gv_$session TO USERNAME;GRANT SELECT ON gv_$sesstat TO USERNAME;GRANT SELECT ON gv_$statname TO USERNAME;GRANT SELECT ON gv_$rowcache TO USERNAME;GRANT SELECT ON gv_$sga TO USERNAME;GRANT SELECT ON gv_$sysstat TO USERNAME;GRANT SELECT ON v_$database TO USERNAME;GRANT SELECT ON gv_$librarycache TO USERNAME;GRANT SELECT ON gv_$sqlarea TO USERNAME;GRANT SELECT ON gv_$system_event TO USERNAME;GRANT SELECT ON dba_tablespaces TO USERNAME;GRANT SELECT ON gv_$session_wait TO USERNAME;GRANT SELECT ON gv_$rollstat TO USERNAME;GRANT SELECT ON v_$instance TO USERNAME;
PDB メトリクスを収集するには、以下を実行して gv$con_sysmetric
権限を付与します。
GRANT SELECT ON gv$con_sysmetric TO USERNAME;
統合を構成する
インストール方法に応じて、統合を構成する方法はいくつかあります。
- Amazon ECSを介して有効になっている場合: ECSで実行されている監視サービスを参照してください。
- ホストにインストールされている場合:統合のYAML構成ファイル
oracledb-config.yml
の構成を編集します。
統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。
構成ファイルには、 interval
、 timeout
、 inventory_source
などのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、 構成フォーマットのドキュメントを参照してください。
重要
レガシー構成/定義ファイルをまだ使用している場合は、このドキュメントを参照してください。
Oracle DBに関連する特定の設定は、構成ファイルのenv
セクションを使用して定義されます。これらの設定は、Oracle DBインスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。有効な設定のリストについては、このドキュメントの次のセクションで説明します。
Oracle DB インスタンスの設定
Oracle DB 統合は、メトリクス ( M ) とインベントリ ( I ) の両方の情報を収集します。 表では、各コレクションで使用できる設定にApplies To列を使用します。
'' '' '' '' '' '' '' '' '' '' '' '' '' '' '' '' '' ''
設定 | 説明 | デフォルト | に適用されます |
---|---|---|---|
SERVICE_NAME | Oracleインスタンスのサービス名です。 | 該当なし | M / I |
HOSTNAME | Oracle DBが稼働しているホスト名またはIP。 | 127.0.0.1 | M / I |
PORT | Oracle DB が待ち受けているポート。 | 1521 | M / I |
USERNAME | Oracle DBサーバーにアクセスするためのユーザー名。 | 該当なし | M / I |
PASSWORD | 指定されたユーザーのパスワード。 | 該当なし | M / I |
CONNECTION_STRING |
| 該当なし | M / I |
ORACLE_HOME |
| 該当なし | M / I |
TABLESPACES | 収集するテーブルスペースのJSON配列。省略した場合は、すべての表領域が収集されます。空の場合、表領域メトリックの収集をスキップします。 | [] | M |
IS_SYS_DBA | 認証するユーザーがSysDBAの権限を持っているかどうかを示す。 | false | M |
IS_SYS_OPER | 認証するユーザーがSysOperの権限を持っているかどうかを示す。 | false | M |
EXTENDED_METRICS | 拡張メトリクスを収集するかどうかを示します。どの指標が拡張指標なのかは、以下の の表で確認してください。 | false | M |
SKIP_METRICS_GROUPS | 収集されたメトリックは、データの取得に使用されたクエリに応じてグループ化されます。これらのメトリックグループはここに一覧表示され、JSON配列形式でグループの名前を | [] | M |
DISABLE_CONNECTION_POOL | コネクションプーリングを無効にします。Oracle DBへの新しい接続を確立しようとするとエラーが発生する場合にのみ使用します。 | false | M |
MAX_OPEN_CONNECTIONS | 統合によって開かれる同時接続の最大数。 | 5 | M |
SYS_METRICS_SOURCE | アプリケーション コンテナのメトリクスを収集するには、これを | 」 | M |
CUSTOM_METRICS_QUERY | カスタムメトリックを収集するためのSQLクエリ。以下の例を参照してください。 | 該当なし | M |
CUSTOM_METRICS_CONFIG | カスタムメトリックを収集するための1つ以上のSQLクエリを使用したYAML構成。以下の例を参照してください。 | false | M |
METRICS | メトリックのみの収集を有効にするには、 | false | |
INVENTORY | インベントリのみの収集を有効にするには、 | false |
これらの設定の値は、いくつかの方法で定義できます。
- 値を構成ファイルに直接追加します。これが最も一般的な方法です。
{{}}
表記を使用して、環境変数の値を置き換えます。これには、インフラストラクチャエージェント1.14.0以降が必要です。詳細については、 インフラストラクチャエージェントのパススルー環境変数の詳細を参照してください。- シークレット管理を使用して、パスワードなどの機密情報を保護し、構成ファイルにプレーンテキストで公開されないようにします。詳細については、シークレット管理を参照してください。
ラベルとカスタム属性
メトリックをラベルで装飾することもできます。ラベルを使用すると、キーと値のペアの属性をメトリックに追加して、メトリックをクエリ、フィルタリング、またはグループ化できます。
デフォルトのサンプル構成ファイルにはラベルの例が含まれていますが、それらはオプションです。新しいものを削除、変更、または追加できます。
labels: env: production role: load_balancer
構成例
データを見つけて使用する
New Relic で統合データを見つけるには、 one.newrelic.com > All capabilities > Infrastructure > Third-party servicesに移動し、Oracle データベース統合リンクの 1 つを選択します。
Oracle Databaseのデータは、以下の イベントタイプに添付されています。:
OracleDatabaseSample
OracleTablespaceSample
データを検索して使用する方法の詳細については、統合データについてを参照してください。
メトリックデータ
Oracle Database統合は、以下のメトリック・データ属性を収集します。各メトリック名の前には、カテゴリインジケーターとピリオド( disk.
やmemory.
など)が付いています。
データベースメトリック
これらの属性は、 OracleDatabaseSample
イベントタイプを照会することで見つけることができます。
メトリック | 説明 | 拡張 |
---|---|---|
| アクティブなパラレルセッション。 | |
| アクティブなシリアルセッション。 | |
| 平均アクティブセッション数 | |
| 1秒あたりのチェックポイント数 | |
| 1秒あたりのバックグラウンドCPU使用率。 | |
| 1秒あたりのバックグラウンド時間 | |
| 1秒あたりのDBブロックの変更 | |
| トランザクションごとのDBブロックの変更 | |
| ユーザーコールごとのDBブロック変更 | |
| 1秒間に取得するDBブロック。 | |
| DBブロックは、トランザクションごとに取得します。 | |
| DBブロックは、ユーザーの呼び出しごとに取得します。 | |
| ブランチノードの1秒あたりのスプリット数 | |
| ブランチノードは、トランザクションごとに分割されます。 | |
| 1秒間に一貫した読み取り変化を実現。 | |
| トランザクションごとの一貫した読み取り変更 | |
| 1秒あたりの読み取り回数が安定しています。 | |
| トランザクションごとの一貫したリードゲット。 | |
| CPU時間の比率です。 | |
| 1秒あたりのCPU使用率。 | |
| トランザクションごとのCPU使用率。 | |
| 1秒間に作成されるCRブロック。 | |
| トランザクションごとに作成されるCRブロック。 | |
| 1秒間に適用されるCRのアンドゥ記録。 | |
| CRのアンドゥレコードは、トランザクションごとに適用されます。 | |
| 現在のログオン数 | |
| 現在のオープンカーソルのカウント | |
| カーソルキャッシュのヒット率。 | |
| 1秒あたりのデータベース時間 | |
| 1秒あたりのDBWRチェックポイント | |
| 1秒あたりのエンキューのデッドロック数。 | |
| デッドロックをトランザクションごとにエンキューする。 | |
| 1秒あたりのエンキューリクエスト数。 | |
| トランザクションごとにリクエストをエンキューします。 | |
| 1秒あたりのエンキューのタイムアウト。 | |
| トランザクションごとのエンキューのタイムアウト。 | |
| Enqueue waits per second. | |
| トランザクションごとの待ち時間をエンキューします。 | |
| 1秒あたりの実行回数。 | |
| トランザクションごとの実行回数です。 | |
| ユーザーコールごとの実行回数 | |
| 1秒あたりのフルインデックススキャン数。 | |
| トランザクションごとにフルインデックススキャンを行います。 | |
| GC CRブロックの1秒あたりの受信数。 | |
| トランザクションごとに受信したGC CRブロック。 | |
| GC現在のブロック受信数/秒 | |
| トランザクションごとに受信したGC電流ブロック。 | |
| グローバルキャッシュの平均CR取得時間。 | |
| グローバルキャッシュの平均的な現在の取得時間。 | |
| 1秒あたりのハードパーズ数。 | |
| トランザクションごとのハードパーズ数。 | |
| ホストの1秒あたりのCPU使用率。 | |
| ホストのCPU使用率(パーセンテージ)。 | |
| リーフノードの1秒間のスプリット数 | |
| リーフノードの分割は、トランザクションごとに行われます。 | |
| ライブラリのキャッシュヒット率。 | |
| ライブラリキャッシュのミス率。 | |
| ロジカル・リード・パー・セカンド | |
| トランザクションごとの論理的読み取り。 | |
| ログオン/秒。 | |
| トランザクションあたりのログオン数 | |
| 1秒あたりの長いテーブルスキャン。 | |
| トランザクションごとの長いテーブルスキャン。 | |
| 1秒間に開くカーソル数 | |
| トランザクションごとのオープンカーソルです。 | |
| 現在のOSの負荷 | |
| 1秒あたりの解析失敗数。 | |
| トランザクションごとの解析失敗数。 | |
| PGAキャッシュヒット率。 | |
| プロセスリミットのパーセンテージです。 | |
| 1秒あたりの再帰呼び出し | |
| トランザクションごとの再帰的な呼び出し。 | |
| 1秒あたりのREDOの書き込み数。 | |
| トランザクションごとのREDOの書き込み。 | |
| トランザクションごとの応答時間。 | |
| ロウキャッシュヒット率。 | |
| ロウキャッシュのミス率。 | |
| ソートあたりの行数 | |
| セッション数 | |
| セッションリミットのパーセンテージです。 | |
| 共用プール無料の割合。 | |
| ソフトパーズの比率。 | |
| ユーザーの通話ごとの合計金額 | |
| SQLサービスの応答時間。 | |
| ストリームプールの使用率。 | |
| ユーザーコールごとのテーブルスキャンの合計。 | |
| 1秒あたりの総インデックススキャン数。 | |
| トランザクションごとのインデックススキャンの合計。 | |
| 1秒あたりの総解析数。 | |
| トランザクションごとの総解析数。 | |
| 1秒あたりのテーブルスキャンの合計。 | |
| トランザクションごとのテーブルスキャンの合計。 | |
| ログオン毎のトランザクション。 | |
| 1秒あたりのユーザーコール数 | |
| トランザクションごとのユーザーコール | |
| ユーザーコール率 | |
| ユーザーがパーセンテージをコミットする。 | |
| 1秒あたりのユーザーコミット数 | |
| ユーザー制限の割合。 | |
| トランザクションごとのユーザーロールバック | |
| 1秒あたりのユーザーロールバック数 | |
| 1秒あたりに適用されるユーザーロールバックのアンドゥ記録。 | |
| トランザクションごとに適用されるユーザーロールバックのアンドゥレコード。 | |
| データベースの待ち時間の比率。 | |
| キャプチャされた使用済みコール | |
| 解析率なしで実行 | |
| 1 秒あたりのログオン数 | |
| 1 秒あたりの物理読み取りバイト数 | |
| 1 秒あたりの物理読み取り IO リクエスト | |
| 1 秒あたりの物理読み取り数 | |
| 1 秒あたりの物理書き込みバイト数 | |
| 1 秒あたりの物理書き込み数 | |
| ブロックリードの数 | |
| ブロックライトの数 | |
| ユーザーコールごとのロジカルリード | |
| フィジカルは1秒間にダイレクトロブを読む。 | |
| フィジカルは1秒間にダイレクトロブを書き込みます。 | |
| フィジカルリードの総バイト数/秒。 | |
| フィジカルリードの総I/Oリクエスト数/秒。 | |
| フィジカル・リード・ダイレクト・パー・セカンド | |
| 物理的な書き込みの総バイト数/秒。 | |
| 1秒あたりの物理的な書き込みI/Oリクエスト。 | |
| 1秒あたりの物理的な書き込み数 | |
| フィジカルライトの総I/Oリクエスト数/秒。 | |
| 物理的な読み取りの総数。 | |
| ファイル読み込み時間の量。 | |
| 1秒あたりのディスクソート数。 | |
| トランザクションごとのディスクソート | |
| 使われているテンポススペース | |
| 物理的な書込みの総数。 | |
| ファイルの書き込み時間の量。 | |
|
| |
| 長時間稼働するクエリの数(> 60s) | |
| バッファキャッシュヒット率。 | |
| グローバルキャッシュブロックが破損している。 | |
| グローバルキャッシュブロックが失われる。 | |
| インスタンスに割り当てられているPGAメモリの現在の量。 | |
| オートマチックモードで実行されるワークエリアの最大サイズ。 | |
| 全プロセスのPGAメモリのうち、オペレーティング・システムに解放して戻すことができたバイト数。 | |
| ワークエリアで現在消費されているPGAメモリの量を示す。この数値は、PGAメモリの他の消費者(PL/SQLやJavaなど)がどれだけのメモリを消費しているかを判断するために使用することができます。 | |
| リドゥーアロケーションのヒット率 | |
| 1秒あたりのREDO生成バイト数。 | |
| トランザクションごとのRedo生成バイト。 | |
| メモリのソート率。 | |
| I/O megabytes per second。 | |
| 1秒あたりのI/Oリクエスト数。 | |
| 1秒あたりのネットワークトラフィック量。 | |
| トランザクションごとの物理的な読み取りのダイレクトロブ。 | |
| トランザクションごとに物理的な書き込みを行うダイレクトロブ。 | |
| トランザクションごとに物理的な読み取りを行う。 | |
| トランザクションごとの物理的な読み取り。 | |
| トランザクションごとに直接物理的な書き込みを行います。 | |
| トランザクションごとの物理的な書込み。 | |
| 1秒あたりのユーザートランザクション数。 | |
| REDOログファイルのスイッチイベントの数。 | |
| アーカイブが必要なREDOログファイルのスイッチイベントの数。 | |
| 不完全なREDOログファイルのスイッチイベントのチェックポイントの数。 | |
| REDOログの待ち時間の数。 | |
| ロールバックセグメントの取得数 | |
| ロールバックセグメントの待ち時間の比率。 | |
| ロールバックセグメントの待ち時間の数 | |
| SGAバッファのビジー・ウェイティングの回数。 | |
| SGAの固定サイズ。 | |
| SGAフリーバッファの検査数。 | |
| SGAのフリーバッファの待ち時間の数。 | |
| SGAのヒット率。 | |
| SGAのログバッファへの割り当ての再試行率。 | |
| SGAログバッファのREDO割り当て比率。 | |
| SGAログバッファ内のRedoエントリの数。 | |
| バッファスペースは、SGAのログバッファを待ちます。 | |
| SGAのRedoバッファ(単位:バイト)。 | |
| SGA共有プール辞書(dict)キャッシュのミス率。 | |
| SGA共有プールライブラリキャッシュのヒット率。 | |
| SGA共有プールライブラリキャッシュのリロード率。 | |
| ステートメントごとのSGAキャッシュ可能メモリ(単位:バイト)。 | |
| ユーザーごとのSGAキャッシュ可能メモリ(単位:バイト)。 | |
| UGA(User Global Area)の総メモリ量。 | |
| ディスクの使用量をバイト単位でソートします。 | |
| メモリ使用量をバイト単位でソートします。 |
テーブルスペース・メトリクス
Oracle データベース統合は、次の表領域メトリクスを収集します。 これらの属性は、 OracleTablespaceSample
イベント タイプをクエリすることで見つけることができます。 表領域の使用量メトリクスは、読取り専用のスタンバイ・データベースでは使用できないことに注意してください。この制限の詳細については、Oracle Knowledgebaseのこちらを参照してください。
メトリック | 説明 | 拡張 |
---|---|---|
| テーブルスペースのオフライン状態を表すブール値。 | |
| オフラインになっているPDBデータファイルの数です。 | |
| オフラインになっているCDBデータファイルの数です。 | |
| 書き換え不可能な状態のPDBデータファイルの数です。 | |
| テーブルスペースの使用量(バイト)。 | |
| 予約されたテーブルスペースの合計(バイト)。 | |
| テーブルスペースの総量に対する使用量の割合。 |
在庫データ
Oracle データベース インテグレーションは、Oracle データベースの設定問題をキャプチャします。 データは、 [インベントリ] ページのconfig/oracledbソースで入手できます。 インベントリデータの詳細については、「インテグレーション データを理解する」を参照してください。
この統合では、以下のOracle Databaseの設定パラメータのデータを取得します。
トラブルシューティング
トラブルシューティングのヒント:
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。