Sha256: 72671ef7bd48d32ae7d1968806ec0a4d058d1fec1a9017ae614804f46e96f7b8

Contents?: true

Size: 1.44 KB

Versions: 9

Compression:

Stored size: 1.44 KB

Contents

# encoding: utf-8
# This file is distributed under New Relic's license terms.
# See https://github.com/newrelic/rpm/blob/master/LICENSE for complete details.

# A Sampler is used to capture meaningful metrics in a background thread
# periodically.  They will either be invoked once a minute just before the
# data is sent to the agent (default) or every 10 seconds, when #use_harvest_sampler?
# returns false.
#
# Samplers can be added to New Relic by subclassing NewRelic::Agent::Sampler.
# Instances are created when the agent is enabled and installed.  Subclasses
# are registered for instantiation automatically.
module NewRelic
  module Agent
    class Sampler

      # Exception denotes a sampler is not available and it will not be registered.
      class Unsupported < StandardError;  end

      attr_accessor :stats_engine
      attr_reader :id
      @sampler_classes = []

      def self.inherited(subclass)
        @sampler_classes << subclass
      end

      # Override with check.  Called before instantiating.
      def self.supported_on_this_platform?
        true
      end

      # Override to use the periodic sampler instead of running the sampler on the
      # minute during harvests.
      def self.use_harvest_sampler?
        true
      end

      def self.sampler_classes
        @sampler_classes
      end

      def initialize(id)
        @id = id
      end

      def poll
        raise "Implement in the subclass"
      end


    end
  end
end

Version data entries

9 entries across 9 versions & 1 rubygems

Version Path
newrelic_rpm-3.6.2.96 lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.2.90.beta lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.1.88 lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.1.87 lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.1.86.beta lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.1.85.beta lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.0.83 lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.0.78 lib/new_relic/agent/sampler.rb
newrelic_rpm-3.6.0.74.beta lib/new_relic/agent/sampler.rb