Setup & Usage
Add the gem to your Gemfile.
Visit instrumentalapp.com and create an account, then initialize the agent with your API key, found in the Docs section.
I = Instrumental::Agent.new('YOUR_API_KEY', :enabled => Rails.env.production?)
If you're already using EventMachine elsewhere, or are hosted on Heroku, then you will need to disable the reactor loop startup.
I = Instrumental::Agent.new('YOUR_API_KEY', :enabled => Rails.env.production?, :start_reactor => false)
Now you can begin to use Instrumental to track your application.
I.gauge('load', 1.23) I.increment('signups')
Data without historical context sucks. Instrumental lets you backfill data, allowing you to see deep into your project's past.
User.find_each do |user| I.increment('signups', 1, user.created_at) end
Want some general server stats (load, memory, etc.)? Run this command, sorry not daemonized yet :)
Running under Rails? You can also give our experimental Rack middleware a shot by initializing it with:
Troubleshooting & Help
We are here to help, please email us at firstname.lastname@example.org.