18 カスタム収集の実行

カスタム収集オプションを使用して、診断収集をデフォルトから変更します。

18.1 診断データ収集の期間の調整

Oracle Trace File Analyzerは、過去12時間以内に更新された重要なログの切捨ておよび収集を行います。

より短い期間のログのみが必要であることがわかっている場合は、この収集期間を短縮できます。収集期間を短縮することで、可能なかぎり収集を少なくし、迅速に実行できます。

収集の期間は、次の4つの方法で指定できます。

表18-1 収集期間の指定方法

コマンド 説明

tfactl diagcollect -last n h|d

過去n時間またはn日間を対象に収集します。

tfactl diagcollect -from “yyyy-mm-dd

特定の日付(オプションで時刻を指定)を対象に収集します。

有効な日付と時刻の形式:

"Mon/dd/yyyy hh:mm:ss"

"yyyy-mm-dd hh:mm:ss"

"yyyy-mm-ddThh:mm:ss"

"yyyy-mm-dd"

tfactl diagcollect –from "yyyy-mm-dd" -to "yyyy-mm-dd"

指定した日付(オプションで時刻を指定)の間を対象に収集します。

有効な日付と時刻の形式:

"Mon/dd/yyyy hh:mm:ss"

"yyyy-mm-dd hh:mm:ss"

"yyyy-mm-ddThh:mm:ss"

"yyyy-mm-dd"

tfactl diagcollect -for “yyyy-mm-dd

指定した日付を対象に収集します。

有効な日付フォーマット:

"Mon/dd/yyyy"

"yyyy-mm-dd"

18.2 特定のノードからの収集

特定のノードから収集するには:

  1. 特定のノードから収集するには、次のようにします。
    tfactl diagcollect –node list of nodes
    次に例を示します。
    $ tfactl diagcollect -last 1d -node myserver65

関連項目

18.3 特定のコンポーネントからの収集

特定のコンポーネントから収集するには:

  1. 特定のコンポーネントから収集するには、次のようにします。
    tfactl diagcollect component

    次に例を示します。

    データベースhrdbおよびfdbから過去1日間のすべてのファイルを切捨ておよび収集するには、次のようにします。
    $ tfactl –diagcollect –database hrdb,fdb –last 1d
    node1およびnode2から過去6時間に更新されたすべてのCRSファイル、オペレーティング・システム・ログおよびCHMOS/OSWデータを切捨ておよび収集するには、次のようにします。
    $ tfactl diagcollect -crs -os -node node1,node2 -last 6h
    指定の開始時間と終了時間の間に更新された、node1のすべてのOracle ASMログを切捨ておよび収集するには、次のようにします。
    $ tfactl diagcollect -asm -node node1 -from "2016-08-15" -to "2016-08-17"
    使用可能なコンポーネント・オプションは次のとおりです。

    表18-2 コンポーネント・オプション

    コンポーネント・オプション 説明

    -database database_names

    カンマ区切りリストで指定したデータベースからデータベース・ログを収集します。

    -asm

    Oracle ASMログを収集します。

    -crsclient

    GIBASE/diag/clients下のクライアント・ログを収集します。

    -dbclient

    DB ORABASE/diag/clients下のクライアント・ログを収集します。

    -dbwlm

    DBWLMログを収集します。

    -tns

    TNSログを収集します。

    -rhp

    RHPログを収集します。

    -procinfo

    すべてのプロセスについて/procからGathers stackおよびfdを収集します。

    -afd

    AFDログを収集します。

    -crs

    CRSログを収集します。

    -wls

    WLSログを収集します。

    -emagent

    EMAGENTログを収集します。

    -oms

    OMSログを収集します。

    -ocm

    OCMログを収集します。

    -emplugins

    EMPLUGINSログを収集します。

    -em

    EMログを収集します。

    -acfs

    ACFSログおよびデータを収集します。

    -install

    Oracleインストール関連のファイルを収集します。

    -cfgtools

    CFGTOOLSログを収集します。

    -os

    /var/log/messagesなどのオペレーティング・システム・ファイルを収集します。

    -ashhtml

    生成されたASHのHTMLレポートを収集します。

    -ashtext

    生成されたASHのテキスト・レポートを収集します。

    -awrhtml

    AWRHTMLログを収集します。

関連項目

18.4 特定のディレクトリからの収集

Oracle Trace File Analyzerは、すべてのOracle診断を検出し、タイプと最終更新時間に基づいて関連ファイルを収集します。

他のファイルを収集する場合は、追加のディレクトリを指定できます。Oracle Trace File Analyzerは関連する時間範囲(デフォルトでは12時間)内に更新されたファイルのみを収集します。

