9.3.1.17 tfactl print

tfactl printコマンドを使用して、Berkeley DB (BDB)から情報を出力します。

構文

tfactl print command [options]
Commands: status|components|config|directories|hosts|actions|repository|runmode|suspendedips|protocols|smtp|collections
tfactl print status
tfactl print components [ [component_name1] [component_name2] ... [component_nameN] ]
tfactl print config [ -node all | local | n1,n2,...  -name param]
tfactl print directories [ -node all | local | n1,n2,... ] [ -comp component_name1,component_name2,... ] [ -policy exclusions | noexclusions ] 
[ -permission public | private ]
tfactl print collections [ -status status ] [ -last <n><m|h|d> ] [-id] [ -json ]
tfactl print hosts
tfactl print actions [ -status status ] [ -since nh|d ]
tfactl print repository
tfactl print runmode
tfactl print suspendedips
tfactl print protocols
tfactl print smtp
tfactl print collections -status QUEUED
tfactl print collections -status COMPLETED

パラメータ

表9-57 tfactl printコマンドのパラメータ

パラメータ 説明

status

クラスタ内のすべてのノードにおけるOracle Trace File Analyzerのステータスを表示します。さらに、Oracle Trace File Analyzerのバージョン、およびそれが実行されているポートも表示します。

components

構成内の対象のコンポーネントを表示します。

config

現在のOracle Trace File Analyzerの構成設定を表示します。

directories

Oracle Trace File Analyzerがトレース・ファイルまたはログ・ファイルのデータをスキャンするすべてのディレクトリをリストします。さらに、データベース、Oracle ASMおよびインスタンスに割り当てられているトレース・ディレクトリの場所も表示します。

hosts

Oracle Trace File Analyzerクラスタの一部であり、クラスタ全体のコマンドを受信できるホストをリストします。

actions

診断収集など、Oracle Trace File Analyzerに送信されたアクションをすべてリストします。デフォルトでは、tfactl printコマンドでは、実行中のアクションまたは過去1時間に完了したアクションのみが表示されます。

repository

リポジトリ・ディレクトリの現在の場所および使用済領域の量を表示します。最初、リポジトリ・ディレクトリの最大サイズは、10 GBまたは使用可能なファイル・システム領域の50%のいずれか小さい方です。最大サイズを超えた場合、またはファイル・システム領域が1 GB以下になった場合、Oracle Trace File Analyzerは操作を一時停止し、リポジトリを閉じます。tfactl purgeコマンドを使用して、リポジトリから収集をクリアします。

suspendedips

一時停止中のすべてのOracle Trace File AnalyzerのIPS収集をリストします。

protocols

使用可能なすべてのプロトコルおよび制限付きプロトコルをリストします。

smtp

SMTPサーバー構成を表示します

オプション

tfactl print collections [ -status status ] [ -last <n><m|h|d> ] [ -json ]
オプション 説明

-status status

収集ステータスには次のものがあります。
  • running
  • queued
  • completed

-last nh|d

-since

過去n日またはn時間以降の収集を出力する場合に指定します。

-lastと同じです。下位互換性のために保持されています。

-id

詳細を表示するコレクションIDを指定します。

-json

JSON形式で出力を生成する場合に指定します。

例9-57 tfactl print runmode

tfactl print runmode
TFA Run Mode: COLLECTOR

例9-58 tfactl print smtp

tfactl print smtp
.---------------------------.
| SMTP Server Configuration |
+---------------+-----------+
| Parameter     | Value     |
+---------------+-----------+
| smtp.auth     | false     |
| smtp.from     | tfa       |
| smtp.user     | -         |
| smtp.cc       | -         |
| smtp.port     |        25 |
| smtp.bcc      | -         |
| smtp.password | *******   |
| smtp.host     | localhost |
| smtp.to       | -         |
| smtp.debug    | true      |
| smtp.ssl      | false     |
'---------------+-----------'

例9-59 tfactl print protocols

