故障诊断架构由多个组件构成，包括自动诊断存储库、运行日志、告警日志等，其中运行日志、告警日志请参考日志管理中相关说明。

自动诊断存储库

自动诊断存储库是基于文件的存储库，用于存储数据库的诊断数据，其目录结构如下：

子目录名称	用途与说明
hm	存放健康检查的报告
metadata	存放自动诊断存储库的元数据文件（主要包括incident、problem等）
blackbox	存放自动捕获诊断数据（“黑匣子”）的数据，该目录无需手动创建，在数据库进程宕机前将自动创建该路径及文件
trace	存放后台自动生成的trace日志、dump的数据、追踪事件的输出结果

自动诊断存储库默认位于$YASDB_DATA目录下，可通过DIAGNOSTIC_DEST参数进行调整。

Note：

目录位置更新后，如需保留并沿用历史数据文件需手动拷贝其子目录及文件至新路径，否则数据库将自动创建新的子目录和相关文件。

YashanDB的自动诊断存储库功能默认开启，如需关闭该功能可以配置参数DIAG_ADR_ENABLED并重新启动数据库生效。关闭后，不会再触发自动巡检，包括文件监控、反应式健康检查以及最大保护模式下的同步备库监控。

ALTER SYSTEM SET DIAG_ADR_ENABLED = FALSE SCOPE = SPFILE;

trace文件

除了后台自动生成的trace日志外，执行dump、追踪事件的输出结果也将以trace文件的形式保存。

YashanDB支持从以下维度管控trace文件的最大容量，避免造成不必要的存储空间浪费或性能损耗。

• 单个trace文件大小：由MAX_TRACE_FILE_SIZE参数指定。

  ALTER SESSION SET MAX_TRACE_FILE_SIZE = '10M';
  

• trace目录总容量大小：由MAX_TRACE_DIR_SIZE参数指定，在目录下文件总大小超过阈值时会自动清理早期文件，请勿将其他文件路径配置到与trace相同的路径下。

  ALTER SESSION SET MAX_TRACE_DIR_SIZE = '100M';