最終更新時間に関係なく、すべてのファイルの収集を構成できます。-collectallオプションを使用して、ディレクトリごとに構成します。

特定のディレクトリから収集するには:

  1. 過去12時間に更新されたすべてのファイルが含まれるようにするには、次のようにします。
    tfactl diagcollect –collectdir dir1,dir2,...dirn

    次に例を示します。

    過去12時間に更新されたすべてのCRSファイルに加えて、開始ノードの/tmp_dir1および/tmp_dir2のすべてのファイルを切捨ておよび収集するには、次のようにします。
    $ tfactl diagcollect –crs –collectdir /tmp_dir1,/tmpdir_2
  2. Oracle Trace File Analyzerを構成してすべてのディレクトリからファイルを収集するには、まず-collectallオプションを指定して構成します。
    $ tfactl add dir -collectall

    または

    tfactl modify dir -collectall
    -collectalldirsオプションを使用して、診断収集を開始します。
    $ tfactl diagcollect -collectalldirs

    注意:

    -collectalldirsオプションが正常に使用されていない場合は、ファイル・タイプ、名前、および時間範囲の制限が適用されます。

関連項目

18.5 収集名の変更

Oracle Trace File Analyzerは収集を圧縮し、次の命名形式を使用して、zipファイルをリポジトリ・ディレクトリに格納します。

repository/collection_date_time/node_all/node.tfa_date_time.zip

zipファイルの名前の変更には、次のオプションのみを使用する必要があります。ファイル名を手動で変更すると、Oracleサポートの様々なセルフサービス・ツールで収集を使用できなくなります。

収集名を変更するには:

  1. 独自の名前を使用して収集を整理するには、次のようにします。
    –tag tagname

    ファイルはリポジトリ内のtagnameディレクトリに収集されます。

    次に例を示します。
    $ tfactl diagcollect -last 1h -tag MyTagName
    Collecting data for all nodes
    ....
    ....
    
    Logs are being collected to: /scratch/app/crsusr/tfa/repository/MyTagName
    /scratch/app/crsusr/tfa/repository/MyTagName/rws1290666.tfa_Mon_Aug_22_05_26_17_PDT_2016.zip
    /scratch/app/crsusr/tfa/repository/MyTagName/rws1290665.tfa_Mon_Aug_22_05_26_17_PDT_2016.zip
    
  2. zipファイルの名前を変更するには、次のようにします。
    –z zip name
    次に例を示します。
    $ tfactl diagcollect -last 1h -z MyCollectionName.zip
    Collecting data for all nodes
    ....
    ....
    Logs are being collected to: /scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_05_13_41_PDT_2016_node_all
    /scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_05_13_41_PDT_2016_node_all/myserver65.tfa_MyCollectionName.zip
    /scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_05_13_41_PDT_2016_node_all/myserver66.tfa_MyCollectionName.zip
    

関連項目

18.6 zipファイルのコピーおよびファイルの切捨ての禁止

デフォルトでは、Oracle Trace File Analyzer Collectorは次のように動作します。

  • リモート・ノードから開始ノードにすべてのzipファイルをコピーします。

  • 関連する時間の前後でファイルを切り捨てます。

zipファイルのコピーおよびファイルの切捨てを禁止するには:

  1. zipファイルが開始ノードにコピーされないようにするには、次のようにします。
    –nocopy
    次に例を示します。
    $ tfactl diagcollect -last 1d -nocopy
  2. ファイルが切り捨てられないようにするには、次のようにします。
    –notrim
    次に例を示します。
    $ tfactl diagcollect -last 1d -notrim

関連項目

18.7 サイレント収集の実行

  1. サイレント収集を開始するには、次のようにします。
    –silent

    diagcollectコマンドはバックグラウンド・プロセスとして送信されます。

    次に例を示します。
    $ tfactl diagcollect -last 1d -silent

関連項目

18.8 コア・ファイルの収集の禁止

  1. コア・ファイルが含まれないようにするには、次のようにします。
    –nocores
    次に例を示します。
    $ tfactl diagcollect -last 1d -nocores

関連項目

18.9 インシデント・パッケージング・サービス(IPS)パッケージの収集

Oracleデータベースによって、インシデント・パッケージング・サービス・パッケージの問題の詳細が、後で診断するためにADRに格納されます。

構文

Oracle Trace File Analyzerは、IPSを実行し、これらのパッケージを問い合せて収集します。

tfactl ips option

表18-3 tfactl ipsコマンドのパラメータ

コマンド 説明

tfactl ips

IPSを実行します。

tfactl ips show incidents

すべてのIPSインシデントを表示します。

tfactl ips show problems

すべてのIPSの問題を表示します。

tfactl ips show package

すべてのIPSパッケージを表示します。

