Overview

Informant Rails

The informant-rails gem provides Rails and ActiveRecord hooks for The Informant.

Homepage

Compatibility

The informant-rails gem officially supports Ruby 2.5+.

It will work automatically with Rails 5.2+ as well as Mongoid 6.2 and up.

pipeline status

Installation

  1. Sign up for an account on https://www.informantapp.com or provision the Heroku add-on through https://dashboard.heroku.com
  2. Add the informant-rails gem to your Gemfile
   gem 'informant-rails', group: :production
  1. Verify the INFORMANT_API_KEY is set in your app's environment (it will be set automatically if you provision through Heroku)
  2. Deploy with the gem installed
  3. Submit a form and you'll see it appear in our web interface

We've set up informant-rails-example as a demonstrate of installation and operation.

Usage

By default, any request that causes an ActiveRecord or Mongoid model to be validated will be tracked by the Informant once the gem is added to your project.

Tracking Other Validations

If you have other objects that conform to the ActiveModel interface, you can include validation tracking in your class and it will just work.

class VeryActiveModel
  include InformantRails::ValidationTracking
end

Configuration

Configuration options are specified in the InformantRails::Config module. Reasonable defaults are provided but you can override them as necessary by creating an initializer and passing a block to configure.

InformantRails::Config.configure do |config|
  config.api_token = ENV['INFORMANT_API_KEY']
  config.exclude_models = %w(UntrackedModel)
  config.filter_parameters.push *%w(password password_confirmation)
  config.value_tracking = true
end

api_token

Default Value: ENV['INFORMANT_API_KEY']

Example Value: dff67d9e61eaa8cf110b3d3f3238a671

This should be set to the API key assigned to you when you provisioned your application. Heroku will automatically add this to your environment when you provision the addon. Otherwise, you can get this from the Informant web application.

exclude_models

Default Value: []

Example Value: ['Person', 'Employee']

This allows you to exclude certain models from tracking. If you don't want them to be included, just list their class names as strings.

filter_parameters

Default Value: Rails.configuration.filter_parameters

Example Value: ['password', 'password_confirmation']

Any field names specified here will not be included in value tracking. Any sensitive information that you wouldn't want to include in your server log should be listed here as well.

value_tracking

Default Value: true

Example Value: false

This will enable and disable tracking of values globally. If you turn this off, no field value information will be sent at all. This is useful if you have compliance or security concerns about the nature of your data.