TRACE日志

Trace日志用于记录数据库发生故障时，相关会话的追踪信息，目前仅用于记录会话死锁或锁超时的信息。

• 日志目录

  CN上默认目录为：/gaussdb/data/data_cn/trc/zengine_00003_xxxx.trc，其中/gaussdb/data/data_cn是CN的数据目录。

  DN上默认目录为：/gaussdb/data/data_dn/trc/zengine_00003_xxxx.trc，其中/gaussdb/data/data_dn是DN的数据目录。

  其中，00003是表示某一个会话的ID，目前死锁日志在SESSION_ID为3的会话中进行打印；后面的数字是进程号，数据库重新启动后，会重新生成一个Trace日志。

• 日志格式

  例如：

  CN上的Trace日志：

  *** 2019-03-20 11:38:11 ***                                                                                
  *** ACTION NAME:(DML) ***                                                                                  
  *** MODULE NAME:(ZSQL) ***
  *** SERVICE NAME:(GaussDB) ***                                                                             
  *** SESSION ID:(44) ***                                                                                    
  LOCK TIMEOUT DETECTED (GS-00717)                                                                              
  
  Locking timed out while the operation was waiting.
  
  The following deadlock is not an GaussDB error. It is a
  deadlock on DATANODE due to user error in the design of
  an application or from issuing incorrect ad-hoc SQL.
  The following information may aid in determining the deadlock:
  
  ----- Information for CURRENT COORDINATOR sessions -----                                                   
  Session:
    sid:65 ser:943 pid:94179 user:2/omm
    O/S info: user:os_user, machine:[87368]/opt/gaussdb/app/zsql 
    application name:ZSQL
  ----- End of information for CURRENT COORDINATOR sessions -----
  
  ----- Information for DATANODEs which occur DEADLOCK DETECTED or LOCK TIMEOUT -----                        
  Information on DN(id:2) sessions:                                                                          
  lock timeout while waiting for transaction  
  Session:sid = 50 user = omm curr_schema = omm 
  current SQL:"update t1 set b=2 where a=1"                                                                  
  End of information on DN(id:2) sessions.
  ----- End of information for DATANODEs which occur DEADLOCK DETECTED or LOCK TIMEOUT -----

  • 事件发生的时间
  • 事件发生的操作类型
  • 事件类型：锁超时或死锁
  • 事件发生的CN信息
  • 事件发生的DN信息：
    • DN的NODE ID
    • 事件发生时该DN执行的SQL语句

  DN上的Trace日志：

  **2019-03-17 11:37:32 DEADLOCK DETECTED*
  The following deadlock is not a GaussDB error.It is due to user error in the design of SQL.The following information may aid in determining the deadlock :
  ----------------------WAIT INFORMATION---------------------
  [Transaction Deadlock]
  session id: 54, wait session: 53, wait rowid: 0-0-9624
  wait sql: update d1 set c2 = 'w' where c1 = 1
  
  session id: 53, wait session: 54, wait rowid: 0-0-9632
  wait sql: update d2 set c2 = 'w' where c1 = 1
  
  -----------------END OF WAIT INFORMATION-----------------

  以上记录的就是发生死锁，记录的Trace日志。如果wait_sql为空，说明当前会话正在进行DDL，目前暂时无法记录正在进行DDL的死锁。Trace日志包括以下信息：

  • 死锁的发生时间
  • 死锁的类型
  • 死锁环中各个会话ID
  • 死锁环中各个会话等待ID
  • 死锁环中导致死锁的各个SQL语句
  • 针对不同的死锁，记录了导致死锁的原因：
    • 事务死锁：导致死锁的行，可由row_id查看。
    • 表锁死锁：导致死锁的表，可由table_id查看。
    • ITL死锁：导致死锁的页面，可由page_id查看。