Managing the Index

Oracle Trace File Analyzer (TFA) uses Lucene indexes to store diagnostic and telemetry data for efficient querying and analysis.

Trace File Metadata Indexing

Beginning with AHF 25.2, Lucene-based indexing of trace file metadata is disabled by default to reduce system resource consumption.

If you use AHF Database Administrator (DBA) tools and require improved query performance, you can enable trace file metadata indexing. For more information, refer to the DBA Tools documentation.

Telemetry Data Index

Telemetry data is stored in a Lucene index. In the event of index corruption, the default behavior is to drop and recreate the index. This action may result in the loss of some telemetry data.

To avoid potential data loss, you can configure TFA to use an alternative recovery mode that preserves and restores index data.

Configuring Index Recovery Mode

Use the tfactl setindexRecoveryMode command to specify how TFA handles index corruption.

Recreate Mode (Default)

In this mode, TFA drops and recreates the index when corruption is detected. This approach minimizes recovery time but may result in the loss of telemetry data.

tfactl setindexRecoveryMode=recreate

Restore Mode

In this mode, TFA performs the following actions:

• Creates a backup of the index
• Maintains redo data
• Restores the index during recovery

This approach helps preserve telemetry data but may increase recovery time and resource usage.

tfactl setindexRecoveryMode=restore

Usage Considerations

• Use recreate mode in environments where rapid recovery is prioritized and limited data loss is acceptable.
• Use restore mode in production environments or where telemetry data retention is critical.