wavefront-sdk 5.4.4 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f0aafb012ded5a99a13ee3553d686e0552f5c4cae8da39e70139f6882aadcc9
-  data.tar.gz: b033a54d99e7a8402d04fd3555d56c53c765b655f89c59c6b1b27e2880ec5945
+  metadata.gz: 5d89604feef126265df36a17289e1f1320b07e30787f7596d195ea76284526c1
+  data.tar.gz: 393ea7ba3b44646eb1b67c6976713941530b36943ded7e12c4f6a5ee1d87ca7f
 SHA512:
-  metadata.gz: e647c51a97b626d080d7d666e17b81c6ead709b8780f0bb3f2897fc34d326df65d6c524359f4ea461520ef75cf7d29883f1f822feb774b06a3d822ce7717e882
-  data.tar.gz: c6602237acfdf5c18820e086071e1f06cc73199fc45ef02e689f091fec36208936b3618c5ec0d1464fff2773f4424bb49d0be3c9ba394da5d31143a14e2aed71
+  metadata.gz: ccd6b23b76944bbac1a1790b61b79365dfb2da530c8c851f19052c57128db3744e52aa29b81194709315925d87b4627eef6c96079fe5a10534fbbf358cd43dfb
+  data.tar.gz: 4228c14a3f026d74e98dfae97a22a689772bfd4ae590820832b5ffe5af8c052e2c63a9ace60cea66c6038f50d6a3495c564c38ddb7b0def1b4013d8b6ce421d5

data/.github/workflows/release.yml

@@ -11,14 +11,14 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set env
       run: echo "RELEASE_VERSION=$(echo ${GITHUB_REF:10})" >> $GITHUB_ENV
 
-    - name: Set up Ruby 2.7
+    - name: Set up Ruby 3.0
       uses: ruby/setup-ruby@v1
       with:
-        ruby-version: 2.7
+        ruby-version: 3.0
     - run: bundle install
 
     - name: Run tests

data/.github/workflows/test.yml

@@ -9,9 +9,9 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: [2.4.10, 2.5.8, 2.6.6, 2.7.2, 3.0.0]
+        ruby-version: [2.7.7, 3.1.3, 3.2.0]
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:

data/.rubocop.yml

@@ -1,7 +1,7 @@
 ---
 
 AllCops:
-  TargetRubyVersion: 2.4
+  TargetRubyVersion: 2.7
   NewCops: enable
 
 require:
@@ -14,7 +14,5 @@ Layout/LineLength:
   Max: 80
 Metrics/ClassLength:
   Max: 150
-Style/StringConcatenation:
-  Enabled: false
 Style/OptionalBooleanParameter:
   Enabled: false

data/HISTORY.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 7.0.0 (2023-01-19)
+* Drop support for Ruby 2.5. (Breaking change.)
+* Drop support for Ruby 2.6. (Breaking change.)
+* Bugfix for `metricspolicy` API.
+
+## 6.0.0 (2021-07-16)
+* Drop support for Ruby 2.4. (Breaking change.)
+* Change the name of the proxy writer from `socket` to `proxy`. (Breaking
+  change.)
+* Change the name of the Unix datagram socket writer from `unix` to `socket`.
+* added `Wavefront::Event#alert_firing_details`.
+* added `Wavefront::Event#alert_queries_slug`.
+* added `Wavefront::Event#events`.
+* added `Wavefront::Event#alert_firings`.
+* Add `Wavefront::MetricsPolicy`.
+* Add `Wavefront::Spy#deltas`.
+
 ## 5.4.4 (2021-02-01)
 * Fix credential validation on writer classes.
 * Improve tests for writer classes

data/README.md

@@ -1,5 +1,5 @@
 # wavefront-sdk
