Rails纯API项目中用Ahoy gem存储请求响应日志的最佳实践

我想把所有日志存储到数据库中，所以在Rails纯API项目里配置Ahoy gem。Ahoy是个很棒的gem，但它的GitHub README里没相关最佳实践。我想用Ahoy存储HTTP请求头、响应头和响应体，以下是我在ApplicationController中写的跟踪事件的track_action代码：

class ApplicationController < ActionController::Base
  after_action :track_action

  protected

  def track_action
     ahoy.track "Viewed #{controller_name}##{action_name}", { request: { header: request.headers },
                                                              response: { headers: response.headers, body: JSON.parse(response.body) } }

  end
end

但遇到了如下错误：

Completed 500 Internal Server Error in 493ms (Views: 34.8ms | ActiveRecord: 89.1ms | Allocations: 317174)


  
SystemStackError (stack level too deep):
  
app/controllers/application_controller.rb:14:in `track_action'

请问用ahoy.track存储所有请求、响应日志的最佳实践是什么？

1. 先解决栈溢出问题 #

你遇到的stack level too deep是因为Ahoy自身的数据库写入请求也会触发你的after_action钩子，导致无限循环调用track_action，最终撑爆调用栈。解决方法是在跟踪逻辑开头排除Ahoy内部请求：

def track_action
  # 跳过Ahoy自身的控制器请求，避免循环
  return if controller_name.start_with?("ahoy/")
  
  # 后续跟踪逻辑...
end

2. 安全处理响应体 #

直接解析response.body存在风险：比如响应不是JSON格式、或者响应已被发送后无法读取。建议添加判断和异常处理：

response_body = if response.content_type&.include?("application/json") && response.body.present?
                  begin
                    JSON.parse(response.body)
                  rescue JSON::ParserError
                    # 解析失败时存储部分内容，避免报错中断请求
                    response.body.slice(0, 500) + "... (truncated due to parse error)"
                  end
                else
                  "Non-JSON response"
                end

3. 精简存储的头信息 #

request.headers和response.headers包含大量冗余字段（如服务器内部头、Cookie等），只存储业务需要的字段能减少数据库压力：

# 只保留需要的请求头
request_headers = request.headers.slice("HTTP_USER_AGENT", "HTTP_AUTHORIZATION", "X_REQUEST_ID")
# 只保留需要的响应头
response_headers = response.headers.slice("CONTENT_TYPE", "X_REQUEST_ID")

4. 利用Ahoy内置自动采集 #

Ahoy默认会自动收集访问者IP、用户代理、请求路径等信息，无需手动重复采集。可以在config/initializers/ahoy.rb中针对API项目优化配置：

Ahoy.api = true # 适配纯API场景，禁用浏览器相关跟踪逻辑
Ahoy.geocode = false # 不需要地理信息时关闭，提升性能
Ahoy.track_visits_immediately = true # API场景下立即创建访问记录

5. 异步处理跟踪事件 #

如果日志量较大，建议把跟踪逻辑放到异步任务中执行，避免阻塞主请求响应：

def track_action
  return if controller_name.start_with?("ahoy/")
  
  # 提取需要的跟踪数据，传递给异步任务
  tracking_data = {
    controller: controller_name,
    action: action_name,
    request_headers: request.headers.slice("HTTP_USER_AGENT", "X_REQUEST_ID"),
    response_headers: response.headers.slice("CONTENT_TYPE", "X_REQUEST_ID"),
    response_body: response_body
  }
  
  AhoyTrackingJob.perform_later(current_user, tracking_data)
end

# 异步任务示例（需提前配置Sidekiq等异步框架）
class AhoyTrackingJob < ApplicationJob
  queue_as :default

  def perform(user, tracking_data)
    ahoy = Ahoy::Tracker.new(user: user)
    ahoy.track "Viewed #{tracking_data[:controller]}##{tracking_data[:action]}", tracking_data
  end
end

内容的提问来源于stack exchange，提问作者Changwoo Rhee