DBMS_MONITOR

114 DBMS_MONITOR

DBMS_MONITORは、PL/SQLを使用して統計情報収集とSQLトレースを制御するためのパッケージです。

この章の内容は次のとおりです。

DBMS_MONITORサブプログラムの要約

114.1 DBMS_MONITORサブプログラムの要約

この表は、DBMS_MONITORサブプログラムを示し、簡単に説明しています。

表114-1 DBMS_MONITORパッケージのサブプログラム

サブプログラム	説明
CLIENT_ID_STAT_DISABLEプロシージャ	指定されたクライアント識別子に対して以前に有効にされた統計情報収集を無効にします。
CLIENT_ID_STAT_ENABLEプロシージャ	指定されたクライアント識別子に対する統計情報収集を有効にします。
CLIENT_ID_TRACE_DISABLEプロシージャ	指定されたクライアント識別子に対して以前に有効にされたトレースをデータベース全体で無効にします。
CLIENT_ID_TRACE_ENABLEプロシージャ	指定されたクライアント識別子に対するトレースをデータベース全体で有効にします。
DATABASE_TRACE_DISABLEプロシージャ	データベース全体または特定のインスタンスに対するSQLトレースを無効にします。
DATABASE_TRACE_ENABLEプロシージャ	データベース全体または特定のインスタンスに対するSQLトレースを有効にします。
SERV_MOD_ACT_STAT_DISABLEプロシージャ	サービス名、`MODULE`および`ACTION`の指定された組合せに対して有効にされた統計情報収集を無効にします。
SERV_MOD_ACT_STAT_ENABLEプロシージャ	サービス名、`MODULE`および`ACTION`の指定された組合せに対する統計情報収集を有効にします。
SERV_MOD_ACT_TRACE_DISABLEプロシージャ	サービス名、`MODULE`および`ACTION`名の指定された組合せに対して有効にされた`すべて`のインスタンスに対するトレースを全体で無効にします。
SERV_MOD_ACT_TRACE_ENABLEプロシージャ	`instance_name`が指定されていないかぎり、サービス名、`MODULE`および`ACTION`の指定された組合せに対するSQLトレースを全体で有効にします。
SESSION_TRACE_DISABLEプロシージャ	指定されたデータベース・セッション識別子(SID)に対して以前に有効にされたトレースをローカル・インスタンス上で無効にします。
SESSION_TRACE_ENABLEプロシージャ	指定されたデータベース・セッション識別子(SID)に対するトレースをローカル・インスタンス上で有効にします。

114.1.1 CLIENT_ID_STAT_DISABLEプロシージャ

このプロシージャは、CLIENT_ID_STAT_ENABLEプロシージャによって有効にされたすべてのインスタンスに対する統計情報収集を無効にして、収集済の統計情報をV$CLIENT_STATSビューから削除します。

構文

DBMS_MONITOR.CLIENT_ID_STAT_DISABLE(
   client_id            IN   VARCHAR2);

パラメータ

表114-2 CLIENT_ID_STAT_DISABLEプロシージャのパラメータ

パラメータ	説明
`client_id`	統計情報収集が無効にされるクライアント識別子

例

統計情報収集を無効にするには、次のようにします。

EXECUTE DBMS_MONITOR.CLIENT_ID_STAT_DISABLE('janedoe');

114.1.2 CLIENT_ID_STAT_ENABLEプロシージャ

このプロシージャは、指定されたクライアント識別子に対する統計情報収集を有効にします。

統計情報の収集はデータベース全体に対して実行され、インスタンスの起動や再起動を行っても中断されません。つまり、同じデータベースのすべてのインスタンス(再起動されたインスタンスを含む)に関する統計情報が収集されます。統計情報は、V$CLIENT_STATSビューを使用して参照できます。

構文

DBMS_MONITOR.CLIENT_ID_STAT_ENABLE(
   client_id            IN   VARCHAR2);

パラメータ

表114-3 CLIENT_ID_STAT_ENABLEプロシージャのパラメータ

パラメータ	説明
`client_id`	統計情報収集が有効にされるクライアント識別子

例

指定したクライアント識別子を持つクライアントに関する統計情報収集を有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.CLIENT_ID_STAT_ENABLE('janedoe');

114.1.3 CLIENT_ID_TRACE_DISABLEプロシージャ

このプロシージャは、CLIENT_ID_TRACE_ENABLEプロシージャによって有効にされたトレースを無効にします。

