@@@@Platform-“OnPrem”

@@@@Product-“Database”

@@@@ReleaseVersion-“26.11”

@@@@info-map-label-“Automatic TFA Self-Diagnostics on diagcollect Failure for Faster Issue Resolution”

Automatic TFA Self-Diagnostics on diagcollect Failure for Faster Issue Resolution

Autonomous Health Framework (AHF) introduces an enhancement to Trace File Analyzer (TFA) that improves troubleshooting efficiency when diagnostic collections fail.

With this feature, whenever the tfactl diagcollect command fails, TFA automatically triggers self-diagnostics using the tfactl diagnosetfa command. This ensures that relevant diagnostic data is immediately available for faster issue resolution.

During diagnostic data collection using tfactl diagcollect, failures can occasionally occur, preventing the successful gathering of logs required by Oracle Support. In such scenarios, users often lack clear guidance on next steps, resulting in delays and prolonged resolution times.

This enhancement eliminates that gap by introducing an automatic fallback mechanism that:

Note:

Key Benefits

Behavior and Workflow

When

tfactl diagcollect

fails, TFA automatically performs the following actions:

  1. Detects the failure condition
  2. Executes:

tfactl diagnosetfa -local -profile collection 3. Collects TFA/AHF self-diagnostics from the local node 4. Displays a message that includes:

- Confirmation of the failure
- Location of the generated diagnostic bundle
- Recommended next steps

The generated diagnostic file follows this format: hostname_ahf_autodiagnostic.zip

When Is Automatic Diagnostics Triggered?

The fallback mechanism is triggered when diagcollect fails due to conditions such as:

Usage Instructions

Run Diagnostic Collection

tfactl diagcollect -since 2h or tfactl diagcollect -from "2026-01-20 10:00" -to "2026-01-20 12:00"

Expected Behavior

Special Cases

Remote Node Failures

If diagcollect succeeds on the local node but fails on one or more remote nodes:

Non-Root Execution

If diagcollect is run as a non-root user and fails:

Next Steps

  1. Review the generated diagnosetfa bundle
  2. Upload the file to your Service Request (SR) in My Oracle Support
  3. Coordinate with Oracle Support for:
    • Root cause analysis of the failure
    • Guidance on collecting issue-specific diagnostics