4.5.1 Running On-Demand Default Collections

Use the tfactl diagcollect command to request a collection.

Oracle Trace File Analyzer stores all collections in the repository directory of the Oracle Trace File Analyzer installation.

The standard time period used for the default collections is the past 12 hours. However, you can adjust to any other time period.

To run on-demand default collections:

1. To request default collection:

   tfactl diagcollect

   For example:

   $ tfactl diagcollect
   
   Collecting data for the last 12 hours for all components...
   Collecting data for all nodes
   
   Collection Id : 20160616115923myserver69
   
   Detailed Logging at : 
   /u01/app/tfa/repository/collection_Thu_Jun_16_11_59_23_PDT_2016_node_all/diagcollect_20160616115923_myserver69.log
   2016/06/16 11:59:27 PDT : Collection Name : 
   tfa_Thu_Jun_16_11_59_23_PDT_2016.zip
   2016/06/16 11:59:28 PDT : Collecting diagnostics from hosts : 
   [myserver70, myserver71, myserver69]
   2016/06/16 11:59:28 PDT : Scanning of files for Collection in progress...
   2016/06/16 11:59:28 PDT : Collecting additional diagnostic information...
   2016/06/16 11:59:33 PDT : Getting list of files satisfying time range
   [06/15/2016 23:59:27 PDT, 06/16/2016 11:59:33 PDT]
   2016/06/16 11:59:37 PDT : Collecting ADR incident files...
   2016/06/16 12:00:32 PDT : Completed collection of additional diagnostic information...
   2016/06/16 12:00:39 PDT : Completed Local Collection
   2016/06/16 12:00:40 PDT : Remote Collection in Progress...
   .--------------------------------------.
   |          Collection Summary          |
   +------------+-----------+------+------+
   | Host       | Status    | Size | Time |
   +------------+-----------+------+------+
   | myserver71 | Completed | 15MB |  64s |
   | myserver70 | Completed | 14MB |  67s |
   | myserver69 | Completed | 14MB |  71s |
   '------------+-----------+------+------'
   
   Logs are being collected to: 
   /u01/app/tfa/repository/collection_Thu_Jun_16_11_59_23_PDT_2016_node_all
   /u01/app/tfa/repository/collection_Thu_Jun_16_11_59_23_PDT_2016_node_all/myserver71.tfa_Thu_Jun_16_11_59_23_PDT_2016.zip
   /u01/app/tfa/repository/collection_Thu_Jun_16_11_59_23_PDT_2016_node_all/myserver69.tfa_Thu_Jun_16_11_59_23_PDT_2016.zip
   /u01/app/tfa/repository/collection_Thu_Jun_16_11_59_23_PDT_2016_node_all/myserver70.tfa_Thu_Jun_16_11_59_23_PDT_2016.zip
   

Topics:

• Adjusting the Time Period for a Collection
  By default, diagcollect trims and collects all important log files, from all nodes, for all components, where the file has been updated in the past 12 hours.

4.5.1.1 Adjusting the Time Period for a Collection

By default, diagcollect trims and collects all important log files, from all nodes, for all components, where the file has been updated in the past 12 hours.

Narrow down the problem further and collect the minimal possible data.

There are four different ways of specifying a time period for the collection.

Use whichever is most appropriate in your situation based on what you know about when the symptoms of the problem occurred and any anything relevant that might have contributed to it.

Table 4-2 Adjusting the Time Period for a Collection

Command	Description
-since nh|d	Collect since the previous n hours or days.
-from “yyyy-mm-dd”	Collect from the date and optionally time specified. Valid date / time formats: "Mon/dd/yyyy hh:mm:ss" "yyyy-mm-dd hh:mm:ss" "yyyy-mm-ddThh:mm:ss" "yyyy-mm-dd"
-to “yyyy-mm-dd”	Collect to the date and optionally time specified. Valid date / time formats: "Mon/dd/yyyy hh:mm:ss" "yyyy-mm-dd hh:mm:ss" "yyyy-mm-ddThh:mm:ss" "yyyy-mm-dd"
-for “yyyy-mm-dd”	Collect for the specified date. Valid date / time formats: "Mon/dd/yyyy" "yyyy-mm-dd"

To adjust the time period for a collection:

1. To adjust the time period:

   tfactl diagcollect –since nh|d

   For example:

   To do a collection covering the past 2 hours:

   $ tfactl diagcollect –since 2h

   To do a collection covering the past 3 days:

   $ tfactl diagcollect –since 3d

   To do a collection for a specific date:

   $ tfactl diagcollect -for "2016-08-15"

   To do a collection from one particular date to another:

   $ tfactl diagcollect -from "2016-08-15" -to "2016-08-17"