ReaderMX.
PostgreSQL码农集散地

PostgreSQL 18 preview - 新增GUC参数:log_lock_failure 记录获取锁错误详细日志

Pdigoal约 4 分钟

PostgreSQL 18 preview - 新增GUC参数:log_lock_failure 记录获取锁错误详细日志

在 PostgreSQL 中，当尝试获取锁时，可能会因为锁冲突或其他原因失败。例如，SELECT ... NOWAIT 会在锁不可用时立即失败，而不是等待。

锁获取失败的原因可能涉及多个进程的锁持有或等待情况，诊断这些问题通常需要详细的日志信息。

目前，PostgreSQL 在锁获取失败时不会记录详细的日志信息，这增加了诊断和调试的难度。

这个 Patch 的主要目的是引入一个新的 GUC（Grand Unified Configuration）选项 log_lock_failure，用于控制当锁获取失败时是否生成详细的日志消息。

https://git.postgresql.org/gitweb/?p=postgresql.git;a=commit;h=6d376c3b0d1e79c318d2a1c04097025784e28377

Add GUC option to log lock acquisition failures.  
author Fujii Masao <[email protected]>   
Fri, 14 Mar 2025 14:14:12 +0000 (23:14 +0900)  
committer Fujii Masao <[email protected]>   
Fri, 14 Mar 2025 14:14:12 +0000 (23:14 +0900)  
commit 6d376c3b0d1e79c318d2a1c04097025784e28377  
tree d1ed6941bfa91892223567b1aa2659a31abc660f tree  
parent e80171d57c25caf4362a7de17e96195f905386ea commit | diff  
Add GUC option to log lock acquisition failures.  

This commit introduces a new GUC, log_lock_failure, which controls whether  
a detailed log message is produced when a lock acquisition fails. Currently,  
it only supports logging lock failures caused by SELECT ... NOWAIT.  

The log message includes information about all processes holding or  
waiting for the lock that couldn't be acquired, helping users analyze and  
diagnose the causes of lock failures.  

Currently, this option does not log failures from SELECT ... SKIP LOCKED,  
as that could generate excessive log messages if many locks are skipped,  
causing unnecessary noise.  

This mechanism can be extended in the future to support for logging  
lock failures from other commands, such as LOCK TABLE ... NOWAIT.  

Author: Yuki Seino <[email protected]>  
Co-authored-by: Fujii Masao <[email protected]>  
Reviewed-by: Jelte Fennema-Nio <[email protected]>  
Discussion: https://postgr.es/m/[email protected]  

AI 解读 Patch: 添加 GUC 选项以记录锁获取失败

这个 Patch 的主要目的是引入一个新的 GUC（Grand Unified Configuration）选项 log_lock_failure，用于控制当锁获取失败时是否生成详细的日志消息。以下是详细的解读和扩展思考。

1. 背景

  • 锁获取失败: 在 PostgreSQL 中，当尝试获取锁时，可能会因为锁冲突或其他原因失败。例如，SELECT ... NOWAIT 会在锁不可用时立即失败，而不是等待。
  • 诊断困难: 锁获取失败的原因可能涉及多个进程的锁持有或等待情况，诊断这些问题通常需要详细的日志信息。
  • 现有问题: 目前，PostgreSQL 在锁获取失败时不会记录详细的日志信息，这增加了诊断和调试的难度。

2. Patch 的改进

Patch 引入了以下改进：

(1) 新增 GUC 选项 log_lock_failure
  • 功能: 控制是否在锁获取失败时生成详细的日志消息。
  • 默认值: 默认情况下，该选项为 off，即不记录锁获取失败的日志。
  • 适用场景: 目前仅支持 SELECT ... NOWAIT 的锁获取失败日志。
(2) 日志内容
  • 详细信息: 日志消息包括所有持有或等待该锁的进程信息，帮助用户分析和诊断锁失败的原因。
  • 示例日志:
    LOG:  could not acquire lock on relation "test_table" (OID 12345)  
    DETAIL:  Processes holding the lock: pid=5678, mode=AccessExclusiveLock  
             Processes waiting for the lock: pid=91011, mode=AccessShareLock  
(3) 排除 SELECT ... SKIP LOCKED
  • 原因: SELECT ... SKIP LOCKED 可能会跳过大量锁，如果记录这些失败，可能会生成过多的日志消息，导致不必要的噪音。
  • 设计考虑: 避免日志过载，保持日志的实用性和可读性。
(4) 未来扩展
  • 支持更多命令: 该机制可以扩展到支持其他命令的锁获取失败日志，例如 LOCK TABLE ... NOWAIT。
  • 灵活性: 通过 GUC 选项，用户可以根据需要启用或禁用日志记录。

3. 代码示例

以下是 Patch 的核心代码片段：

/* GUC 选项定义 */
staticbool log_lock_failure = false;  

/* 在锁获取失败时记录日志 */
if (log_lock_failure && lock_failed) {  
    elog(LOG, "could not acquire lock on relation \"%s\" (OID %u)",  
         RelationGetRelationName(relation), RelationGetRelid(relation));  
    log_lock_details(lock);  
}  

4. 扩展思考: 适用场景

log_lock_failure 选项在以下场景中非常有用：

  1. 高并发环境: 当多个进程频繁竞争锁时，锁获取失败的情况可能较多，启用日志可以帮助快速定位问题。
  2. 调试和诊断: 当锁获取失败导致查询失败时，详细的日志信息可以帮助开发者和 DBA 分析原因。
  3. 性能优化: 通过分析锁获取失败的日志，可以优化锁的使用策略，减少锁冲突。

5. 总结

这个 Patch 通过以下方式改进了 PostgreSQL 的锁管理：

  1. 引入了 log_lock_failure GUC 选项，支持记录锁获取失败的详细日志。
  2. 日志内容包括所有持有或等待锁的进程信息，便于诊断和分析。
  3. 排除了 SELECT ... SKIP LOCKED 的日志记录，避免日志过载。

这些改进为高并发环境下的锁问题诊断提供了有力工具，同时保持了日志的实用性和可读性。对于开发者和 DBA 来说，这意味着更高效的调试和性能优化能力。

KEEP THE THREAD GOING

更多来源文章