1. ユーザーズ・ガイド
  2. 付録
  3. Oracle Trace File Analyzerのコマンドラインおよびシェルのオプション
  4. サマリー・コマンドおよび分析コマンドの実行

サマリー・コマンドおよび分析コマンドの実行

これらのコマンドを使用して、Oracle Trace File AnalyzerのデプロイメントとステータスのサマリーおよびOracle Trace File Analyzerで検出された変更とイベントを表示します。

  • tfactl summary
    tfactl summaryコマンドを使用して、Oracle Trace File Analyzerのデプロイメントのサマリーを表示します。
  • tfactl changes
    tfactl changesコマンドを使用して、Oracle Trace File Analyzerで検出された変更を表示します。
  • tfactl events
    tfactl eventsコマンドを使用して、Oracle Trace File Analyzerで検出されたイベントを表示します。
  • tfactl analyze
    tfactl analyzeコマンドを使用して、データベース、Oracle ASMおよびOracle Grid Infrastructureのアラート・ログ、システム・メッセージ・ログ、OSWatcher Top、OSWatcher Slabinfoファイルを解析することでシステムの分析を取得します。
  • tfactl run
    tfactl runコマンドを使用して、リクエストされたアクション(インベントリ、スキャンまたは任意のサポート・ツールの場合がある)を実行します。
  • tfactl toolstatus
    tfactl toolstatusコマンドを使用して、すべてのノード間でのOracle Trace File Analyzerのサポート・ツールのステータスを表示します。

tfactl summary

tfactl summaryコマンドを使用して、Oracle Trace File Analyzerのデプロイメントのサマリーを表示します。

構文

tfactl summary

例

$ tfactl summary
Output from host : myserver69
------------------------------
=====
Nodes
=====
myserver69
myserver70
myserver71

=====
Homes
=====
.-------------------------------------------------------------------------------------------------------------------------.
| Home                                           | Type | Version    | Database          | Instance             | Patches |
+------------------------------------------------+------+------------+-------------------+----------------------+---------+
| /scratch/app/11.2.0.4/grid                     | GI   | 11.2.0.4.0 |                   |                      |         |
| /scratch/app/oradb/product/11.2.0/dbhome_11204 | DB   | 11.2.0.4.0 | apxcmupg,rdb11204 | apxcmupg_1,rdb112041 |         |
'------------------------------------------------+------+------------+-------------------+----------------------+---------'


Output from host : myserver70
------------------------------
=====
Homes
=====

.--------------------------------------------------------------------------------------------------------------.
| Home                                           | Type | Version    | Database          | Instance  | Patches |
+------------------------------------------------+------+------------+-------------------+-----------+---------+
| /scratch/app/11.2.0.4/grid                     | GI   | 11.2.0.4.0 |                   |           |         |
| /scratch/app/oradb/product/11.2.0/dbhome_11204 | DB   | 11.2.0.4.0 | apxcmupg,rdb11204 | rdb112042 |         |
'------------------------------------------------+------+------------+-------------------+-----------+---------'
Output from host : myserver71
------------------------------

=====
Homes
=====

.--------------------------------------------------------------------------------------------------------------.
| Home                                           | Type | Version    | Database          | Instance  | Patches |
+------------------------------------------------+------+------------+-------------------+-----------+---------+
| /scratch/app/11.2.0.4/grid                     | GI   | 11.2.0.4.0 |                   |           |         |
| /scratch/app/oradb/product/11.2.0/dbhome_11204 | DB   | 11.2.0.4.0 | apxcmupg,rdb11204 | rdb112043 |         |
'------------------------------------------------+------+------------+-------------------+-----------+---------'

tfactl changes

tfactl changesコマンドを使用して、Oracle Trace File Analyzerで検出された変更を表示します。

構文

tfactl changes

例

$ tfactl changes


Output from host : myserver69
------------------------------


