9.3.1.3 tfactl blackout

tfactl blackoutコマンドを使用して、より詳細なレベルで診断収集を抑止します。デフォルトでは、ブラックアウトは24時間有効です。

構文

tfactl blackout add|remove|print
-targettype host|crs|asm|asmdg|database|dbbackup|db_dataguard|db_tablespace|pdb_tablespace|pdb|listener|service|os
-target all|name
[-container name]
[-pdb pdb_name]
-event all|"event_str1,event_str2"|availability
[-timeout nm|nh|nd|none]
[-c|-local|-nodes "node1,node2"]
[-reason "reason for blackout"]
[-docollection]

パラメータ

表9-49 tfactl blackoutコマンドのパラメータ

パラメータ	説明
add|remove|print|	ブラックアウト条件を追加、削除または出力します。
-targettype type Target type: host|crs|asm|asmdg|database|dbbackup|db_dataguard|db_tablespace|pdb_tablespace|pdb|listener|service|os	ブラックアウトを指定したターゲット・タイプのみに制限します。 host: ノード全体がブラックアウト中です。ホストがブラックアウトの場合、テレメトリJSONでtrueと表示されるすべてのブラックアウト要素にブラックアウトの理由があります。 crs: Oracle ClusterwareリソースまたはOracle Clusterwareログ内のイベントの可用性をブラックアウトします。 asm:このマシン上のOracle Automatic Storage Management (Oracle ASM)の可用性、またはOracle ASMアラート・ログ内のイベントをブラックアウトします。 asmdg: Oracle ASMディスク・グループをブラックアウトします。 database: Oracle Database、Oracle Databaseバックアップ、表領域など、またはOracle Databaseアラート・ログ内のイベントの可用性をブラックアウトします。 dbbackup: Oracle Databaseのバックアップ・イベント(CDBまたはアーカイブ・バックアップなど)をブラックアウトします。 db_dataguard: Oracle Data Guardイベントをブラックアウトします。 db_tablespace: Oracle Database表領域イベント(コンテナ・データベース)をブラックアウトします。 pdb_tablespace: Oracleプラガブル・データベースの表領域イベント(プラガブル・データベース)をブラックアウトします。 pdb: Oracleプラガブル・データベースのイベントをブラックアウトします。 listener: リスナーの可用性をブラックアウトします。 service: サービスの可用性をブラックアウトします。 os: 1つ以上のオペレーティング・システム・レコードをブラックアウトします。
-target all|name	ブラックアウトのターゲットを指定します。ターゲットのカンマ区切りリストを指定できます。 デフォルトでは、ターゲットはallに設定されています。
-container name	ブラックアウトが有効になるデータベース・コンテナ名(db_unique_name)を指定します(PDB、DB_TABLESPACEおよびPDB_TABLESPACEの場合)。
-pdb pdb_name	ブラックアウトが有効になるPDBを指定します(PDB_TABLESPACEの場合のみ)。
-events all|"str1,str2"	ブラックアウトを、自動収集をトリガーしない、またはテレメトリJSONでブラックアウトとしてマークされる可用性イベントまたはイベント文字列のみに制限します。 all: 指定したターゲットのすべてのものをブラックアウトします。 string: 指定した文字列が行のいずれかの部分に含まれているインシデントのブラックアウト。 文字列のカンマ区切りリストを指定します。
-timeout nh|nd|none	タイムアウトまでの時間数または日数でブラックアウトの期間を指定します。デフォルトでは、タイムアウトは24時間(24h)に設定されています。
-c|-local	ブラックアウトをクラスタ全体に設定するか、ローカルに設定するかを指定します。 デフォルトでは、ブラックアウトはlocalに設定されています。
-reason comment	ブラックアウトの説明的な理由を指定します。
-docollection	このオプションを使用して、このターゲットにブラックアウトが設定されている場合でも自動診断収集を実行します。

例9-40 tfactl blackout

• targettype: データベース、target: mydb上のイベント: ORA-00600をブラックアウトするには

  tfactl blackout add -targettype database -target mydb -event "ORA-00600"

• targettype: データベース、target: allのイベント: ORA-04031をブラックアウトするには

  tfactl blackout add -targettype database -target all -event "ORA-04031" -timeout 1h

• targettype: dbbackup、target: mydb上のdb backupイベントをブラックアウトするには

  tfactl blackout add -targettype dbbackup -target mydb

• targettype: db_dataguard、target: mydb上のdb dataguardイベントをブラックアウトするには

  tfactl blackout add -targettype db_dataguard -target mydb -timeout 30m

• targettype: db_tablespace、target: system、container: mydb上のdb tablespaceイベントをブラックアウトするには

  tfactl blackout add -targettype db_tablespace -target system -container mydb -timeout 30m

• targettype: ホスト、target: allのすべてのイベントをブラックアウトするには

  tfactl blackout add -targettype host -event all -target all -timeout 1h -reason "Disabling all events during patching"

• ブラックアウト詳細を出力するには

  tfactl blackout print
  .-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------.
  |                                                                                myhostname                                                                                     |
  +---------------+---------------------+-----------+------------------------------+------------------------------+--------+---------------+--------------------------------------+
  | Target Type   | Target              | Events    | Start Time                   | End Time                     | Status | Do Collection | Reason                               |
  +---------------+---------------------+-----------+------------------------------+------------------------------+--------+---------------+--------------------------------------+
  | HOST          | ALL                 | ALL       | Thu Mar 24 16:48:39 UTC 2022 | Thu Mar 24 17:48:39 UTC 2022 | ACTIVE | false         | Disabling all events during patching |
  | DATABASE      | MYDB                | ORA-00600 | Thu Mar 24 16:39:03 UTC 2022 | Fri Mar 25 16:39:03 UTC 2022 | ACTIVE | false         | NA                                   |
  | DATABASE      | ALL                 | ORA-04031 | Thu Mar 24 16:39:54 UTC 2022 | Thu Mar 24 17:39:54 UTC 2022 | ACTIVE | false         | NA                                   |
  | DB_DATAGUARD  | MYDB                | ALL       | Thu Mar 24 16:41:38 UTC 2022 | Thu Mar 24 17:11:38 UTC 2022 | ACTIVE | false         | NA                                   |
  | DBBACKUP      | MYDB                | ALL       | Thu Mar 24 16:40:47 UTC 2022 | Fri Mar 25 16:40:47 UTC 2022 | ACTIVE | false         | NA                                   |
  | DB_TABLESPACE | SYSTEM_CDBNAME_MYDB | ALL       | Thu Mar 24 16:45:56 UTC 2022 | Thu Mar 24 17:15:56 UTC 2022 | ACTIVE | false         | NA                                   |
  '---------------+---------------------+-----------+------------------------------+------------------------------+--------+---------------+--------------------------------------'

• targettype: データベース、target: mydb上のイベント: ORA-00600のブラックアウトを削除するには

  tfactl blackout remove -targettype database -event "ORA-00600" -target mydb

• targettype: dbbackup、target: mydb上のdb backupイベントのブラックアウトを削除するには

  tfactl blackout remove -targettype dbbackup -target mydb

• targettype: db_tablespace、target: system、container: mydb上のdb tablespaceイベントのブラックアウトを削除するには

  tfactl blackout remove -targettype db_tablespace -target system -container mydb

• targettype: all、target: allのホスト・イベントのブラックアウトを削除するには

  tfactl blackout remove -targettype host -event all -target all