tfactl diagcollect -ips -h

使用可能なすべてのdiagcollect IPSオプションを表示します。

tfactl diagcollect -ips

プロンプトに続けて、IPS収集を実行します。すべての標準のdiagcollectオプションを使用して、IPS収集の範囲を制限できます。

tfactl diagcollect -ips -adrbasepath adr_base -adrhomepath adr_home

サイレント・モードでIPS収集を実行します。

tfactl diagcollect -ips -incident incident_id

特定のインシデントIDに関するADRの詳細を収集します。

tfactl diagcollect -ips -problem problem_id

特定の問題IDに関するADRの詳細を収集します。

IPSパッケージの内容を変更できます。次のオプションを使用します。

  1. 収集を開始します。

  2. -manageipsオプションを使用して、収集を一時停止します。

    次に例を示します。

    $ tfactl diagcollect -ips -incident incident_id -manageips -node local
  3. print suspendedipsオプションを使用して、一時停止した収集を見つけます。

    次に例を示します。

    $ tfactl print suspendedips
  4. パッケージを操作します。

  5. -resumeipsオプションを使用して、収集を再開します。

    次に例を示します。

    $ tfactl diagcollect -resumeips collection_id

例18-1インシデントの表示

$ tfactl ips show incidents

ADR Home = /scratch/app/crsusr/diag/clients/user_crsusr/host_622665046_106:

*************************************************************************
0 rows fetched

ADR Home = /scratch/app/crsusr/diag/afdboot/user_root/host_622665046_106:

*************************************************************************
0 rows fetched

ADR Home = /scratch/app/crsusr/diag/rdbms/_mgmtdb/-MGMTDB:

*************************************************************************

INCIDENT_ID PROBLEM_KEY CREATE_TIME 

-------------------- ----------------------------------------------------------- ---------------------------------------- 

12913 ORA 700 [kskvmstatact: excessive swapping observed] 2016-06-30 14:05:48.491000 -07:00 

12914 ORA 700 [kskvmstatact: excessive swapping observed] 2016-06-30 15:06:16.545000 -07:00 

13161 ORA 445 2016-06-30 15:10:53.756000 -07:00 

ADR Home = /scratch/app/crsusr/diag/asm/+asm/+ASM1:

*************************************************************************

INCIDENT_ID PROBLEM_KEY CREATE_TIME 

-------------------- ----------------------------------------------------------- ---------------------------------------- 

1177 ORA 445 2016-06-30 15:10:12.930000 -07:00 

ADR Home = /scratch/app/crsusr/diag/asm/user_root/host_622665046_106:

*************************************************************************

例18-2 問題の表示

$ tfactl ips show problems

ADR Home = /scratch/app/crsusr/diag/afdboot/user_root/host_622665046_106:

*************************************************************************

0 rows fetched

ADR Home = /scratch/app/crsusr/diag/rdbms/_mgmtdb/-MGMTDB:

*************************************************************************

PROBLEM_ID  PROBLEM_KEY LAST_INCIDENT LASTINC_TIME 

-------------------- ----------------------------------------------------------- --------------------

1 ORA 700 [kskvmstatact: excessive swapping observed] 12914 2016-06-30 15:06:16.545000 -07:00 

2 ORA 445 13161  2016-06-30 15:10:53.756000 -07:00 

ADR Home = /scratch/app/crsusr/diag/asm/+asm/+ASM1:

*************************************************************************

PROBLEM_ID PROBLEM_KEY LAST_INCIDENT LASTINC_TIME 

-------------------- ----------------------------------------------------------- --------------------

1 ORA 445 1177 2016-06-30 15:10:12.930000 -07:00

例18-3 パッケージの表示

$ tfactl ips show package

			Multiple ADR homepaths were found for /scratch/app/crsusr, please select one ...

			( ) option[0] diag/asmtool/user_root/host_622665046_106 
			( ) option[1] diag/asmtool/user_crsusr/host_622665046_106 
			( ) option[2] diag/clients/user_root/host_622665046_106 
			( ) option[3] diag/clients/user_crsusr/host_622665046_106 
			( ) option[4] diag/afdboot/user_root/host_622665046_106 
			( ) option[5] diag/rdbms/_mgmtdb/-MGMTDB 
				option[6] Done

			Pls select a homepath [6] ?5
			diag/rdbms/_mgmtdb/-MGMTDB was selected 

			   PACKAGE_ID             1
			   PACKAGE_NAME           ORA700kge_20160731211334
			   PACKAGE_DESCRIPTION    
			   DRIVING_PROBLEM        2
			   DRIVING_PROBLEM_KEY    ORA 700 [kgerev1]
			   DRIVING_INCIDENT       42605
			   DRIVING_INCIDENT_TIME  2016-07-05 07:53:28.578000 -07:00
			   STATUS                 Generated (4)
			   CORRELATION_LEVEL      Typical (2)
			   PROBLEMS               2 main problems, 0 correlated problems
			   INCIDENTS              2 main incidents, 0 correlated incidents
			   INCLUDED_FILES         84

			   PACKAGE_ID             2
			   PACKAGE_NAME           IPSPKG_20160801203518
			   PACKAGE_DESCRIPTION    
			   DRIVING_PROBLEM        N/A
			   DRIVING_PROBLEM_KEY    N/A
			   DRIVING_INCIDENT       N/A
			   DRIVING_INCIDENT_TIME  N/A
			   STATUS                 Generated (4)
			   CORRELATION_LEVEL      Typical (2)
			   PROBLEMS               0 main problems, 0 correlated problems
			   INCIDENTS              0 main incidents, 0 correlated incidents
			   INCLUDED_FILES         27