Output from host : myserver70
------------------------------
Jul/26/2016 10:20:35 : Parameter 'sunrpc.transports' value changed : tcp 1048576 => udp 32768
Jul/26/2016 10:20:35 : Parameter 'sunrpc.transports' value changed : tcp 1048576 => tcp-bc 1048576


Output from host : myserver71
------------------------------
Jul/26/2016 10:21:06 : Parameter 'sunrpc.transports' value changed : tcp 1048576 => udp 32768
Jul/26/2016 10:21:06 : Parameter 'sunrpc.transports' value changed : tcp 1048576 => tcp-bc 1048576
-bash-4.1# tfactl analyze
INFO: analyzing all (Alert and Unix System Logs) logs for the last 60 minutes...  Please wait...
INFO: analyzing host: myserver69

                       Report title: Analysis of Alert,System Logs
                  Report date range: last ~1 hour(s)
         Report (default) time zone: UTC - Coordinated Universal Time
                Analysis started at: 26-Jul-2016 10:36:03 AM UTC
              Elapsed analysis time: 1 second(s).
                 Configuration file: /scratch/app/11.2.0.4/grid/tfa/myserver69/tfa_home/ext/tnt/conf/tnt.prop
                Configuration group: all
                Total message count:         15,261, from 20-Nov-2015 02:06:21 AM UTC to 26-Jul-2016 10:10:58 AM UTC
  Messages matching last ~1 hour(s):              1, from 26-Jul-2016 10:10:58 AM UTC to 26-Jul-2016 10:10:58 AM UTC
        last ~1 hour(s) error count:              0
last ~1 hour(s) ignored error count:              0
 last ~1 hour(s) unique error count:              0

Message types for last ~1 hour(s)
   Occurrences percent  server name          type
   ----------- -------  -------------------- -----
             1  100.0%  myserver69           generic
   ----------- -------
             1  100.0%

Unique error messages for last ~1 hour(s)
   Occurrences percent  server name          error
   ----------- -------  -------------------- -----
   ----------- -------
             0  100.0%

tfactl events

tfactl eventsコマンドを使用して、Oracle Trace File Analyzerで検出されたイベントを表示します。

構文

tfactl events

例

$ tfactl events
Output from host : myserver69
------------------------------
Jul/25/2016 06:25:33 : 
           [crs.myserver69] : [cssd(7513)]CRS-1603:CSSD on node myserver69 shutdown by user.
Jul/25/2016 06:32:41 : 
           [crs.myserver69] : [cssd(5794)]CRS-1601:CSSD Reconfiguration complete. 
Active nodes are myserver69 myserver70 myserver71 .
Jul/25/2016 06:47:37 : 
           [crs.myserver69] : [/scratch/app/11.2.0.4/grid/bin/scriptagent.bin(16233)]
CRS-5818:Aborted command 'start' for resource 'ora.oc4j'. Details at (:CRSAGF00113:) 
{1:32892:193} in /scratch/app/11.2.0.4/grid/log/myserver69/agent/crsd/scriptagent_oragrid/scriptagent_oragrid.log.
Jul/25/2016 06:24:43 : 
           [db.apxcmupg.apxcmupg_1] : Instance terminated by USER, pid = 21581
Jul/25/2016 06:24:43 : 
           [db.rdb11204.rdb112041] : Instance terminated by USER, pid = 18683
Jul/25/2016 06:24:44 : 
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "FRA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "FRA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "FRA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "FRA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "FRA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "DATA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "DATA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "DATA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "DATA" does not exist or is not mounted
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15001: diskgroup "DATA" does not exist or is not mounted
Jul/25/2016 06:24:53 : 
           [db.+ASM1] : ORA-15032: not all alterations performed
           [db.+ASM1] : ORA-15027: active use of diskgroup "VDATA" precludes its dismount
Jul/25/2016 06:25:22 : 
           [db.+ASM1] : Shutting down instance (immediate)
           [db.+ASM1] : Shutting down instance: further logons disabled

