Files

该功能默认关闭

2025-12-17 14:09:02 +08:00

2.5 KiB

Raw Blame History

慢查询监控快速参考

🚀 快速启用

方法 1：修改配置（推荐）

# config/bot_config.toml
[database]
enable_slow_query_logging = true  # 改为 true 启用
slow_query_threshold = 0.5        # 选项：阈值（秒）

方法 2：代码启用

from src.common.database.utils import enable_slow_query_monitoring

enable_slow_query_monitoring()  # 启用

# ... 你的代码 ...

disable_slow_query_monitoring()  # 禁用

方法 3：检查状态

from src.common.database.utils import is_slow_query_monitoring_enabled

if is_slow_query_monitoring_enabled():
    print("✅ 已启用")
else:
    print("❌ 已禁用")

📊 关键命令

# 启用/禁用
from src.common.database.utils import (
    enable_slow_query_monitoring,
    disable_slow_query_monitoring,
    is_slow_query_monitoring_enabled
)

enable_slow_query_monitoring()
disable_slow_query_monitoring()
is_slow_query_monitoring_enabled()

# 获取数据
from src.common.database.utils import (
    get_slow_queries,
    get_slow_query_report
)

queries = get_slow_queries(limit=20)
report = get_slow_query_report()

# 生成报告
from src.common.database.utils.slow_query_analyzer import SlowQueryAnalyzer

SlowQueryAnalyzer.generate_html_report("report.html")
text = SlowQueryAnalyzer.generate_text_report()

⚙️ 推荐配置

# 生产环境（默认）
enable_slow_query_logging = false

# 测试环境
enable_slow_query_logging = true
slow_query_threshold = 0.5

# 开发环境
enable_slow_query_logging = true
slow_query_threshold = 0.1

💡 使用示例

# 1. 启用监控
enable_slow_query_monitoring()

# 2. 自动监控函数
@measure_time()
async def slow_operation():
    return await db.query(...)

# 3. 查看报告
report = get_slow_query_report()
print(f"总慢查询数: {report['total']}")

# 4. 禁用监控
disable_slow_query_monitoring()

📈 性能

状态	CPU 开销	内存占用
启用	< 0.1%	~50 KB
禁用	~0%	0 KB

🎯 核心要点

✅ 默认关闭 - 无性能开销
✅ 按需启用 - 方便的启用/禁用
✅ 实时告警 - 超过阈值时输出
✅ 详细报告 - 关闭时输出分析
✅ 零成本 - 禁用时完全无开销

启用: enable_slow_query_monitoring()
禁用: disable_slow_query_monitoring()
查看: get_slow_query_report()

更多信息: docs/slow_query_monitoring_guide.md

2.5 KiB Raw Blame History Unescape Escape