mirror of
https://github.com/puma/puma.git
synced 2022-11-09 13:48:40 -05:00
6806c3b2cf
git-svn-id: svn+ssh://rubyforge.org/var/svn/mongrel/trunk@219 19e92222-5c0b-0410-8929-a290d50e31e9
99 lines
2.9 KiB
Ruby
99 lines
2.9 KiB
Ruby
# Mongrel Web Server - A Mostly Ruby Webserver and Library
|
|
#
|
|
# Copyright (C) 2005 Zed A. Shaw zedshaw AT zedshaw dot com
|
|
#
|
|
# This library is free software; you can redistribute it and/or
|
|
# modify it under the terms of the GNU Lesser General Public
|
|
# License as published by the Free Software Foundation; either
|
|
# version 2.1 of the License, or (at your option) any later version.
|
|
#
|
|
# This library is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
# Lesser General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public
|
|
# License along with this library; if not, write to the Free Software
|
|
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
# A very simple little class for doing some basic fast statistics sampling.
|
|
# You feed it either samples of numeric data you want measured or you call
|
|
# Stats.tick to get it to add a time delta between the last time you called it.
|
|
# When you're done either call sum, sumsq, n, min, max, mean or sd to get
|
|
# the information. The other option is to just call dump and see everything.
|
|
#
|
|
# It does all of this very fast and doesn't take up any memory since the samples
|
|
# are not stored but instead all the values are calculated on the fly.
|
|
class Stats
|
|
attr_reader :sum, :sumsq, :n, :min, :max
|
|
|
|
def initialize(name)
|
|
@name = name
|
|
reset
|
|
end
|
|
|
|
# Resets the internal counters so you can start sampling again.
|
|
def reset
|
|
@sum = 0.0
|
|
@sumsq = 0.0
|
|
@last_time = Time.new
|
|
@n = 0.0
|
|
@min = 0.0
|
|
@max = 0.0
|
|
end
|
|
|
|
# Adds a sampling to the calculations.
|
|
def sample(s)
|
|
@sum += s
|
|
@sumsq += s * s
|
|
if @n == 0
|
|
@min = @max = s
|
|
else
|
|
@min = s if @min > s
|
|
@max = s if @max < s
|
|
end
|
|
@n+=1
|
|
end
|
|
|
|
# Dump this Stats object with an optional additional message.
|
|
def dump(msg = "", out=STDERR)
|
|
out.puts "#{msg}: #{self.to_s}"
|
|
end
|
|
|
|
# Returns a common display (used by dump)
|
|
def to_s
|
|
"[#{@name}]: SUM=%0.4f, SUMSQ=%0.4f, N=%0.4f, MEAN=%0.4f, SD=%0.4f, MIN=%0.4f, MAX=%0.4f" % [@sum, @sumsq, @n, mean, sd, @min, @max]
|
|
end
|
|
|
|
|
|
# Calculates and returns the mean for the data passed so far.
|
|
def mean
|
|
@sum / @n
|
|
end
|
|
|
|
# Calculates the standard deviation of the data so far.
|
|
def sd
|
|
# (sqrt( ((s).sumsq - ( (s).sum * (s).sum / (s).n)) / ((s).n-1) ))
|
|
begin
|
|
return Math.sqrt( (@sumsq - ( @sum * @sum / @n)) / (@n-1) )
|
|
rescue Errno::EDOM
|
|
return 0.0
|
|
end
|
|
end
|
|
|
|
|
|
# Adds a time delta between now and the last time you called this. This
|
|
# will give you the average time between two activities.
|
|
#
|
|
# An example is:
|
|
#
|
|
# t = Stats.new("do_stuff")
|
|
# 10000.times { do_stuff(); t.tick }
|
|
# t.dump("time")
|
|
#
|
|
def tick
|
|
now = Time.now
|
|
sample(now - @last_time)
|
|
@last_time = now
|
|
end
|
|
end
|