Manage directories configured in Oracle Trace File Analyzer and diagnostic collections.
8.4.1 Including Directories
Add directories to the Oracle Trace File Analyzer configuration to include the directories in diagnostic collections.
Oracle Trace File Analyzer then stores diagnostic collection metadata about the:
Files in the directory and all sub directories
All Oracle Trace File Analyzer users can add directories they have read access to.
To manage directories:
- To view the current directories configured in Oracle Trace File Analyzer
tfactl print directories [ -node all | local | n1,n2,... ] [ -comp component_name1,component_name2,.. ] [ -policy exclusions | noexclusions ] [ -permission public | private ]
- To add directories:
tfactl directory add dir [ -public ] [ -exclusions | -noexclusions | -collectall ] [ -node all | n1,n2,... ]
- To remove a directory from being collected:
tfactl directory remove dir [ -node all | n1,n2,... ]
8.4.2 Managing the Size of Collections
Use the Oracle Trace File Analyzer configuration options
-cores to include core files.
To manage the size of collections:
- To trim files during diagnostic collection:
tfactl set trimfiles=ON|OFF
When set to ON (default), Oracle Trace File Analyzer trims files to include data around the time of the event
When set to OFF, any file that was written to at the time of the event is collected in its entirety
- To set the maximum size of core file to n MB
(default 50 MB):
tfactl set maxcorefilesize=n
Oracle Trace File Analyzer skips core files that are greater than
- To set the maximum collection size of core files to n MB (default 500 MB):
tfactl set maxcorecollectionsize=n
Oracle Trace File Analyzer skips collecting core files after
- To collect core files with diagnostic collections:
tfactl diagcollect -cores
8.4.3 Temporarily Restrict Automatic Diagnostic Collections for Specific Events
tfactl blackout command to suppress automatic diagnostic collections.
If you set blackout for a target, then Oracle Trace File Analyzer stops automatic diagnostic collections if it finds events in the alert logs for that target while scanning.
You can also restrict automatic diagnostic collection at a granular level, for example, only for
ORA-00600 or even only
ORA-00600 with specific arguments.
tfactl blackout add -targettype database -target mydb -event "ORA-00600"
Event "ORA-00600" is blacked out until Wed Feb 20 00:20:34 PST 2019 on targettype : database, target : mydb
- Blackout the database you are about to create
- Create the database
- Remove the blackout