作者：Digital Observer（施嘉伟） Oracle ACE Pro: Database PostgreSQL ACE Partner 11年数据库行业经验，现主要从事数据库服务工作 拥有Oracle OCM、DB2 10.1 Fundamentals、MySQL 8.0 OCP、WebLogic 12c OCA、KCP、PCTP、PCSD、 PGCM、OCI、PolarDB技术专家、达梦师资认证、数据安全咨询高级等认证 ITPUB认证专家、PolarDB开源社区技术顾问、HaloDB技术顾问、TiDB社区技术布道师、青学会MOP技术社区专家顾问、国内某高校企业实践指导教师 公众号：Digital Observer；CSDN：施嘉伟；ITPUB：sjw1933；墨天轮：Digital Observer；PGFans：施嘉伟。
一、工具简介
TFA全称：Trace File Analyzer，是Oracle官方提供的一款日志分析与收集工具，常用于RAC集群环境中快速定位故障并统一汇总日志。
功能特点：
工作流程：
1. DBA发出 diagcollect 命令启动日志收集； 2. 本地TFA向其他节点发送收集请求； 3. 各节点开始并行收集各自的诊断信息； 4. 所有日志文件归档至发起命令的“master”节点； 5. DBA提取日志压缩包，用于人工分析或提交SR。
二、安装、启动与关闭
1. 环境变量配置
必须配置root用户的
ORACLE_HOME 环境变量，否则会报错：
ERROR: ORACLE_HOME is not set
建议修改
.bash_profile 文件如下：
# ~/.bash_profileif [ -f ~/.bashrc ]; then . ~/.bashrcfiPATH=$PATH:$HOME/binexport PATHexport ORACLE_HOME=/oracle/app/product/193000/db_1
2. 安装TFA
进入TFA安装目录并执行安装脚本：
cd /oracle/app/product/193000/db_1/suptools/tfa/release/tfa_home/install/ ./roottfa.sh
安装提示：
Do you want to setup Oracle Trace File Analyzer (TFA) now ? yes|[no] : yes Installing Oracle Trace File Analyzer (TFA). ... Finished installing Oracle Trace File Analyzer (TFA)
安装完成后会输出日志路径，如
/oracle/app/product/193000/db_1/install/root_rac19cn1_xxx.log
3. 启动与关闭
启动：
cd $TFA_HOME/bin ./tfactl tfactl> start
输出示例：
Starting TFA.. ... TFA Started and listening for commands
关闭：
tfactl> stop
三、日志收集示例与用法
1. 收集数据库相关日志（默认收集近12小时）
tfactl> diagcollect -database ora19c
系统提示是否输入具体时间范围，按回车默认收集12小时内的日志。
2. 收集特定日期的全部Trace日志
tfactl> diagcollect -for Nov/2/2020
可用于指定日期的大范围日志收集。
3. 收集特定日期的数据库trace日志
tfactl> diagcollect -database ora19c -for Nov/2/2020
4. 收集特定日期的集群日志（CRS）
tfactl> diagcollect -crs -for Nov/2/2020
5. 收集指定时间范围的数据库日志
tfactl> diagcollect -database ora19c -from "2020-11-02 18:00:00" -to "2020-11-03 08:00:00"
四、收集结果查看与后续处理
日志保存路径：
收集结果会保存在类似以下路径：
/oracle/gridbase/tfa/repository/collection_<时间>_node_all/
压缩包示例：
rac19cn1.tfa_Tue_Nov_03_09_21_07_CST_2020.zip rac19cn2.tfa_Tue_Nov_03_09_21_07_CST_2020.zip
查看收集日志：
详细操作过程日志可查看：
diagcollect_<ID>_rac19cn1.log
五、常见问题与建议
| 问题 | 解决方案 |
|---|---|
ERROR: ORACLE_HOME is not set |
确保root用户配置了正确的环境变量 |
| TFA版本过旧提示 | 下载并更新到最新版本（参考Oracle MOS） |
| 收集内容过大 | 通过
-from/-to 或
|
| 日志无法归档 | 检查目标节点的网络连通性与磁盘权限 |
六、总结
TFA作为Oracle RAC环境下的重要诊断工具，大大提升了故障分析的效率。合理使用
diagcollect命令，不仅可以为DBA提供精准的日志支持，也能为Oracle SR快速提供所需信息。
建议将TFA作为RAC部署后的必配工具之一，定期检查版本并演练日志收集流程，以应对突发故障。
如需进一步了解TFA的高级功能（如事件触发、自定义模块等），请参考 Oracle 官方文档或 MOS 文章：