構文

DBMS_MONITOR.CLIENT_ID_TRACE_DISABLE(
 client_id    IN  VARCHAR2);

パラメータ

表114-4 CLIENT_ID_TRACE_DISABLEプロシージャのパラメータ

パラメータ	説明
`client_id`	SQLトレースが無効にされるクライアント識別子

例

EXECUTE DBMS_MONITOR.CLIENT_ID_TRACE_DISABLE ('janedoe');

114.1.4 CLIENT_ID_TRACE_ENABLEプロシージャ

このプロシージャは、指定されたクライアント識別子に対するトレースをデータベース全体で有効にします。

構文

DBMS_MONITOR.CLIENT_ID_TRACE_ENABLE(
 client_id    IN  VARCHAR2,
 waits        IN  BOOLEAN DEFAULT TRUE,
 binds        IN  BOOLEAN DEFAULT FALSE,
 plan_stat    IN  VARCHAR2 DEFAULT NULL);

パラメータ

表114-5 CLIENT_ID_TRACE_ENABLEプロシージャのパラメータ

パラメータ	説明
`client_id`	SQLトレースが有効にされるデータベース・セッション識別子。
`waits`	`TRUE`の場合、待機情報がトレースに存在します。
`binds`	`TRUE`の場合、バインド情報がトレースに存在します。
`plan_stat`	行ソース統計をダンプする頻度。値は'`NEVER`'、'`FIRST_EXECUTION`'(`NULL`と同じ)または'`ALL_EXECUTIONS`'です。

使用上のノート

指定されたクライアント識別子のために複数のOracleシャドウ・プロセスが動作するため、トレース情報は複数のトレース・ファイルに書き込まれます。
トレースはすべてのインスタンスに対して有効になり、インスタンスの再起動を行っても中断されません。

例

EXECUTE DBMS_MONITOR.CLIENT_ID_TRACE_ENABLE('janedoe', TRUE,
FALSE);

114.1.5 DATABASE_TRACE_DISABLEプロシージャ

このプロシージャは、データベース全体または特定のインスタンスに対するSQLトレースを無効にします。

構文

DBMS_MONITOR.DATABASE_TRACE_DISABLE(
   instance_name  IN VARCHAR2 DEFAULT NULL);

パラメータ

表114-6 DATABASE_TRACE_DISABLEプロシージャのパラメータ

パラメータ	説明
`instance_name`	指定したインスタンスに対するトレースを無効にします。

114.1.6 DATABASE_TRACE_ENABLEプロシージャ

このプロシージャは、データベース全体または特定のインスタンスに対するSQLトレースを有効にします。

構文

DBMS_MONITOR.DATABASE_TRACE_ENABLE(
   waits          IN BOOLEAN DEFAULT TRUE,
   binds          IN BOOLEAN DEFAULT FALSE,
   instance_name  IN VARCHAR2 DEFAULT NULL,
   plan_stat      IN VARCHAR2 DEFAULT NULL);

パラメータ

表114-7 DATABASE_TRACE_ENABLEプロシージャのパラメータ

パラメータ	説明
`waits`	`TRUE`の場合、待機情報がトレースに存在することになります。
`binds`	`TRUE`の場合、バインド情報がトレースに存在することになります。
`instance_name`	このパラメータにインスタンス名を指定すると、指定されたインスタンスに対するトレースのみが有効にされます。
`plan_stat`	行ソース統計をダンプする頻度。値は'`NEVER`'、'`FIRST_EXECUTION`'(`NULL`と同じ)または'`ALL_EXECUTIONS`'です。

114.1.7 SERV_MOD_ACT_STAT_DISABLEプロシージャ

このプロシージャは、統計情報収集を無効にして、収集済の統計情報をV$SERV_MOD_ACT_STATSビューから削除します。

統計情報収集の無効化はデータベース全体に適用されます。つまり、同じデータベースのインスタンス(統計情報収集の有効化によってアクティブになったdblinksを含む)に関する統計情報の収集が停止します。

構文

DBMS_MONITOR.SERV_MOD_ACT_STAT_DISABLE(
   service_name    IN VARCHAR2,
   module_name     IN VARCHAR2,
   action_name     IN VARCHAR2 DEFAULT ALL_ACTIONS);

パラメータ

表114-8 SERV_MOD_ACT_STAT_DISABLEプロシージャのパラメータ