Summary :
=========
INFO   : 2
ERROR   : 26
WARNING   : 1

tfactl analyze

tfactl analyzeコマンドを使用して、データベース、Oracle ASMおよびOracle Grid Infrastructureのアラート・ログ、システム・メッセージ・ログ、OSWatcher Top、OSWatcher Slabinfoファイルを解析することでシステムの分析を取得します。

コマンドの出力をコンポーネント、エラー・タイプおよび時刻でフィルタします。

tfactl analyzeコマンドでは、次のタイプのログ・ファイル分析から選択できます。

  • ログ内の最多のメッセージを表示: この分析では、より大規模な問題が発生している場所が素早く示されます。Oracle Trace File Analyzerにより、アラート・ログから重要なメッセージが取り出され、ログ・メッセージから無関係な情報が削除され、最も頻繁に発生するメッセージが整理され、頻度の高いものから低いものの順に表示されます。デフォルトでは、Oracle Trace File Analyzerではエラー・メッセージが分析されますが、特定のタイプのメッセージを分析用に指定できます。

  • ログ・メッセージ内のテキストを検索: これは、grepユーティリティを使用した検索に似ていますが、相違点は、Oracle Trace File Analyzerが各メッセージの時刻をチェックし、分数または任意の時間間隔の最後のx個の数字が一致するもののみを表示する点です。

  • Oracle OSWatcherログ統計を分析: Oracle Trace File AnalyzerはOSWatcherログ・ファイルで使用可能な様々な統計を読み取り、各統計の最初、最高、最低、平均および最後の3つの読込み値を示す詳細な分析を表示します。特定の分または秒までの任意の間隔を選択します。Oracle Trace File Analyzerはオプションで、レポート対象の各値(データ・ポイント)について、OSWatcherログからの元のデータを表示します。

構文

tfactl analyze [-search "pattern"] [-comp db | asm | crs | acfs | os | osw | oswslabinfo | all] 
[-type error | warning | generic] [-last nh|d] 
[-from "MMM/DD/YYYY HH24:MI:SS"] [-to "MMM/DD/YYYY HH24:MI:SS"] [-for "MMM/DD/YYYY HH24:MI:SS"] 
[-node all | local | n1,n2,...] [-verbose] [-o file]

パラメータ

表-24 tfactl analyzeコマンドのパラメータ

パラメータ 説明
-search "pattern"

指定した時間範囲内のシステムおよびアラート・ログで、二重引用符("")で囲んだパターンを検索します。このパラメータでは、クラスタ全体のアラートおよびシステム・メッセージ・ファイルでの、大/小文字の区別ありと大/小文字の区別なしの両方の検索が指定したフィルタ内でサポートされています。デフォルトは大/小文字の区別なしです。

-searchパラメータを指定しないと、Oracle Trace File Analyzerでは、クラスタ全体のアラートおよびシステム・ログ・メッセージから、指定したフィルタ内のメッセージのサマリーが提供されます。

Oracle Trace File Analyzerでは、メッセージ数がタイプ(error、warningおよびgeneric)でグループ化されて表示され、一意のメッセージは分析用に選択したメッセージ・タイプで編成されて表に表示されます。genericメッセージ・タイプは、メッセージ・タイプがerrorでもwarningでもないすべてのメッセージに割り当てられます。

-comp db | asm | crs | acfs | os | osw | oswslabinfo | all

Oracle Trace File Analyzerで分析するコンポーネントを選択します。デフォルトはallです。

  • db: データベースのアラート・ログ

  • asm: Oracle ASMのアラート・ログ

  • crs: Oracle Grid Infrastructureのアラート・ログ

  • acfs: Oracle ACFSのアラート・ログ

  • os: システム・メッセージ・ファイル

  • osw: OSW Top出力

  • oswlabinfo: OSW Slabinfo出力

