class Hitimes::Metric

Metric hold the common meta information for all derived metric classes

All metrics hold the meta information of:

* The name of the metric * The time of day the first measurement is taken * The time of day the last measurement is taken * additional data

Each derived class is assumed to set the sampling_start_time and sampling_stop_time appropriately.

Metric itself should generally not be used. Only use the derived classes.

Attributes

additional_data[R]

An additional hash of data to associate with the metric

name[R]

The ‘name’ to associate with the metric

sampling_delta[R]

the number of seconds as a float since the sampling_start_time

Public Class Methods

new( 'my_metric' ) → Metric click to toggle source
new( 'my_metric', 'foo' => 'bar', 'this' => 42 ) → Metric

Create a new ValueMetric giving it a name and additional data.

additional_data may be anything that follows the to_hash protocol. name may be anything that follows the to_s protocol.

# File lib/hitimes/metric.rb, line 44
def initialize(name, additional_data = {})
  @sampling_start_time     = nil
  @sampling_start_interval = nil
  @sampling_delta          = 0

  @name                = name.to_s
  @additional_data     = additional_data.to_hash
end

Public Instance Methods

sampling_start_time → Float or nil click to toggle source

The time at which the first sample was taken. This is the number of microseconds since UNIX epoch UTC as a Float

If the metric has not started measuring then the start time is nil.

# File lib/hitimes/metric.rb, line 62
def sampling_start_time
  return unless @sampling_start_interval

  @sampling_start_time ||= utc_microseconds
end
sampling_stop_time → Float or nil click to toggle source

The time at which the last sample was taken This is the number of microseconds since UNIX epoch UTC as a Float

If the metric has not completely measured at least one thing then stop time is nil.

Because accessing the actual ‘time of day’ is an expesive operation, we only get the time of day at the beginning of the first measurement and we keep track of the offset from that point in @sampling_delta.

When sampling_stop_time is called, the actual time of day is caculated.

# File lib/hitimes/metric.rb, line 84
def sampling_stop_time
  return unless @sampling_delta.positive?

  (sampling_start_time + (@sampling_delta * 1_000_000))
end
to_hash → Hash click to toggle source
to_hash

Convert the metric to a Hash.

# File lib/hitimes/metric.rb, line 97
def to_hash
  { "sampling_start_time" => sampling_start_time,
    "sampling_stop_time" => sampling_stop_time,
    "additional_data" => additional_data,
    "name" => name, }
end
utc_microseconds → Float click to toggle source

The current time in microseconds from the UNIX Epoch in the UTC

# File lib/hitimes/metric.rb, line 110
def utc_microseconds
  Time.now.gmtime.to_f * 1_000_000
end