D.3 tfactl diagcollect

Use the tfactl diagcollect command to perform on-demand diagnostic collection.

Oracle Trace File Analyzer Collector can perform three types of on-demand collections:

  • Default collections

  • Event-driven Support Service Request Data Collection (SRDC) collections

  • Custom collections

Syntax

tfactl diagcollect [[component_name1] [component_name2] ... [component_nameN] | [-srdc srdc_profile] | [-defips]]
[-sr SR#] 
[-node all|local|n1,n2,...] 
[-tag tagname] 
[-z filename] 
[-last nh|d | -from time -to time | -for time] 
[-nocopy] 
[-notrim] 
[-silent] 
[-cores]
[-collectalldirs]
[-collectdir dir1,dir2...]
[-examples]
[-upload]
[-id]

Components:-ips|-database|-asm|-crsclient|-dbclient|-dbwlm|-tns|-rhp|-procinfo|-afd|-crs|-cha|-wls|-emagent|-oms|-ocm|-emplugins|-em|-acfs
|-install|-cfgtools|-os|-ashhtml|-ashtext|-awrhtml|-awrtext

Parameters

Prefix each option with a minus sign (-).

Option Description

[[component_name1] [component_name2] ... [component_nameN] | [-srdc srdc_profile] | [-defips]]]

Specify the list of components for which you want to obtain collections, or specify the SRDC name, or specify to include Incident Packaging Service (IPS) Packages for Oracle Automatic Storage Management (Oracle ASM), Oracle Clusterware, and Oracle Databases in the default collection.

[-sr SR#]

Specify the Service Request number to which Oracle Trace File Analyzer automatically uploads all collections.

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

Specify a comma-delimited list of nodes from which to collect diagnostic information. Default is all.

-tag description

Use this parameter to create a subdirectory for the resulting collection in the Oracle Trace File Analyzer repository.

-z file_name

Use this parameter to specify an output file name.

[-last nh|d | -from time -to time | -for time]

  • Specify the -last parameter to collect files that have relevant data for the past specific number of hours (h) or days (d). By default, using the command with this parameter also trims files that are large and shows files only from the specified interval.

    You can also use -since, which has the same functionality as -last. This option is included for backward compatibility.

  • Specify the -from and -to parameters (you must use these two parameters together) to collect files that have relevant data during a specific time interval, and trim data before this time where files are large.

    Supported time formats:

    "Mon/dd/yyyy hh:mm:ss"

    "yyyy-mm-dd hh:mm:ss"

    "yyyy-mm-ddThh:mm:ss"

    "yyyy-mm-dd"

  • Specify the -for parameter to collect files that have relevant data for the time given. The files tfactl collects will have timestamps in between which the time you specify after -for is included. No data trimming is done for this option.

    Supported time formats:

    "Mon/dd/yyyy"

    "yyyy-mm-dd"

Note:

If you specify both date and time, then you must enclose both the values in double quotation marks (""). If you specify only the date or the time, then you do not have to enclose the single value in quotation marks.

-nocopy

Specify this parameter to stop the resultant trace file collection from being copied back to the initiating node. The file remains in the Oracle Trace File Analyzer repository on the executing node.

-notrim

Specify this parameter to stop trimming the files collected.

-silent

Specify this parameter to run diagnostic collection as a background process

-cores

Specify this parameter to collect core files when it would normally have not been collected.

-collectalldirs

Specify this parameter to collect all files from a directory that has Collect All  flag marked true.

-collectdir dir1,dir2,...dirn

Specify a comma-delimited list of directories and collection includes all files from these directories irrespective of type and time constraints in addition to the components specified.

-examples

Specify this parameter to view diagcollect usage examples.

-upload

-id

tfactl diagcollect args -upload config_name -id identifier

Generates diagnostic collection and uploads to the specified end point name or config name to the location identifier.

Optionally, you can specify the identifier. If you are uploading to My Oracle Support, then specify the SR number.

tfactl diagcollect -since 1h -upload config_name -id identifier

For example: $ tfactl diagcollect -since 1h -upload mos -id 3-123456789