OSWatcherデータが使用可能の場合、OSWおよびOSWSLABINFOコンポーネントでは、OSWatcherデータのサマリー・ビューが提供されます。

-type error | warning | generic

Oracle Trace File Analyzerで分析するメッセージのタイプを選択します。デフォルトはerrorです。

-last n[h|d]

Oracle Trace File Analyzerで分析する、現在の時間より前の時間数(時間単位または日単位)を指定します。
-from | -to | -for "MMM/DD/YYYY HH24:MI:SS"

-fromと-toのパラメータを一緒に使用するか、-forパラメータを使用して、Oracle Trace File Analyzerで分析する時間間隔を指定します。

-node all | local | n1,n2,...

ホスト名のカンマ区切りリストを指定します。-localを使用して、ローカル・ノード上のファイルを分析します。デフォルトはallです。

–verbose

詳細な出力を表示します。
–o file

Oracle Trace File Analyzerが画面に表示するかわりに出力を書き込むファイルを指定します。

-typeパラメータの引数

tfactl analyzeコマンドでは、-typeパラメータを指定すると、すべてのメッセージが様々なカテゴリに分類されます。分析コンポーネントにより、構成したメッセージ・タイプごとのメッセージ数が示され、一意のメッセージはすべて指定したフィルタ内の数ごとにグループ化されてリストされます。次の表に、各引数のメッセージ・タイプのパターンを示します。

表-25 tfactl analyzeの-typeパラメータの引数

引数 説明
error

データベースおよびOracle ASMのアラート・ログのエラー・メッセージのパターン:

.*ORA-00600:.*
.*ORA-07445:.*
.*IPC Send timeout detected. Sender: ospid.*
.*Direct NFS: channel id .* path .* to filer .* PING timeout.*
.*Direct NFS: channel id .* path .* to filer .* is DOWN.*
.*ospid: .* has not called a wait for .* secs.*
.*IPC Send timeout to .* inc .* for msg type .* from opid.*
.*IPC Send timeout: Terminating pid.*
.*Receiver: inst .* binc .* ospid.*
.* terminating instance due to error.*
.*: terminating the instance due to error.*
.*Global Enqueue Services Deadlock detected

Oracle Grid Infrastructureのアラート・ログのエラー・メッセージのパターン:

.*CRS-8011:.*,.*CRS-8013:.*,.*CRS-1607:.*,.*CRS-1615:.*,
.*CRS-1714:.*,.*CRS-1656:.*,.*PRVF-5305:.*,.*CRS-1601:.*,
.*CRS-1610:.*,.*PANIC. CRSD exiting:.*,.*Fatal Error from AGFW Proxy:.*
warning

データベースおよびOracle ASMのアラート・ログの警告メッセージのパターン:

NOTE: process .* initiating offline of disk .*
.*WARNING: cache read a corrupted block group.*
.*NOTE: a corrupted block from group FRA was dumped to
generic

先行するパターンのいずれにも一致しないすべてのメッセージ。

例

次のコマンド例は、Oracle Trace File Analyzerを使用して収集済データを検索する方法を示しています。

  • $ tfactl analyze -search "error" -last 2d

    Oracle Trace File Analyzerは、過去2日間のアラートおよびシステム・ログ・ファイルで、大/小文字の区別なしの文字列errorを含むメッセージを検索します。

  • $ tfactl analyze -comp os -for "Jul/01/2016 11" -search "."

    Oracle Trace File Analyzerは、2016年7月1日、午前11時のすべてのシステム・ログ・メッセージを表示します。

  • $ tfactl analyze -search "/ORA-/c" -comp db -last 2d

    Oracle Trace File Analyzerは、過去2日間のデータベースのアラート・ログで、大/小文字の区別ありの文字列ORA-を検索します。