パラメータ	説明
`service_name`	統計情報収集が無効にされるサービスの名前。
`module_name`	モジュールの名前。サービスに対する追加の修飾子。このパラメータは省略できません。
`action_name`	アクションの名前。サービス名とモジュール名に対する追加の修飾子。このパラメータを省略するか、`ALL_ACTIONS`定数に設定すると、指定されたサービス名/モジュール名の組合せに一致するすべてのアクションに対する統計情報収集が有効になります。この場合、統計情報は、モジュール・レベルで収集されます。

使用上のノート

統計情報の収集に関して、モジュールまたはアクションを変更すると、セッションで実行される次のユーザー・コールがこの変更の影響を受けます。たとえば、モジュールがセッション内で'module 1'に設定されており、そのセッションのユーザー・コールで'module 2'にリセットされた場合、このモジュールは、ユーザー・コールの間'module 1'のままとなります。モジュールは、このセッションの次のユーザー・コールで'module 2'に変更されます。

114.1.8 SERV_MOD_ACT_STAT_ENABLEプロシージャ

このプロシージャは、サービス名、MODULEおよびACTIONの指定された組合せに対する統計情報収集を有効にします。

このプロシージャをコールすると、同じデータベースのすべてのインスタンス上で、サービス名、MODULE名およびACTION名の階層的な組合せに対する統計情報収集が有効になります。統計情報は、V$SERV_MOD_ACT_STATSビューを使用して参照できます。

構文

DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE(
   service_name    IN VARCHAR2,
   module_name     IN VARCHAR2,
   action_name     IN VARCHAR2 DEFAULT ALL_ACTIONS);

パラメータ

表114-9 SERV_MOD_ACT_STAT_ENABLEプロシージャのパラメータ

パラメータ	説明
`service_name`	統計情報収集が有効にされるサービスの名前。
`module_name`	モジュールの名前。サービスに対する追加の修飾子。このパラメータは省略できません。
`action_name`	アクションの名前。サービス名とモジュール名に対する追加の修飾子。このパラメータを省略するか、`ALL_ACTIONS`定数に設定すると、指定されたサービス名/モジュール名の組合せに一致するすべてのアクションに対する統計情報収集が有効になります。この場合、統計情報は、モジュール・レベルで収集されます。

使用上のノート

モジュール名/アクション名にはNULLと区別できない空文字列を指定できるため、サービス名/モジュール名/アクション名の特定の組合せに対して統計収集を有効にする指定が若干複雑になります。そのため、次のような表記規則を採用しています。

次に示す特別な定数(実際のアクション名としては使用されないような名前)が定義されています。

ALL_ACTIONS constant VARCHAR2 := '###ALL_ACTIONS';

ALL_ACTIONSを使用してアクションを指定すると、特定のモジュール名を持つすべてのアクションに対して統計情報収集が有効になります。一方、NULL(または空文字列)を指定すると、名前が空文字列であるアクションに対して統計情報収集が有効になります。

例

サービス名とMODULEの指定された組合せに対する統計情報収集を有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE( 'APPS1','PAYROLL');

サービス名とMODULEおよびACTIONの指定された組合せに対する統計情報収集を有効にするには、次のコマンドを実行します。

EXECUTE
DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE('APPS1','GLEDGER','DEBIT_ENTRY');

これら2つのコマンドを両方とも実行すると、次のような統計情報が収集されます。

APPS1サービスに関する統計情報(両方のコマンドでサービス名が指定されているため)
PAYROLLモジュール内のすべてのアクションに関する統計情報
GLEDGERモジュール内のDEBIT_ENTRYアクションに関する統計情報

114.1.9 SERV_MOD_ACT_TRACE_DISABLEプロシージャ

このプロシージャは、サービス名、MODULEおよびACTION名の指定された組合せに対して有効にされたすべてのインスタンスに対するトレースを全体で無効にします。

構文

DBMS_MONITOR.SERV_MOD_ACT_TRACE_DISABLE(
   service_name    IN  VARCHAR2,
   module_name     IN  VARCHAR2,
   action_name     IN  VARCHAR2 DEFAULT ALL_ACTIONS,
   instance_name   IN  VARCHAR2 DEFAULT NULL);

パラメータ

表114-10 SERV_MOD_ACT_TRACE_DISABLEプロシージャのパラメータ