tfactl print protocols
.--------------------------------------------------.
|                    node1                         |
+--------------------------------------------------+
| Protocols                                        |
+--------------------------------------------------+
| Available : [TLSv1.2]                            |
| Restricted : [SSLv3, SSLv2Hello, TLSv1, TLSv1.1] |
'--------------------------------------------------'

例9-60 tfactl print components ASM

$ tfactl print components ASM
.--------------------------------------------------.
|                  XML Components                  |
+---------------+----------------------------------+
| Field         | Value                            |
+---------------+----------------------------------+
| Name          | ASM                              |
| Description   | ASM logs                         |
| Comp. Types   | collection action                |
| Configuration | all                              |
| Subcomponents | name:instance required: default: |
| Also collect  | TNS                              |
|               | AFD                              |
|               | ASMPROXY                         |
|               | ASMIO                            |
'---------------+----------------------------------'

例9-61 tfactl print components ODASTORAGE

$ tfactl print components ODASTORAGE
.-------------------------------------------.
|               XML Components              |
+---------------+---------------------------+
| Field         | Value                     |
+---------------+---------------------------+
| Name          | ODASTORAGE                |
| Description   | ODA Storage logs and Data |
| Comp. Types   | action                    |
| Configuration | ODA                       |
| Also collect  | OS                        |
|               | ODA                       |
|               | ASM                       |
|               | DCS                       |
'---------------+---------------------------'

例9-62 tfactl print collections -id -json

tfactl print collections -id 20240104010433stbm000004-vm18 -json
[
    {
        “CollectionId”: “20240104010433stbm000004-vm18",
        “InitiatedNode”: “stbm000004-vm18",
        “CollectionType”: “Manual Collection”,
        “RequestUser”: “root”,
        “NodeList”: “[stbm000004-vm17, stbm000004-vm18]“,
        “StartTime”: “2024-01-04T00:04:30.000-0600",
        “EndTime”: “2024-01-04T01:04:30.000-0600",
        “ComponentList”: “[omsi, emagent, acfs, asmproxy, sosreport, crsclient,
emagenti, oms, qos, dbwlm, ocm, cha, cfgtools, afd, avs, dbclient, rdbms, cvu,
os, crs, syslens, hami, em, chmos, goldengate, asmio, dataguard, install,
compliance, tns, asm, rhp, emplugins, wls]“,
        “UploadStatus”: “FAILED”,
        “CollectionStatus”: “COMPLETED”,
        “NodeCollection”: [
            {
                “Host”: “stbm000004-vm18”,
                “Tag”:
“/u01/app/giusr/oracle.ahf/data/repository/collection_Thu_Jan_04_01_04_37_CST_2024_node_all/“,
                “ZipFileName”:
“/u01/app/giusr/oracle.ahf/data/repository/collection_Thu_Jan_04_01_04_37_CST_2024_node_all/stbm000004-vm18.tfa_Thu_Jan_04_01_04_36_CST_2024.zip”,
                “ZipFileSize”: “38896",
                “CollectionTime”: “183",
                “CheckSum”:
“d882835fe5bcee4b8d5381b59572f2b75dc7499ddf3adf5771e3ea75fa39e975",
                “checksum_algo”: “sha256"
            },
            {
                “Host”: “stbm000004-vm17",
                “Tag”:
“/u01/app/giusr/oracle.ahf/data/repository/collection_Thu_Jan_04_01_04_37_CST_2024_node_all/“,
                “ZipFileName”:
“/u01/app/giusr/oracle.ahf/data/repository/collection_Thu_Jan_04_01_04_37_CST_2024_node_all/stbm000004-vm17.tfa_Thu_Jan_04_01_04_36_CST_2024.zip”,
                “ZipFileSize”: “42759",
                “CollectionTime”: “186",
                “CheckSum”:
“b090611f11e94814782b12f798e60ef0e054fbad47e94d950a3a24c698a79986",
                “checksum_algo”: “sha256"
            }
        ]
    }
]

例9-63 tfactl print config

