我有一个包含ActiveRecord和ActiveResource模型的大型项目。我需要使用这些模型实现用户活动的日志记录,并记录模型属性的更改(保存对象状态或类似的东西)。更改可以由用户或 cron 耙任务进行。
我还必须有可能按日期、任何字段搜索任何数据......等
生成带有上次活动的可读消息也会很好,例如
- 用户 Bob 将密码更改为 * 并发送电子邮件至 ** 于 2011-08-12 08:12
- 员工 Jeff 新增合伙人: 公司名称 于 2011-08-12 08:13
- 管理员杰克删除产品 : 产品名称在 2011-09-12 11:11
- 客户Sam订购新服务:服务名称于2011-09-12 11:12
有人实现这样的日志记录吗?想法?建议?
我应该使用 gem 还是可以在观察者不更改模型的情况下执行所有逻辑?
我喜欢 gem https://github.com/airblade/paper_trail 谁能说我怎样才能让它与活动资源一起工作?
您正在寻找
https://github.com/collectiveidea/acts_as_audited
很少有开源项目使用这个插件,我认为Red Mine和The Foreman。
编辑:不幸的是,它只能做ActiveRecord,不能做ActiveResource。
Fivell,我刚刚看到这个问题,今天晚上在赏金到期之前没有时间进行更改,所以我会给你我的审计代码,它适用于 ActiveRecord,应该适用于 ActiveResource,也许需要一些调整(我不经常使用 ARes,无法立即了解)。我知道我们使用的回调在那里,但我不确定 ARes 是否具有 ActiveRecord 的脏属性changes
跟踪。
此代码记录所有模型上的每个创建/更新/删除(审核日志模型上的 CREATE 和指定的任何其他例外除外),并将更改存储为 JSON。还会存储清理的回溯,以便您可以确定哪些代码进行了更改(这会捕获 MVC 中的任何点以及 rake 任务和控制台使用情况)。
此代码适用于控制台使用、耙任务和 http 请求,尽管通常只有最后一个记录当前用户。(如果我没记错的话,它替换的 ActiveRecord 观察器在耙子任务或控制台中不起作用。哦,这段代码来自一个 Rails 2.3 应用程序 - 我有几个 Rails 3 应用程序,但我还没有对它们进行这种审核。
我没有代码可以很好地显示此信息(我们仅在需要调查问题时才深入研究数据),但由于更改存储为 JSON,因此应该相当简单。
首先,我们将当前用户存储在User.current中,以便可以在任何地方访问它,因此在app/models/user.rb
:
Class User < ActiveRecord::Base
cattr_accessor :current
...
end
当前用户在应用程序控制器中为每个请求设置,如下所示(并且不会导致并发问题):
def current_user
User.current = session[:user_id] ? User.find_by_id(session[:user_id]) : nil
end
如果有意义的话,您可以在耙子任务中设置User.current
。
接下来,我们定义模型以存储审核信息app/models/audit_log_entry.rb
- 您需要自定义IgnoreClassesRegEx
以适应您不想审核的任何模型:
# == Schema Information
#
# Table name: audit_log_entries
#
# id :integer not null, primary key
# class_name :string(255)
# entity_id :integer
# user_id :integer
# action :string(255)
# data :text
# call_chain :text
# created_at :datetime
# updated_at :datetime
#
class AuditLogEntry < ActiveRecord::Base
IgnoreClassesRegEx = /^ActiveRecord::Acts::Versioned|ActiveRecord.*::Session|Session|Sequence|SchemaMigration|CronRun|CronRunMessage|FontMetric$/
belongs_to :user
def entity (reload = false)
@entity = nil if reload
begin
@entity ||= Kernel.const_get(class_name).find_by_id(entity_id)
rescue
nil
end
end
def call_chain
return if call_chain_before_type_cast.blank?
if call_chain_before_type_cast.instance_of?(Array)
call_chain_before_type_cast
else
JSON.parse(call_chain_before_type_cast)
end
end
def data
return if data_before_type_cast.blank?
if data_before_type_cast.instance_of?(Hash)
data_before_type_cast
else
JSON.parse(data_before_type_cast)
end
end
def self.debug_entity(class_name, entity_id)
require 'fastercsv'
FasterCSV.generate do |csv|
csv << %w[class_name entity_id date action first_name last_name data]
find_all_by_class_name_and_entity_id(class_name, entity_id,
:order => 'created_at').each do |a|
csv << [a.class_name, a.entity_id, a.created_at, a.action,
(a.user && a.user.first_name), (a.user && a.user.last_name), a.data]
end
end
end
end
接下来,我们添加一些方法ActiveRecord::Base
以使审核正常工作。您需要查看audit_log_clean_backtrace
方法并根据需要进行修改。(FWIW,我们将现有类的添加放在lib/extensions/*.rb
中,这些类加载在初始值设定项中。在lib/extensions/active_record.rb
:
class ActiveRecord::Base
cattr_accessor :audit_log_backtrace_cleaner
after_create :audit_log_on_create
before_update :save_audit_log_update_diff
after_update :audit_log_on_update
after_destroy :audit_log_on_destroy
def audit_log_on_create
return if self.class.name =~ /AuditLogEntry/
return if self.class.name =~ AuditLogEntry::IgnoreClassesRegEx
audit_log_create 'CREATE', self, caller
end
def save_audit_log_update_diff
@audit_log_update_diff = changes.reject{ |k,v| 'updated_at' == k }
end
def audit_log_on_update
return if self.class.name =~ AuditLogEntry::IgnoreClassesRegEx
return if @audit_log_update_diff.empty?
audit_log_create 'UPDATE', @audit_log_update_diff, caller
end
def audit_log_on_destroy
return if self.class.name =~ AuditLogEntry::IgnoreClassesRegEx
audit_log_create 'DESTROY', self, caller
end
def audit_log_create (action, data, call_chain)
AuditLogEntry.create :user => User.current,
:action => action,
:class_name => self.class.name,
:entity_id => id,
:data => data.to_json,
:call_chain => audit_log_clean_backtrace(call_chain).to_json
end
def audit_log_clean_backtrace (backtrace)
if !ActiveRecord::Base.audit_log_backtrace_cleaner
ActiveRecord::Base.audit_log_backtrace_cleaner = ActiveSupport::BacktraceCleaner.new
ActiveRecord::Base.audit_log_backtrace_cleaner.add_silencer { |line| line =~ //lib/rake.rb/ }
ActiveRecord::Base.audit_log_backtrace_cleaner.add_silencer { |line| line =~ //bin/rake/ }
ActiveRecord::Base.audit_log_backtrace_cleaner.add_silencer { |line| line =~ //lib/(action_controller|active_(support|record)|hoptoad_notifier|phusion_passenger|rack|ruby|sass)// }
ActiveRecord::Base.audit_log_backtrace_cleaner.add_filter { |line| line.gsub(RAILS_ROOT, '') }
end
ActiveRecord::Base.audit_log_backtrace_cleaner.clean backtrace
end
end
最后,这是我们对此进行的测试 - 当然,您需要修改实际的测试操作。 test/integration/audit_log_test.rb
require File.dirname(__FILE__) + '/../test_helper'
class AuditLogTest < ActionController::IntegrationTest
def setup
end
def test_audit_log
u = users(:manager)
log_in u
a = Alert.first :order => 'id DESC'
visit 'alerts/new'
fill_in 'alert_note'
click_button 'Send Alert'
a = Alert.first :order => 'id DESC', :conditions => ['id > ?', a ? a.id : 0]
ale = AuditLogEntry.first :conditions => {:class_name => 'Alert', :entity_id => a.id }
assert_equal 'Alert', ale.class_name
assert_equal 'CREATE', ale.action
end
private
def log_in (user, password = 'test', initial_url = home_path)
visit initial_url
assert_contain 'I forgot my password'
fill_in 'email', :with => user.email
fill_in 'password', :with => password
click_button 'Log In'
end
def log_out
visit logout_path
assert_contain 'I forgot my password'
end
end
test/unit/audit_log_entry_test.rb
:
# == Schema Information
#
# Table name: audit_log_entries
#
# id :integer not null, primary key
# class_name :string(255)
# action :string(255)
# data :text
# user_id :integer
# created_at :datetime
# updated_at :datetime
# entity_id :integer
# call_chain :text
#
require File.dirname(__FILE__) + '/../test_helper'
class AuditLogEntryTest < ActiveSupport::TestCase
test 'should handle create update and delete' do
record = Alert.new :note => 'Test Alert'
assert_difference 'Alert.count' do
assert_difference 'AuditLogEntry.count' do
record.save
ale = AuditLogEntry.first :order => 'created_at DESC'
assert ale
assert_equal 'CREATE', ale.action, 'AuditLogEntry.action should be CREATE'
assert_equal record.class.name, ale.class_name, 'AuditLogEntry.class_name should match record.class.name'
assert_equal record.id, ale.entity_id, 'AuditLogEntry.entity_id should match record.id'
end
end
assert_difference 'AuditLogEntry.count' do
record.update_attribute 'note', 'Test Update'
ale = AuditLogEntry.first :order => 'created_at DESC'
expected_data = {'note' => ['Test Alert', 'Test Update']}
assert ale
assert_equal 'UPDATE', ale.action, 'AuditLogEntry.action should be UPDATE'
assert_equal expected_data, ale.data
assert_equal record.class.name, ale.class_name, 'AuditLogEntry.class_name should match record.class.name'
assert_equal record.id, ale.entity_id, 'AuditLogEntry.entity_id should match record.id'
end
assert_difference 'AuditLogEntry.count' do
record.destroy
ale = AuditLogEntry.first :order => 'created_at DESC'
assert ale
assert_equal 'DESTROY', ale.action, 'AuditLogEntry.action should be CREATE'
assert_equal record.class.name, ale.class_name, 'AuditLogEntry.class_name should match record.class.name'
assert_equal record.id, ale.entity_id, 'AuditLogEntry.entity_id should match record.id'
assert_nil Alert.find_by_id(record.id), 'Alert should be deleted'
end
end
test 'should not log AuditLogEntry create entry and block on update and delete' do
record = Alert.new :note => 'Test Alert'
assert_difference 'Alert.count' do
assert_difference 'AuditLogEntry.count' do
record.save
end
end
ale = AuditLogEntry.first :order => 'created_at DESC'
assert_equal 'CREATE', ale.action, 'AuditLogEntry.action should be CREATE'
assert_equal record.class.name, ale.class_name, 'AuditLogEntry.class_name should match record.class.name'
assert_equal record.id, ale.entity_id, 'AuditLogEntry.entity_id should match record.id'
assert_nil AuditLogEntry.first(:conditions => { :class_name => 'AuditLogEntry', :entity_id => ale.id })
if ale.user_id.nil?
u = User.first
else
u = User.first :conditions => ['id != ?', ale.user_id]
end
ale.user_id = u.id
assert !ale.save
assert !ale.destroy
end
end
https://github.com/collectiveidea/acts_as_audited
和
https://github.com/airblade/paper_trail
都是仅适用于ActiveRecord
的好解决方案,但由于ActiveRecord
大部分内容已被提取到 ActiveModel
,因此至少对于只读支持,扩展以支持ActiveResource
可能是合理的。 我浏览了 Github 网络图并用谷歌搜索了一下,似乎没有任何正在进行的此类解决方案的开发,但我希望在这两个插件之一之上实现比从头开始更容易。 paper_trail
似乎正在更积极的开发中,并且有一些针对 Rails 3.1 的提交,所以它可能与 Rails 内部更新并且更容易扩展,但这只是一个直觉——我不熟悉两者的内部结构。
acts_as_audited gem 应该适合您:
https://github.com/collectiveidea/acts_as_audited
就ActiveResource而言,它也将成为其他应用程序中的模型。您可以在服务器端使用 Gem,而无需在客户端审核它。所有使用 ActiveResource 的 CRUD 操作最终都会转换为 ActiveRecord(服务器端)上的 CRUD 操作。
因此,您可能需要从远处看它,并且相同的解决方案适用于这两种情况,但在不同的地方。
用于跟踪用户活动(CRUD),我已经创建了一个从Logger继承的类,现在我计划编写一个用于跟踪用户的插件,我可以将其用于任何构建的ROR应用程序。我已经检查过是否有这样的插件,但我没有看到。我想有很多宝石,如纸质记录、acts_as_audited或它的日志,但我更喜欢使用插件。有什么建议吗?这是一个可能对您有所帮助的链接:http://robaldred.co.uk/2009/01/custom-log-files-for-your-ruby-on-rails-applications/comment-page-1/#comment-342
漂亮的编码