パラメータ	説明
`service_name`	トレースが無効にされるサービスの名前。
`module_name`	モジュールの名前。サービス名に対する追加の修飾子。
`action_name`	アクションの名前。サービス名とモジュール名に対する追加の修飾子。
`instance_name`	このパラメータにインスタンス名を指定すると、指定された名前を持つインスタンス(`instance_name`)に対するトレースに制限されます。

使用上のノート

module_nameパラメータにNULLを指定すると、MODULE属性が設定されないセッションに関する統計情報が収集されなくなります。

例

APPS1という名前のサービスに対するトレースを有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1',
            DBMS_MONITOR.ALL_MODULES,  DBMS_MONITOR.ALL_ACTIONS,TRUE,
FALSE,NULL);

前のステップで指定したトレースを無効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_DISABLE('APPS1');

サービスおよびMODULE (すべてのACTION)の指定された組合せに対するトレースを有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1','PAYROLL',
            DBMS_MONITOR.ALL_ACTIONS,TRUE,FALSE,NULL);

前のステップで指定したトレースを無効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_DISABLE('APPS1','PAYROLL');

114.1.10 SERV_MOD_ACT_TRACE_ENABLEプロシージャ

このプロシージャでは、instance_nameが指定されていないかぎり、サービス名、MODULEおよびACTIONの指定された組合せに対するSQLトレースを全体で有効にします。

構文

DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE(
   service_name    IN VARCHAR2,
   module_name     IN VARCHAR2 DEFAULT ANY_MODULE,
   action_name     IN VARCHAR2 DEFAULT ANY_ACTION,
   waits           IN BOOLEAN DEFAULT TRUE,
   binds           IN BOOLEAN DEFAULT FALSE,
   instance_name   IN VARCHAR2 DEFAULT NULL, 
   plan_stat       IN VARCHAR2 DEFAULT NULL);

パラメータ

表114-11 SERV_MOD_ACT_TRACE_ENABLEプロシージャのパラメータ

パラメータ	説明
`service_name`	SQLトレースが有効にされるサービス名。
`module_name`	SQLトレースが有効にされる`MODULE`の名前。サービス名に対する追加の修飾子(オプション)。省略すると、特定のサービス内のすべてのモジュールおよびアクションに対してSQLトレースが有効になります。
`action_name`	SQLトレースが有効にされる`ACTION`の名前。サービスと`MODULE`名に対する追加の修飾子(オプション)。省略すると、特定のモジュール内のすべてのアクションに対してSQLトレースが有効になります。
`waits`	`TRUE`の場合、待機情報がトレースに存在します。
`binds`	`TRUE`の場合、バインド情報がトレースに存在します。
`instance_name`	このパラメータにインスタンス名を指定すると、指定された名前を持つインスタンス(`instance_name`)に対するトレースに制限されます。
`plan_stat`	行ソース統計をダンプする頻度。値は'`NEVER`'、'`FIRST_EXECUTION`'(`NULL`と同じ)または'`ALL_EXECUTIONS`'です。

使用上のノート

このプロシージャは、サービス、MODULEおよびACTION名の指定された組合せに対するトレースを有効にします。指定は完全に階層的であり、「サービス名」、「サービス名とMODULE」、「サービス名、MODULE、およびACTION名」を指定する必要があります。修飾子を省略すると、ワイルドカードを使用した場合と同様に動作するため、ACTIONを省略すると、すべてのACTIONを指定した場合と同じになります。ALL_ACTIONS定数も同じ目的に使用できます。
このトレースは、アプリケーションのMODULEまたは特定のACTIONに対するサービス・レベルが低い場合に効果的です。
デフォルトでは、データベース全体に対してトレースが実行されます。instance_nameパラメータを使用すると、トレースの対象を名前が付けられている既知のインスタンス(たとえば、低いサービス・レベルを示すことが判明しているインスタンスなど)に限定できます。
トレース情報は複数のトレース・ファイルに書き込まれるため、trcsessツールを使用してトレース情報を単一のファイルにまとめる必要があります。
module_nameパラメータにNULLを指定すると、MODULE属性が設定されないセッションに関する統計情報が収集されるようになります。

例

APPS1という名前のサービスに対するトレースを有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1',
            DBMS_MONITOR.ALL_MODULES,  DBMS_MONITOR.ALL_ACTIONS,TRUE,
FALSE,NULL);