次のコマンド例は、Oracle Trace File Analyzerを使用して収集済データを分析する方法を示しています。

  • $ tfactl analyze -last 5h

    Oracle Trace File Analyzerは、過去5日間のすべてのアラート・ログおよびシステム・メッセージから収集されたイベントのサマリーを表示します。

  • $ tfactl analyze -comp os -last 1d

    Oracle Trace File Analyzerは、前日のシステム・メッセージからのイベントのサマリーを表示します。

  • $ tfactl analyze -last 1h -type generic

    Oracle Trace File Analyzerは、過去1時間のすべての汎用メッセージを分析します。

次のコマンド例は、Oracle Trace File Analyzerを使用してOSWatcher TopおよびSlabinfoを分析する方法を示しています。

  • $ tfactl analyze -comp osw -last 6h

    Oracle Trace File Analyzerは、過去6時間のOSWatcher Topサマリーを表示します。

  • $ tfactl analyze -comp oswslabinfo -from "2016-07-01" -to "2016-07-03"

    Oracle Trace File Analyzerは、指定した期間のOSWatcher Slabinfoサマリーを表示します。

tfactl run

tfactl runコマンドを使用して、リクエストされたアクション(インベントリ、スキャンまたは任意のサポート・ツールの場合がある)を実行します

構文

tfactl run [inventory | scan | tool]

パラメータ

表-26 tfactl runコマンドのパラメータ

パラメータ 説明

inventory

すべてのトレース・ファイル・ディレクトリのインベントリ。

scan

個別スキャンを実行します。

tool

目的の分析ツールを実行します。

分析ツール

表-27 tfactl run分析ツールのパラメータ

パラメータ 説明

changes

システム変更を出力します。

events

システムでのすべての重要なイベントをリストします。

exachk

Oracle EXAchkを実行します。

grep

ログ内の入力文字列に対してgrepを実行します。

history

現在のOracle Trace File Analyzerシェル・セッションで実行されたコマンドをリストします。

ls

Oracle Trace File Analyzerでファイルを検索します。

orachk

Oracle ORAchkを実行します。

oratop

oratopを実行します。

oswbb

OSWatcher Analyzerを実行します。

param

パラメータ値を出力します。
ps

プロセスを検索します。

pstack

プロセスでpstackを実行します。

prw

Procwatcherを実行します。

sqlt

SQLTを実行します。

summary

システム・サマリーを出力します。

tail

ログ・ファイルの末尾を表示します。

vi

ファイルを検索し、viエディタで開きます。

プロファイリング・ツール

表-28 tfactl runプロファイリング・ツールのパラメータ

パラメータ 説明

dbglevel

プロファイルを使用してCRSログおよびトレース・レベルを設定します。

tfactl toolstatus

tfactl toolstatusコマンドを使用して、すべてのノード間でのOracle Trace File Analyzerのサポート・ツールのステータスを表示します。

構文

$ tfactl toolstatus

例

tfactl toolstatusコマンドでは、次のような出力が戻され、どのツールがどこにデプロイされているかが示されます。

表-29 tfactl toolstatusの出力

ホスト ツール ステータス

hostname

alertsummary

DEPLOYED

hostname

exachk

DEPLOYED

hostname

ls

DEPLOYED

hostname

triage

DEPLOYED

hostname

pstack

DEPLOYED

hostname

orachk

DEPLOYED

hostname

sqlt

DEPLOYED

hostname

grep

DEPLOYED

hostname

summary

DEPLOYED

hostname

vi

DEPLOYED

hostname

prw

NOT RUNNING

hostname

tail

DEPLOYED

hostname

param

DEPLOYED

hostname

dbglevel

DEPLOYED

hostname

managelogs

DEPLOYED

hostname

history

DEPLOYED

hostname

oratop

DEPLOYED

hostname

calog

DEPLOYED

hostname

menu

DEPLOYED

hostname

oswbb

RUNNING

hostname

changes

DEPLOYED

hostname

events

DEPLOYED

hostname

ps

DEPLOYED

hostname

srdc

DEPLOYED