-![Test](https://github.com/snltd/wavefront-sdk/workflows/Test/badge.svg) ![Release](https://github.com/snltd/wavefront-sdk/workflows/Release/badge.svg) [![Code Climate](https://codeclimate.com/github/snltd/wavefront-sdk/badges/gpa.svg)](https://codeclimate.com/github/snltd/wavefront-sdk) [![Issue Count](https://codeclimate.com/github/snltd/wavefront-sdk/badges/issue_count.svg)](https://codeclimate.com/github/snltd/wavefront-sdk) [![Gem Version](https://badge.fury.io/rb/wavefront-sdk.svg)](https://badge.fury.io/rb/wavefront-sdk) ![](http://ruby-gem-downloads-badge.herokuapp.com/wavefront-sdk?type=total)
+[![Test](https://github.com/snltd/wavefront-sdk/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/snltd/wavefront-sdk/actions/workflows/test.yml) [![Release](https://github.com/snltd/wavefront-sdk/actions/workflows/release.yml/badge.svg?branch=master)](https://github.com/snltd/wavefront-sdk/actions/workflows/release.yml) [![Code Climate](https://codeclimate.com/github/snltd/wavefront-sdk/badges/gpa.svg)](https://codeclimate.com/github/snltd/wavefront-sdk) [![Issue Count](https://codeclimate.com/github/snltd/wavefront-sdk/badges/issue_count.svg)](https://codeclimate.com/github/snltd/wavefront-sdk) [![Gem Version](https://badge.fury.io/rb/wavefront-sdk.svg)](https://badge.fury.io/rb/wavefront-sdk) ![](http://ruby-gem-downloads-badge.herokuapp.com/wavefront-sdk?type=total)
 
 This is a Ruby SDK for v2 of
 [Wavefront](https://www.wavefront.com/)'s public API. It aims to be
@@ -24,7 +24,7 @@ or to build locally,
 $ gem build wavefront-sdk.gemspec
 ```
 
-`wavefront-sdk` requires Ruby >= 2.4. All its dependencies are pure
+`wavefront-sdk` requires Ruby >= 2.7. All its dependencies are pure
 Ruby, right the way down, so a compiler should never be required to
 install it.
 
@@ -41,7 +41,7 @@ method will return a `Wavefront::Response` object. This object has
 `status` and `response` methods. `status` always yields a structure
 containing `result`, `message` and `code` fields which can be
 inspected to ensure an API call was processed successfully.
-`response` gives you a the JSON response from the API, conveniently
+`response` gives you the JSON response from the API, conveniently
 processed and turned into a [`Map`](https://github.com/ahoward/map)
 object. Map objects can be interrogated in various ways. For
 instance `map['items']`, `map[:items]` and `map.items` will all get
@@ -203,7 +203,7 @@ wf.close
 ```
 
 Alternatively, pass `false` as the second argument to `Write#write`.
-(This is the legacy method, kept in for backward compatability.)
+(This is the legacy method, kept in for backward compatibility.)
 
 ```ruby
 wf = Wavefront::Write.new(Wavefront::Credentials.new.proxy)
@@ -220,7 +220,7 @@ but other methods are supported via the `writer` option.
 wf = Wavefront::Write.new(Wavefront::Credentials.new.creds, writer: :api)
 
 # To send points via a local Unix socket
-wf = Wavefront::Write.new(socket: '/tmp/wf_sock', { writer: :unix })
+wf = Wavefront::Write.new({ socket: '/tmp/wf_sock'}, { writer: :socket })
 
 # To send points over HTTP
 wf = Wavefront::Write.new(Wavefront::Credentials.new.creds, writer: :http)

data/lib/wavefront-sdk/api_mixins/acl.rb

@@ -80,7 +80,7 @@ module Wavefront
       end
 
       def valid_acl_body?(list)
-        return true if list.is_a?(Array) && list.all? { |h| h.is_a?(String) }
+        return true if list.is_a?(Array) && list.all?(String)
 
         raise ArgumentError
       end

data/lib/wavefront-sdk/core/api.rb

@@ -94,7 +94,7 @@ module Wavefront
     def hash_for_update(old, new)
       raise ArgumentError unless old.is_a?(Hash) && new.is_a?(Hash)
 
-      Hash[old.merge(new).map { |k, v| [k.to_sym, v] }].select do |k, _v|
+      old.merge(new).transform_keys(&:to_sym).select do |k, _v|
         update_keys.include?(k)
       end
     end

data/lib/wavefront-sdk/core/api_caller.rb

@@ -229,14 +229,8 @@ module Wavefront
       return if noop
 
       pp args if debug
-
       resp = conn.public_send(method, *args)
-
-      if debug
-        require 'pp'
-        pp resp
-      end
-
+      pp resp if debug
       respond(resp)
     end
 

data/lib/wavefront-sdk/core/exception.rb

@@ -59,6 +59,8 @@ module Wavefront
 
     class InvalidMetricName < RuntimeError; end
 
+    class InvalidMetricsPolicyId < RuntimeError; end
+
     class InvalidMetricValue < RuntimeError; end
 
     class InvalidName < RuntimeError; end

data/lib/wavefront-sdk/core/response.rb

@@ -51,7 +51,7 @@ module Wavefront
     # Were there items in the response?
     #
     def empty?
-      response.items.size.zero?
+      response.items.empty?
     rescue StandardError
       false
     end

data/lib/wavefront-sdk/credentials.rb

@@ -82,8 +82,8 @@ module Wavefront
         Array(Pathname.new(opts[:file]))
       else
         [Pathname.new('/etc/wavefront/credentials'),
-         Pathname.new(ENV['HOME']) + '.wavefront.conf',
-         Pathname.new(ENV['HOME']) + '.wavefront']
+         Pathname.new(Dir.home).join('.wavefront.conf'),
+         Pathname.new(Dir.home).join('.wavefront')]
       end
     end
 
@@ -128,9 +128,7 @@ module Wavefront
     # @return [Hash] options loaded from file. Each key becomes a symbol
     #
     def load_profile(file, profile = 'default')
-      IniFile.load(file)[profile].each_with_object({}) do |(k, v), memo|
-        memo[k.to_sym] = v
-      end
+      IniFile.load(file)[profile].transform_keys(&:to_sym)
     rescue StandardError
       raise Wavefront::Exception::InvalidConfigFile, file
     end

data/lib/wavefront-sdk/defs/version.rb

@@ -2,5 +2,5 @@
 
 require 'pathname'
 
-WF_SDK_VERSION = '5.4.4'
+WF_SDK_VERSION = '7.0.0'
 WF_SDK_LOCATION = Pathname.new(__dir__).parent.parent.parent

data/lib/wavefront-sdk/event.rb

@@ -117,12 +117,75 @@ module Wavefront
       api.post([id, 'close'].uri_concat)
     end
 
-    def valid_id?(id)
+    # GET /api/v2/event/{id}/alertFiringDetails
+    # Return details of a particular alert firing, including all the series
+    # that fired during the referred alert firing
+    #
+    # @param id [String] ID of the event
+    # @return [Wavefront::Response]
+    #
+    def alert_firing_details(id)
+      wf_event_id?(id)
+      api.get([id, 'alertFiringDetails'].uri_concat)
+    end
+
+    # GET /api/v2/event/{id}/alertQueriesSlug
+    # If the specified event is associated with an alert, returns a slug
+    # encoding the queries having to do with that alert firing or resolution
+    # @param id [String] ID of the event
+    # @return [Wavefront::Response]
+    #
+    def alert_queries_slug(id)
+      wf_event_id?(id)
+      api.get([id, 'alertQueriesSlug'].uri_concat)
+    end
+
+    # GET /api/v2/event/{id}/events
+    # List all related events for a specific firing event with a time span of
+    # one hour
+    # @param id [String] ID of the event
+    # @param opts [Hash] containing one or more of
+    #   is_overlapped [Bool]
+    #   rendering_method [Symbol,String] one of :HOST, :METRIC, :SIMILARITY
+    #   limit [Integer]
+    # @return [Wavefront::Response]
+    #
+    def events(id, opts = {})
       wf_event_id?(id)
+
+      api.get([id, 'events'].uri_concat,
+              { isOverlapped: opts[:is_overlapped] || false,
+                renderingMethod: (opts[:rendering_method] || :HOST).to_s,
+                limit: opts[:limit] || nil }.compact)
+    end
+
+    # GET /api/v2/event/alertFirings
+    # Get firings events of an alert within a time range
+    # @param alert_id [String] ID of the alert
+    # @param opts [Hash] containing one or more of
+    #   earliest_start [Integer] epoch ms timestamp
+    #   latest_start [Integer] epoch ms timestamp
+    #   ascending [Bool]
+    #   limit [Integer]
+    # @return [Wavefront::Response]
+    #
+    def alert_firings(alert_id, opts = {})
+      wf_alert_id?(alert_id)
+
+      api.get('alertFirings',
+              { alertId: alert_id,
+                earliestStartTimeEpochMillis: opts[:earliest_start] || nil,
+                latestStartTimeEpochMillis: opts[:latest_start] || nil,
+                limit: opts[:limit] || nil,
+                asc: opts[:asc] || true }.compact)
     end
 
     private
 
+    def valid_id?(id)
+      wf_event_id?(id)
+    end
+
     def list_body(t_start, t_end, limit, cursor)
       { earliestStartTimeEpochMillis: parse_time(t_start, true),
         latestStartTimeEpochMillis: parse_time(t_end, true),

data/lib/wavefront-sdk/maintenancewindow.rb

@@ -93,7 +93,7 @@ module Wavefront
     # @return [Wavefront::Response]
     #
     def pending(hours = 24)
-      cutoff = Time.now.to_i + hours * 3600
+      cutoff = Time.now.to_i + (hours * 3600)
 
       ret = windows_in_state(:pending)
 

data/lib/wavefront-sdk/metric.rb

@@ -27,10 +27,10 @@ module Wavefront
       if cursor
         raise ArgumentError unless cursor.is_a?(String)
 
-        query.<< [:c, cursor]
+        query << [:c, cursor]
       end
 
-      sources.each { |source| query.<< [:h, source] }
+      sources.each { |source| query << [:h, source] }
 
       api.get('detail', query)
     end

data/lib/wavefront-sdk/metric_helper.rb

@@ -37,7 +37,7 @@ module Wavefront
     def gauge(path, value, tags = nil)
       gauge = { path: path, ts: Time.now.to_i, value: value }
       gauge[:tags] = tags if tags
-      @buf[:gauges].<< gauge
+      @buf[:gauges] << gauge
     end
 
     # These counters are internal, and specific to the SDK. When

data/lib/wavefront-sdk/metricspolicy.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative 'core/api'
+
+module Wavefront
+  #
+  # Manage and query Wavefront metrics policies
+  #
+  class MetricsPolicy < CoreApi
+    # GET /api/v2/metricspolicy
+    # Get the metrics policy
+    # GET /api/v2/metricspolicy/history/{version}
+    # Get a specific historical version of a metrics policy
+    # @param version [Integer] specify version to describe
+    # @return [Wavefront::Response]
+    #
+    def describe(version = nil)
+      if version
+        wf_version?(version)
+        api.get(['history', version].uri_concat)
+      else
+        api.get('')
+      end
+    end
+
+    # GET /api/v2/metricspolicy/history
+    # Get the version history of metrics policy
+    #
+    # @param offset [Integer] version at which the list begins
+    # @param limit [Integer] the number of versions to return
+    #
+    def history(offset = 0, limit = 100)
+      api.get('history', offset: offset, limit: limit)
+    end
+
+    # POST /api/v2/metricspolicy/revert/{version}
+    # Revert to a specific historical version of a metrics policy
+    # @param version [Integer] specify version to describe
+    # @return [Wavefront::Response]
+    #
+    def revert(version)
+      wf_version?(version)
+      api.post(['revert', version].uri_concat, nil, 'application/json')
+    end
+
+    # PUT /api/v2/metricspolicy
+    # Update the metrics policy
+    # @param body [Hash] hash describing metrics policy
+    # @return [Wavefront::Response]
+    #
+    def update(body)
+      raise ArgumentError unless body.is_a?(Hash)
+
+      api.put('', body, 'application/json')
+    end
+  end
+end

data/lib/wavefront-sdk/paginator/base.rb

@@ -166,7 +166,7 @@ module Wavefront
             end
 
             p_args = set_pagination(offset, page_size, p_args)
-            resp.response.items.map { |i| y.<< i }
+            resp.response.items.map { |i| y << i }
             raise StopIteration unless resp.more_items?
           end
         end.lazy

data/lib/wavefront-sdk/search.rb

@@ -98,7 +98,7 @@ module Wavefront
       end
 
       path = [entity]
-      path.<< 'deleted' if deleted
+      path << 'deleted' if deleted
       api.post(path, body, 'application/json')
     end
 
@@ -119,8 +119,8 @@ module Wavefront
       raise ArgumentError unless entity.is_a?(String) && body.is_a?(Hash)
 
       path = [entity]
-      path.<< 'deleted' if deleted
-      path.<< facet || 'facets'
+      path << 'deleted' if deleted
+      path << (facet || 'facets')
       api.post(path, body, 'application/json')
     end
     # rubocop:enable Metrics/ParameterLists

data/lib/wavefront-sdk/spy.rb

@@ -32,6 +32,21 @@ module Wavefront
       api.get_stream('points', points_filter(sampling, filters), options)
     end
 
+    # GET /api/spy/deltas
+    # Gets new deltas that are added to existing time series.
+    # @param sampling [Float] see #points
+    # @param filter [Hash] see #points
+    # @param options [Hash] see #points
+    # @raise Wavefront::Exception::InvalidSamplingValue
+    # @return [Nil]
+    #
+    def deltas(sampling = 0.01, filters = {}, options = {})
+      wf_sampling_value?(sampling)
+      api.get_stream('deltas',
+                     deltas_filter(sampling, filters),
+                     options)
+    end
+
     # GET /api/spy/histograms
     # Gets new histograms that are added to existing time series.
     # @param sampling [Float] see #points
@@ -103,6 +118,13 @@ module Wavefront
         pointTagKey: filters.fetch(:tag_key, nil) }.compact
     end
 
+    def deltas_filter(sampling, filters)
+      { counter: filters.fetch(:prefix, nil),
+        host: filters.fetch(:host, nil),
+        sampling: sampling,
+        counterTagKey: filters.fetch(:tag_key, nil) }.compact
+    end
+
     def histograms_filter(sampling, filters)
       { histogram: filters.fetch(:prefix, nil),
         host: filters.fetch(:host, nil),

data/lib/wavefront-sdk/support/mixins.rb

@@ -23,7 +23,7 @@ module Wavefront
     # @raise Wavefront::InvalidTimestamp
     #
     def parse_time(time, in_ms = false)
-      return relative_time(time, in_ms) if time.to_s.match?(/^[\-+]/)
+      return relative_time(time, in_ms) if time.to_s.match?(/^[-+]/)
 
       ParseTime.new(time, in_ms).parse!
     end

data/lib/wavefront-sdk/support/parse_time.rb

@@ -55,7 +55,7 @@ module Wavefront
     end
 
     def parse!
-      method = ('parse_time_' + t.class.name.downcase).to_sym
+      method = "parse_time_#{t.class.name.downcase}".to_sym
       send(method)
     rescue StandardError
       raise Wavefront::Exception::InvalidTimestamp, t

data/lib/wavefront-sdk/user.rb

@@ -19,7 +19,7 @@ module Wavefront
 
     def deprecation_warning
       logger.log('Wavefront::User is deprecated and will be removed from the ' \
-               'next major release. Please use Wavefront::Account.', :warn)
+                 'next major release. Please use Wavefront::Account.', :warn)
     end
 
     def post_initialize(_creds, _opts)

data/lib/wavefront-sdk/validators.rb

@@ -81,7 +81,7 @@ module Wavefront
       # commas in tags and descriptions. This might be too restrictive,
       # but if it is, this is the only place we need to change it.
       #
-      if str.is_a?(String) && str.size < 1024 && str =~ /^[\-\w .,]*$/
+      if str.is_a?(String) && str.size < 1024 && str =~ /^[-\w .,]*$/
         return true
       end
 
@@ -256,7 +256,7 @@ module Wavefront
     #   dashboard ID is not valid
     #
     def wf_dashboard_id?(id)
-      return true if id.is_a?(String) && id.size < 256 && id.match(/^[\w\-]+$/)
+      return true if id.is_a?(String) && id.size < 256 && id.match(/^[\w-]+$/)
 
       raise Wavefront::Exception::InvalidDashboardId, id
     end
@@ -391,7 +391,7 @@ module Wavefront
     #   is not valid
     #
     def wf_source_id?(source)
-      if source.is_a?(String) && source.match(/^[\w.\-]+$/) &&
+      if source.is_a?(String) && source.match(/^[\w.-]+$/) &&
          source.size < 1024
         return true
       end
@@ -467,6 +467,9 @@ module Wavefront
       true
     end
 
+    # @
+    def wf_trace?(trace); end
+
     # Validate an array of distribution values
     # @param vals [Array[Array]] [count, value]
     # @return true if valid
@@ -639,6 +642,18 @@ module Wavefront
 
       raise Wavefront::Exception::InvalidAwsExternalId, id
     end
+
+    # Ensure the given argument is a valid Wavefront metrics policy ID
+    # @param id [String] the metrics policy ID to validate
+    # @return true if the role ID is valid
+    # @raise Wavefront::Exception::InvalidMetricsPolicyId if the ID is
+    #   not valid
+    #
+    def wf_metricspolicy_id?(id)
+      return true if uuid?(id)
+
+      raise Wavefront::Exception::InvalidMetricsPolicyId, id
+    end
   end
   # rubocop:enable Metrics/ModuleLength
 end

data/lib/wavefront-sdk/write.rb

@@ -39,7 +39,7 @@ module Wavefront
     #   verbose [Bool]
     #   debug [Bool]
     #   writer [Symbol, String] the name of the writer class to use.
-    #     Defaults to :socket
+    #     Defaults to :proxy
     #   noauto [Bool] if this is false, #write will automatically
     #     open a connection to Wavefront on each invocation. Set
     #     this to true to manually manage the connection.
@@ -62,7 +62,7 @@ module Wavefront
     #
     def defaults
       { tags: nil,
-        writer: :socket,
+        writer: :proxy,
         noop: false,
         novalidate: false,
         noauto: false,

data/lib/wavefront-sdk/writers/api.rb

@@ -24,7 +24,7 @@ module Wavefront
                 'credentials must contain API endpoint')
         end
 
-        return if creds.key?(:token) && creds[:token]
+        return true if creds.key?(:token) && creds[:token]
 
         raise(Wavefront::Exception::CredentialError,
               'credentials must contain API token')

data/lib/wavefront-sdk/writers/core.rb

@@ -112,7 +112,7 @@ module Wavefront
         ret = [points].flatten
         return ret unless prefix
 
-        ret.map { |pt| pt.tap { |p| p[:path] = prefix + '.' + p[:path] } }
+        ret.map { |pt| pt.tap { |p| p[:path] = "#{prefix}.#{p[:path]}" } }
       end
 
       # Filter invalid points out of an array of points

data/lib/wavefront-sdk/writers/proxy.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require_relative 'core'
+
+module Wavefront
+  module Writer
+    #
+    # Everything specific to writing points to a Wavefront proxy, in
+    # native Wavefront format, to a socket. (The original and,
+    # once, only way to send points.)
+    #
+    class Proxy < Core
+      # Open a connection to a socket to a Wavefront proxy, putting the
+      # descriptor in instance variable @conn.
+      # @return [TCPSocket]
+      #
+      def open
+        if opts[:noop]
+          logger.log('No-op requested. Not opening connection to proxy.')
+          return true
+        end
+
+        port = creds[:port] || default_port
+        logger.log("Connecting to #{creds[:proxy]}:#{port}.", :debug)
+        open_socket(creds[:proxy], port)
+      end
+
+      # Close the connection described by the @conn instance variable.
+      #
+      def close
+        return if opts[:noop]
+
+        logger.log('Closing connection to proxy.', :debug)
+        conn.close
+      end
+
+      def validate_credentials(creds)
+        return true if creds.key?(:proxy) && creds[:proxy]
+
+        raise(Wavefront::Exception::CredentialError,
+              'credentials must contain proxy address')
+      end
+
+      private
+
+      def open_socket(proxy, port)
+        @conn = TCPSocket.new(proxy, port)
+      rescue StandardError => e
+        logger.log(e, :error)
+        raise Wavefront::Exception::InvalidEndpoint
+      end
+
+      # @param point [String] point or points in native Wavefront format.
+      # @raise [SocketError] if point cannot be written
+      #
+      def _send_point(point)
+        return if opts[:noop]
+
+        conn.puts(point)
+      rescue StandardError
+        raise Wavefront::Exception::SocketError
+      end
+
+      # return [Integer] the port to connect to, if none is supplied
+      #
+      def default_port
+        2878
+      end
+    end
+  end
+end