Rollout项目中如何记录功能开关操作的用户信息

在功能开关(Feature Flags)管理系统中，记录操作日志是非常重要的一环。Rollout作为一个Ruby实现的轻量级功能开关库，提供了灵活的日志记录机制。本文将详细介绍如何在Rollout中记录操作用户信息，特别是当通过应用程序而非Web界面修改功能开关状态时。

问题背景

当用户通过Web界面修改功能开关状态时，Rollout会自动记录当前用户的电子邮件信息。但在通过应用程序代码直接修改时，日志中只会显示"unidentified user"，这不利于后续的审计和问题排查。

解决方案

Rollout提供了logging.with_context方法，允许开发者为特定操作添加上下文信息。以下是实现用户信息记录的标准做法：

rollout.logging.with_context(actor: current_user.email) do
  rollout.set(:new_feature, true)
end

这段代码会在日志中记录当前执行操作的用户邮箱，与Web界面上的行为保持一致。

实现原理

Rollout的日志系统基于上下文传递机制：

1. with_context方法创建一个临时的上下文环境
2. 在该块内执行的所有操作都会携带这些上下文信息
3. 日志记录器会自动提取上下文中的相关信息并格式化输出

高级用法

除了记录用户信息，还可以利用这个机制添加更多上下文：

rollout.logging.with_context(
  actor: current_user.email,
  request_id: request.uuid,
  environment: Rails.env
) do
  rollout.activate(:experimental_feature)
end

最佳实践

1. 在Web应用中，建议将用户上下文记录封装为before_action
2. 对于后台任务，可以记录任务ID或执行者信息
3. 保持上下文信息的简洁性，避免记录敏感数据
4. 统一上下文字段命名规范，便于日志分析

总结

通过Rollout的上下文日志机制，我们可以轻松实现功能开关操作的完整审计追踪。这种设计既保持了API的简洁性，又提供了足够的灵活性来满足不同场景的需求。合理利用这一特性可以显著提升系统的可观测性和运维效率。