tfactl print config
.------------------------------------------------------------------------------------.
|                                      node1                                         |
+-----------------------------------------------------------------------+------------+
| Configuration Parameter                                               | Value      |
+-----------------------------------------------------------------------+------------+
| TFA Version                                                           | 19.1.0.0.0 |
| Java Version                                                          | 1.8        |
| Public IP Network                                                     | false      |
| Automatic Diagnostic Collection                                       | true       |
| Alert Log Scan                                                        | true       |
| Disk Usage Monitor                                                    | true       |
| Managelogs Auto Purge                                                 | false      |
| Trimming of files during diagcollection                               | true       |
| Inventory Trace level                                                 | 1          |
| Collection Trace level                                                | 1          |
| Scan Trace level                                                      | 1          |
| Other Trace level                                                     | 1          |
| Granular Tracing                                                      | false      |
| Debug Mask (Hex)                                                      | 0          |
| Repository current size (MB)                                          | 146        |
| Repository maximum size (MB)                                          | 10240      |
| Max Size of TFA Log (MB)                                              | 50         |
| Max Number of TFA Logs                                                | 10         |
| Max Size of Core File (MB)                                            | 50         |
| Max Collection Size of Core Files (MB)                                | 500        |
| Max File Collection Size (MB)                                         | 5120       |
| Minimum Free Space to enable Alert Log Scan (MB)                      | 500        |
| Time interval between consecutive Disk Usage Snapshot(minutes)        | 60         |
| Time interval between consecutive Managelogs Auto Purge(minutes)      | 60         |
| Logs older than the time period will be auto purged(days[d]|hours[h]) | 30d        |
| Automatic Purging                                                     | true       |
| Age of Purging Collections (Hours)                                    | 12         |
| TFA IPS Pool Size                                                     | 5          |
| TFA ISA Purge Age (seconds)                                           | 604800     |
| TFA ISA Purge Mode                                                    | profile    |
| TFA ISA Purge Thread Delay (minutes)                                  | 60         |
| Setting for ACR redaction (none|SANITIZE|MASK)                        | none       |
| Email Notification will be sent for CHA EVENTS if address is set      | false      |
| AUTO Collection will be generated for CHA EVENTS                      | false      |
'-----------------------------------------------------------------------+------------' 

前述の出力例:

  • Automatic diagnostic collection: ONの場合(デフォルトはOFF)、アラート・ログのスキャンでログ内に特定のイベントが検出されたときに、診断収集がトリガーされます。

  • Trimming of files during diagcollection: 指定された時間範囲内のデータのみを含むようにOracle Trace File Analyzerが大きいファイルを切り捨てるかどうかを指定します。切捨てがOFFの場合、自動診断収集ではトレース・ファイルの切捨ては行われません。

  • Repository current size in MB: リポジトリの使用済領域の量です。

  • Repository maximum size in MB: リポジトリ内の記憶領域の最大サイズです。最初、最大サイズは、10 GBまたはファイル・システム内の空き領域の50%のいずれか小さい方に設定されています。

  • Trace Level: デフォルトは1で、値を2、3および4にすると詳細度が高くなります。Oracle Trace File Analyzerデーモンの実行に合わせてトレース・レベルを動的に設定できますが、トレース・レベルを上げると、Oracle Trace File Analyzerのパフォーマンスに大きく影響します。My Oracle Supportから要請があった場合にのみトレース・レベルを上げてください。

  • Automatic Purging: Oracle Trace File Analyzerの収集の自動パージは、デフォルトで有効になっています。経過期間がMinimum Age of Collections to Purgeの値を超え、リポジトリの容量がなくなると、Oracle Trace File Analyzerの収集がパージされます。

  • Minimum Age of Collections to Purge (Hours): Oracle Trace File Analyzerが収集をパージするまでに、Oracle Trace File Analyzerが収集を保持する最小時間数です。時間数を設定するには、tfactl set minagetopurge=hoursコマンドを使用します。

  • Minimum Space free to enable Alert Log Scan (MB): 領域が空くまでOracle Trace File Analyzerがアラート・ログのスキャンを一時的に停止する際の容量の制限(MB単位)です。メタデータ・データベースに使用されているファイル・システムの容量が制限を下回った場合、Oracle Trace File Analyzerはアラート・ログ・イベントを格納しません。