安德鲁·阿特金森：在Ruby on Rails中使用Marginalia和查询日志记录数据库查询的源代码行号
内容提要
文章讨论了如何在Ruby on Rails中利用pg_stat_statements记录数据库查询信息，特别是通过Marginalia和Rails 7.1及以上版本的功能实现源代码行级别的日志记录。这种方式帮助后端工程师识别和优化性能较差的查询，未来还将改进以减少重复条目。
关键要点
-
文章讨论了如何在Ruby on Rails中利用pg_stat_statements记录数据库查询信息。
-
使用Marginalia Ruby gem创建应用程序上下文注释，包含源代码文件和行号。
-
Rails 7.1及以上版本直接在框架中增加了类似Marginalia的功能。
-
Rails 7.2.0和8.0.2版本中增加了源位置选项，等同于Marginalia的:line选项。
-
建议在本地开发环境中启用行级日志记录，以减少生产环境的开销。
-
行级日志记录对于后端工程师调试数据库性能问题至关重要。
-
pg_stat_statements存在重复条目的问题，未来将有改进措施来解决这一问题。
延伸解读
Marginalia与Rails内置功能的比较
Marginalia是一个Ruby gem，用于在Rails应用中添加源代码行号的注释。Rails 7.1及以上版本引入了类似的内置功能，虽然最初缺乏行级日志记录能力，但在7.2.0和8.0.2版本中增加了源位置选项。这使得开发者可以选择使用内置功能或Marginalia，根据项目需求灵活调整。
行级日志记录的开发环境建议
文章建议在本地开发环境中启用行级日志记录，以避免在生产环境中增加额外开销。通过环境变量控制日志记录的启用，可以有效管理性能影响，确保在开发阶段获取详细的查询信息，帮助后端工程师优化数据库性能。
pg_stat_statements的局限性
尽管pg_stat_statements在记录数据库查询方面非常有用，但其存在重复条目的问题，可能导致数据分析的复杂性增加。未来的改进将致力于解决这一问题，开发者应关注Postgres的更新，以便更好地利用这一工具。
延伸问答
如何在Ruby on Rails中记录数据库查询的源代码行号？
可以使用Marginalia Ruby gem或Rails 7.1及以上版本的内置功能来记录源代码行号。
pg_stat_statements在数据库查询日志中有什么作用？
pg_stat_statements用于记录数据库查询信息，帮助识别性能较差的查询。
Rails 7.2.0和8.0.2版本新增了什么功能？
这两个版本增加了源位置选项，等同于Marginalia的:line选项，支持行级日志记录。
为什么建议在本地开发环境中启用行级日志记录？
在本地开发环境中启用行级日志记录可以减少生产环境的开销。
Marginalia和Rails内置功能有什么区别？
Marginalia是一个Ruby gem，提供行号记录，而Rails内置功能在7.1版本后直接集成，但最初没有行号记录能力。
pg_stat_statements存在什么问题？
pg_stat_statements存在重复条目的问题，未来将有改进措施来解决这一问题。
