Sha256: f2262728a4104b3cd4569312c86261ad9a0e6bb9bdba5955d63c59b37244fe83
Contents?: true
Size: 1.76 KB
Versions: 19
Compression:
Stored size: 1.76 KB
Contents
= Gatoroid
Gatoroid is a way to store analytics using the powerful features of MongoDB for scalability
Leveraging mongoid, Gatoroid is a way to increment, decrement, add to, and reset counters in MongoDB. The data is stored using an hourly grain in a utc allowing for easy analytics for on just about anything.
== Using Gatoroid to store analytics information
Simply create a class that includes Mongoid::Gator
class SiteStats
include Mongoid::Gator
field :siteid
gator_field :visits
end
Use the class to increment the counter for visits to the site.
@site_stats = SiteStats.new()
@site_stats.visits.inc(:siteid=>100)
You can also add to the count using the add method. The following adds 10 visits to tomorrow.
@site_stats.visits.add(10, :date=>Today.now + 1.day)
The data will be stored in MongoDB using seconds since the epoch in hours
{
"_id" : ObjectId("4f85b40f2a2c4e4d9709eaf9"),
"date" : 1334160000,
"siteid" : 100,
"visits" : 1
}
You can view the total visits to a site by using some built in functions. For example:
@site_stats = SiteStats.new()
@site_stats.visits.today(:siteid=>100) # returns total for today as integer
@site_stats.visits.yesterday(:siteid=100) # returns total for yesterday as integer
To get a list of visits to for a range, use the range method.
@site_stats = SiteStats.new()
@site_stats.visits.range(Time.now..Time.now + 1.day,Mongoid::Gator::Readers::DAY, :siteid=>100)
You can change the grain on which you would like to return the data using
Mongoid::Gator::Readers::HOUR
Mongoid::Gator::Readers::DAY
Mongoid::Gator::Readers::MONTH
Version data entries
19 entries across 19 versions & 1 rubygems