9.3.1.15 tfactl insight

Use the tfactl insight command to generate AHF Insights report from across nodes in the AHF cluster.

AHF 23.8

Starting in AHF 23.8, you will be able to upload to pre-authenticated (PAR) URL. Uploading AHF Insights reports helps Oracle Cloud Operations to identify, investigate, track, and resolve system health issues and divergences in best practice configurations quickly and effectively.

Oracle Exadata Database Service on Dedicated Infrastructure (ExaDB-D) and Oracle Base Database Service

To upload AHF Insights report to PAR location, run:
tfactl diagcollect -insights -last 1h -par <par_url>
tfactl insight -last 1h -par <par_url>

Syntax

tfactl insight 
[-h] 
[-node NODE] 
[-last LAST | -for FOR | -from [FROM]] 
[-to [TO]] 
[-refresh] 
[-keepinput] 
[-par PAR] 
[-request_from REQUEST_FROM] 
[-onlyinsightsupload] 
[-status]

Parameters

Prefix each option with a minus sign (-).

Option Description

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

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

[-last <n><m|h|d>| | -from time -to time | -for time]
  • Specify the -last parameter to collect files that have relevant data for the past specific number of minutes (m), 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.
  • 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"

    date

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.

-refresh

Provide fresh data from AHF Insight sources.

-keepinput

Specifies not to remove the input_collection directory.

-par PAR

Uploads collection to a pre-authenticated URL.

-request_from REQUEST_FROM

Specifies the requestor of the collection.

-onlyinsightsupload

Specifies only to upload insights zip to Object Store or a pre-authenticated URL.

-status

Checks the status of AHF Insights.

Parent topic: Running Oracle Trace File Analyzer Administration Commands