例18-4 IPS収集

$ tfactl diagcollect -ips

Collecting data for the last 12 hours for this component ...
Collecting data for all nodes
Creating ips package in master node ...

Multiple ADR homepaths were found for /scratch/app/crsusr, please select one or more...

( ) option[0] diag/asmtool/user_root/host_622665046_106 
( ) option[1] diag/asmtool/user_crsusr/host_622665046_106 
( ) option[2] diag/clients/user_root/host_622665046_106 
( ) option[3] diag/clients/user_crsusr/host_622665046_106 
( ) option[4] diag/afdboot/user_root/host_622665046_106 
( ) option[5] diag/rdbms/_mgmtdb/-MGMTDB 
    option[6] Done

Pls select a homepath [6] ?5
diag/rdbms/_mgmtdb/-MGMTDB was selected 

Please select at least one ADR homepath.

Multiple ADR homepaths were found for /scratch/app/crsusr, please select one or more...

( ) option[0] diag/asmtool/user_root/host_622665046_106 
( ) option[1] diag/asmtool/user_crsusr/host_622665046_106 
( ) option[2] diag/clients/user_root/host_622665046_106 
( ) option[3] diag/clients/user_crsusr/host_622665046_106 
( ) option[4] diag/afdboot/user_root/host_622665046_106 
(*) option[5] diag/rdbms/_mgmtdb/-MGMTDB 
    option[6] Done

Pls select a homepath [6] ?
Trying ADR basepath /scratch/app/crsusr
Trying to use ADR homepath diag/rdbms/_mgmtdb/-MGMTDB ...
Submitting request to generate package for ADR homepath /scratch/app/crsusr/diag/rdbms/_mgmtdb/-MGMTDB
Master package completed for ADR homepath /scratch/app/crsusr/diag/rdbms/_mgmtdb/-MGMTDB
Created package 15 based on time range 2016-08-21 15:58:00.000000 -07:00 to 2016-08-22 03:58:00.000000 -07:00, 
correlation level basic
Remote package completed for ADR homepath(s) /diag/rdbms/_mgmtdb/-MGMTDB


Collection Id : 20160822035856myserver65

Detailed Logging at : /scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_03_58_56_PDT_2016_node_all/
diagcollect_20160822035856_myserver65.log
2016/08/22 03:59:40 PDT : Collection Name : tfa_Mon_Aug_22_03_58_56_PDT_2016.zip
2016/08/22 03:59:40 PDT : Collecting diagnostics from hosts : [myserver65, myserver66]
2016/08/22 03:59:40 PDT : Getting list of files satisfying time range [08/21/2016 15:59:40 PDT, 08/22/2016 03:59:40 PDT]
2016/08/22 03:59:40 PDT : Collecting additional diagnostic information...
2016/08/22 03:59:51 PDT : Completed collection of additional diagnostic information...
2016/08/22 03:59:51 PDT : Completed Local Collection
2016/08/22 03:59:51 PDT : Remote Collection in Progress...
.---------------------------------------.
|           Collection Summary          |
+------------+-----------+-------+------+
| Host       | Status    | Size  | Time |
+------------+-----------+-------+------+
| myserver66 | Completed | 254kB |  16s |
| myserver65 | Completed | 492kB |  11s |
'------------+-----------+-------+------'

Logs are being collected to: /scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_03_58_56_PDT_2016_node_all
/scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_03_58_56_PDT_2016_node_all/
myserver66.tfa_Mon_Aug_22_03_58_56_PDT_2016.zip
/scratch/app/crsusr/tfa/repository/collection_Mon_Aug_22_03_58_56_PDT_2016_node_all/
myserver65.tfa_Mon_Aug_22_03_58_56_PDT_2016.zip

関連項目