サービスおよびMODULE (すべてのACTION)の指定された組合せに対するトレースを有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SERV_MOD_ACT_TRACE_ENABLE('APPS1','PAYROLL',
            DBMS_MONITOR.ALL_ACTIONS,TRUE,FALSE,NULL);

114.1.11 SESSION_TRACE_DISABLEプロシージャ

このプロシージャは、指定されたデータベース・セッションに対するトレースをローカル・インスタンス上で無効にします。

構文

DBMS_MONITOR.SESSION_TRACE_DISABLE(
   session_id      IN     BINARY_INTEGER DEFAULT NULL,
   serial_num      IN     BINARY_INTEGER DEFAULT NULL);

パラメータ

表114-12 SESSION_TRACE_DISABLEプロシージャのパラメータ

パラメータ	説明
`session_id`	SQLトレースが無効にされるデータベース・セッション識別子。
`serial_num`	現行のデータベース・セッションのシリアル番号。

使用上のノート

serial_numがNULLで、session_idが指定されている場合は、セッションのシリアル番号に関係なく、指定されたsession_idを持つセッションがトレースされなくなります。session_idとserial_numが両方ともNULLの場合は、現行ユーザーのセッションはトレースされなくなります。session_idにNULLを指定し、serial_numにNULL以外を指定することはできません。また、NULL値はデフォルトであり、省略できます。

例

指定したクライアントのセッション識別子を持つクライアント・セッションに対するトレースを有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(7,4634, TRUE, FALSE);

前のステップで指定したトレースを無効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_DISABLE(7,4634);;

114.1.12 SESSION_TRACE_ENABLEプロシージャ

このプロシージャは、指定されたデータベース・セッションIDに対するSQLトレースをローカル・インスタンス上で有効にします。

構文

DBMS_MONITOR.SESSION_TRACE_ENABLE(
    session_id   IN  BINARY_INTEGER DEFAULT NULL,
    serial_num   IN  BINARY_INTEGER DEFAULT NULL,
    waits        IN  BOOLEAN DEFAULT TRUE,
    binds        IN  BOOLEAN DEFAULT FALSE,
    plan_stat    IN  VARCHAR2 DEFAULT NULL);

パラメータ

表114-13 SESSION_TRACE_ENABLEプロシージャのパラメータ

パラメータ	説明
`session_id`	SQLトレースが有効にされるクライアント識別子。省略する(または`NULL`の)場合は、ユーザー自身のセッションが想定されます。
`serial_num`	現行のデータベース・セッションのシリアル番号。省略する(または`NULL`の)場合は、セッションIDのみを使用してセッションが決定されます。
`waits`	`TRUE`の場合、待機情報がトレースに存在します。
`binds`	`TRUE`の場合、バインド情報がトレースに存在します。
`plan_stat`	行ソース統計をダンプする頻度。値は'`NEVER`'、'`FIRST_EXECUTION`'(`NULL`と同じ)または'`ALL_EXECUTIONS`'です。

使用上のノート

このプロシージャは、指定されたデータベース・セッションに対するトレースを有効にし、クライアント/サーバー・アプリケーションでも使用できます。データベース・セッションは複数のインスタンスに及ばないため、トレースはコール元が接続されているインスタンス上のみで有効になります。このトレースはローカル・インスタンス上のみで実行されます。

serial_numがNULLで、session_idが指定されている場合は、セッションのシリアル番号に関係なく、指定されたsession_idを持つセッションがトレースされます。session_idとserial_numが両方ともNULLの場合は、現行ユーザーのセッションがトレースされます。session_idにNULLを指定し、serial_numにNULL以外を指定することはできません。また、NULL値はデフォルトであり、省略できます。

例

指定したクライアントのセッション識別子を持つクライアント・セッションに対するトレースを有効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(7,4634, TRUE, FALSE);

前のステップで指定したトレースを無効にするには、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_DISABLE(7,4634);

次のいずれかのコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(5);

または

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(5, NULL);

セッションID 5でセッションがトレースされます。同時に、次のいずれかのコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE();

または

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(NULL, NULL);

現行のユーザー・セッションがトレースされます。また、次のコマンドを実行します。

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(NULL, NULL, TRUE, TRUE);

待機情報とバインド情報を収集しながら現行のユーザー・セッションがトレースされます。また、同じトレースを、キーワード構文を使用して次のようにも実行できます。

EXECUTE DBMS_MONITOR.SESSION_TRACE_ENABLE(binds=>TRUE);