statscloud 1.0.9 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 00ef058f3553e52eec23bd98630e643ab43a323f67684681994263010249d202
-  data.tar.gz: f56e77cd1509110497f847e69cb0180890325a567a09415c1b0a8fc3f6d052e2
+  metadata.gz: 46395a60038b7f3886bc4e79275fe98156940690f73acee7ab8061a28164e82e
+  data.tar.gz: dc1d83819866769fb18f48f732f5e8db2ed2d2c732c2929d949cbdc1f21de96d
 SHA512:
-  metadata.gz: debc25c241c6b738f9638c04ea2fedad7ea4c8948978ef830acb4c28d141c7b50fc41e8046d07277072110adc7c6c35e44acf078dcd3b203b1750871fe06de77
-  data.tar.gz: e531513f320a1785c27cbaabfc7847b2ae91562c6a2d12bb60b11f979b74e81fd00a90e2d6438d5fedd5d44924b0acbc2504175e89c451c3334688d23294df88
+  metadata.gz: 016af1b77dd8c472abea59ec7737735581ae9e6b3ffdd7e9f1cd32bf6cc36d59ffd54219cd163a460fcbce5771433c333afb7847ebcc20ad11d518d420c80edd
+  data.tar.gz: 1c79fd2b558d124c645dc4c3f9e1f29082f2d83fd696ce5966a9c9e641d797f6f1a557cfac66c0c1a5518d20f8c44a4316fa68939d3fb58c61a1fba022bc8d1f

data/.gitlab-ci.yml

@@ -0,0 +1,8 @@
+image: ruby:2.3
+
+test:
+  script:
+  - apt-get update -qy
+  - bundle install
+  - bundle exec rspec
+  - rubocop

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    statscloud (1.0.9)
+    statscloud (1.1.0)
       crc32 (~> 1.0.1)
       eventmachine (~> 1.2)
       fileutils
@@ -13,6 +13,13 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    activesupport (5.2.2)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    ast (2.4.0)
+    concurrent-ruby (1.1.4)
     crc32 (1.0.1)
     diff-lcs (1.3)
     domain_name (0.5.20180417)
@@ -25,14 +32,23 @@ GEM
     httparty (0.16.3)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
+    i18n (1.2.0)
+      concurrent-ruby (~> 1.0)
+    jaro_winkler (1.5.1)
     json (2.1.0)
     leon (1.1.2)
     logger (1.3.0)
     mime-types (3.2.2)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2018.0812)
+    minitest (5.11.3)
     multi_xml (0.6.0)
     netrc (0.11.0)
+    parallel (1.12.1)
+    parser (2.5.3.0)
+      ast (~> 2.4.0)
+    powerpack (0.1.2)
+    rainbow (3.0.0)
     rake (10.5.0)
     rest-client (2.0.2)
       http-cookie (>= 1.0.2, < 2.0)
@@ -51,14 +67,27 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.8.0)
     rspec-support (3.8.0)
+    rubocop (0.61.1)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.5, != 2.5.1.1)
+      powerpack (~> 0.1)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (~> 1.4.0)
+    ruby-progressbar (1.10.0)
     statscloud.io-ruby-socket.io-client-simple (1.2.1.pre.3)
       event_emitter
       httparty
       json
       websocket-client-simple (~> 0.3.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
     unf (0.1.4)
       unf_ext
     unf_ext (0.0.7.5)
+    unicode-display_width (1.4.0)
     websocket (1.2.8)
     websocket-client-simple (0.3.0)
       event_emitter
@@ -68,9 +97,11 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
+  activesupport (~> 5.2.2)
   bundler (~> 1.16)
   rake (~> 10.0)
   rspec (~> 3.0)
+  rubocop (~> 0.61.1)
   statscloud!
 
 BUNDLED WITH

data/README.md

@@ -28,32 +28,38 @@ Or install it yourself as:
    
    StatsCloud auth token is a required parameter for getting access to StatsCloud service. The best way to configure this auth token in your application is using environment variable `STATSCLOUD_AUTH_TOKEN`. StatsCloud add-on at Heroku configures this environment variable automatically during adding this add-on to your application. If you want to use statscloud service in your development process (or somewhere else) you can [copy Heroku config vars to your local .env file](https://devcenter.heroku.com/articles/heroku-local).
 
-3. You can change `statscloud.rb` intializer file if you want to start StatsCloud service with a different environment or add some tags to your StatsmeterClient.
+3. You can change `statscloud.rb` intializer file if you want to start StatsCloud service with a different environment, create several instances of StatsCloud::Client with different configurations or add some tags to your StatsmeterClient.
     
     #### `with_environment('env')`
     This method allows you to record metrics from different environments (like `test`, `development`, `production`) separately, so
     ```ruby
-    StatsCloud.with_environment('production').start 
+    StatsCloud::Client.new.with_environment('production')
     ```
     would start StatsCloud service at `production` environment. Without this method, the environment would be chosen from the configuration file. If you don't configure it service would try to find env in the RAILS_ENV and if it is also missing it would set the value as the `default`.
     
     #### `with_tags(array[string])`
-    Also, you can start service with sending some tags to the cluster. Tags are used to group metrics. By default, the host name is used as a tag, which allows you to track metrics for both the application as a whole and for each host individually. In the cloud, an array of tags `['region', 'server_name']` can be used, which allows you to track metrics for the application as a whole, separate regions or separate servers.
+    You can start service with sending some tags to the cluster. Tags are used to group metrics. By default, the host name is used as a tag, which allows you to track metrics for both the application as a whole and for each host individually. In the cloud, an array of tags `['region', 'server_name']` can be used, which allows you to track metrics for the application as a whole, separate regions or separate servers.
     ```ruby
-    StatsCloud.with_tags(['region', 'server_name']).start
+    StatsCloud::Client.new.with_tags(['region', 'server_name'])
     ```
+    #### `with_config_file(file)`
+    Also, it's available to set up several StatsCloud clients with different configuration files via `with_config_file` method.
+    ```ruby
+    StatsCloud::Client.new.with_config_file('.production_statscloud.yml')
+    ```
+    
     You can combine these methods calling them as a chain.
      
-4. Use StatsCLoud.meter with `record_event` method for recording one event or `record_events` to send multiple events to cluster from any place of your application. 
+4. StatsCloud initializer defines `StatsCloudClient` constant which you can use to record metrics with `record_event` method for recording one event or `record_events` to send multiple events to cluster from any place of your application:
 
     ```ruby
-    StatsCloud.meter.record_event('event', 1)
-    StatsCloud.meter.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
+    StatsCloudClient.meter.record_event('event', 1)
+    StatsCloudClient.meter.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
     ```
-    Also, you can use these methods directly from StatsCloud module, starting with 1.0.6 version of the client.
+    Also, you can use these methods directly from StatsCloudClient:
     ```ruby
-    StatsCloud.record_event('event', 1)
-    StatsCloud.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
+    StatsCloudClient.record_event('event', 1)
+    StatsCloudClient.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
     ```
 ### Ruby
 1. Install `statscloud` gem:
@@ -64,28 +70,29 @@ Or install it yourself as:
  
 2. Require `statscloud` in the project and set up your application structure, with `.statscloud.yml` configuration file (at the root of the project) and metrics configs (read more about StatsCloud configuration [here](https://medium.com/@roman.kisilenko/software-application-monitoring-how-to-or-how-not-to-let-your-production-fail-9481dd0ef6de)).
 
-3. Customize statscloud run with `with_environment` and `with_tags` methods and start it where you need it.
+3. Customize statscloud run with `with_environment`, `with_tags` and `with_config_file` methods and start it where you need it.
 
     ```ruby
-    StatsCloud.with_environment('test').with_tags(['usa', 'server_1']).start
+    statscloud_client = StatsCloud::Client.new
+    statscloud_client.with_environment('test').with_tags(['usa', 'server_1']).start
     ```
-4. Send metrics via StatsCloud.meter or directly via StatsCloud module.
+4. Send metrics via statscloud_client.meter or directly via StatsCloud::Client instance:
     
     ```ruby
-    meter = StatsCloud.meter
+    meter = statscloud_client.meter
     meter.record_event('event', 1)
     meter.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
     
-    # also available
+    # also available and preferable
         
-    StatsCloud.record_event('some_event', 4)
-    StatsCloud.record_events({name: 'some_gauge', measurement: 321})
+    statscloud_client.record_event('some_event', 4)
+    statscloud_client.record_events({name: 'some_gauge', measurement: 321})
  
     ```
     
-5. Stop work of StatsCloud service when 'time is over'.
+5. Stop work of StatsCloud service when 'time is over':
     ```ruby
-    StatsCloud.stop
+    statscloud_client.stop
     ```
     
 The full version of pure ruby example takes the form:
@@ -93,14 +100,18 @@ The full version of pure ruby example takes the form:
 require 'statscloud' # import gem
 
 # start the module, returns a thread
-StatsCloud.start
+statscloud_client = StatsCloud::Client.new
+statscloud_client.start
 
+meter = statscloud_client.meter
 # track events (remember that you have to wait for the socket connection to the cluster before record any metrics)
-StatsCloud.meter.record_event('numeric', 123)
-StatsCloud.meter.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
+meter.record_event('numeric', 123)
+meter.record_events({name: 'gauge', measurement: 123}, {name: 'counter'})
+
+statscloud_client.record_event('some_event', 123)
 
-# stop the module
-StatsCloud.stop
+# stop cluster work
+statscloud_client.stop
 
 ```
 

data/lib/statscloud/cluster_client.rb

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
-require_relative "./helpers/parsed_response_helper"
-require_relative "./helpers/logger_helper"
 require "rest-client"
 
+require_relative "./helpers/logger_helper"
+require_relative "./helpers/parsed_response_helper"
+
 module StatsCloud
   # statscloud.io cluster-api service client.
   class ClusterClient
@@ -18,9 +19,9 @@ module StatsCloud
     #   cluster api host.
     #
     # @api public
-    def initialize(env, host = "https://cluster-api-v1.statscloud.statscloud.io")
+    def initialize(env, host)
       @environment = env
-      @host = host
+      @host = host || "https://cluster-api-v1.statscloud.statscloud.io"
     end
 
     # Schedules cluster instance to be retrieved.

data/lib/statscloud/helpers/assets_helper.rb

@@ -1,13 +1,15 @@
 # frozen_string_literal: true
 
+require "yaml"
+
 module StatsCloud
   # This helper works to gather and merge the configuration from files.
   module AssetsHelper
     private
 
     def asset_selector_matches(filename, asset_selector)
-      includes = asset_selector[:include]
-      excludes = asset_selector[:exclude]
+      includes = asset_selector["include"]
+      excludes = asset_selector["exclude"]
       process_match(includes, filename) && !process_match(excludes, filename)
     end
 
@@ -23,11 +25,11 @@ module StatsCloud
     end
 
     def get_checked_asset_selector(config)
-      asset_selector = config[:assetSelector] || {
-        include: ['.*\.statscloud.yml'], exclude: []
+      asset_selector = config["assetSelector"] || {
+        "include" => ['.*\.statscloud.yml'], "exclude" => []
       }
-      asset_selector[:include] = put_to_array_if_needed(asset_selector[:include])
-      asset_selector[:exclude] = put_to_array_if_needed(asset_selector[:exclude])
+      asset_selector["include"] = put_to_array_if_needed(asset_selector["include"])
+      asset_selector["exclude"] = put_to_array_if_needed(asset_selector["exclude"])
       asset_selector
     end
 
@@ -51,7 +53,7 @@ module StatsCloud
     end
 
     def process_match(list, filename)
-      list.reduce(false) do |match, pattern|
+      list&.reduce(false) do |match, pattern|
         match || Regexp.new(pattern).match(filename)
       end
     end
@@ -85,7 +87,7 @@ module StatsCloud
     end
 
     def put_to_array_if_needed(object)
-      object.is_a?(Array) ? object : [object]
+      object.is_a?(Array) ? object : [object].compact
     end
 
     def it_directory?(file_name, entry)

data/lib/statscloud/helpers/plugins_helper.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
-require_relative "../errors/client_error"
 require_relative "logger_helper"
+require_relative "../errors/client_error"
 
 module StatsCloud
   # This helper configures StatsCloud plugins.
   module PluginsHelper
+    private
+
     def build_plugins(plugins)
       plugins&.each do |plugin|
         plugin = plugin.is_a?(Hash) ? plugin : simple_plugin_config(plugin)
@@ -19,8 +21,6 @@ module StatsCloud
       end
     end
 
-    private
-
     def simple_plugin_config(plugin)
       {
         "name": plugin

data/lib/statscloud/helpers/socketio_helper.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "statscloud.io-ruby-socket.io-client-simple"
+
 require_relative "logger_helper"
 
 module StatsCloud

data/lib/statscloud/helpers/statscloud_helper.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require "leon"
+require "socket"
 require_relative "../errors/client_error"
 
 module StatsCloud
@@ -8,6 +8,26 @@ module StatsCloud
   module StatsCloudHelper
     private
 
+    def initialize_values
+      @config = {}
+      @source_mappings = { metrics: [], admins: [], dashboards: [], alerts: [] }
+      update_config_file(".statscloud.yml")
+    end
+
+    def generate_configuration(base_config)
+      if base_config
+        join_configs(@config, base_config, @source_mappings, "")
+      else
+        base_config = get_config_from_file(@config_file)
+        join_configs(@config, base_config, @source_mappings, @config_file)
+      end
+    end
+
+    def clear_data
+      @config.delete("propagateErrors")
+      @config.delete("token")
+    end
+
     def config_values
       @config["sourceMaps"] = source_mappings
       config_token
@@ -27,6 +47,10 @@ module StatsCloud
       @tags = tags
     end
 
+    def update_config_file(file)
+      @config_file = file
+    end
+
     def config_token
       @token = @config["token"] || ENV["STATSCLOUD_AUTH_TOKEN"]
     end
@@ -49,7 +73,7 @@ module StatsCloud
     def cluster_error_message
       return "Unable to get information about cluster." unless @cluster
 
-      @cluster[:status][:error]
+      @cluster["status"]["error"]
     end
 
     def app_name_missing_error_message
@@ -61,7 +85,7 @@ module StatsCloud
     end
 
     def successful_message
-      "statscloud.io support configured, dashboard URLs are \n #{(@cluster['grafanaDashboardsUrls'] || []).join("\n")}"
+      "statscloud.io support configured, dashboard URLs are \n#{(@cluster['grafanaDashboardsUrls'] || []).join("\n")}"
     end
 
     def statscloud_error(message)

data/lib/statscloud/helpers/statsmeter_helper.rb

@@ -34,6 +34,20 @@ module StatsCloud
       @event_name_size_in_bytes = 0
     end
 
+    def process_single_event(event)
+      name = get_event_name(event)
+      measurement = get_event_measurement(event)&.to_f
+
+      return unless @names_map && @names_map[name]
+
+      binary_length = get_binary_length(@event_name_size_in_bytes)
+      plain_length = get_plain_length(name, measurement)
+
+      flush_events if flush_condition(binary_length, plain_length)
+      record_binary_event(name, measurement, binary_length)
+      record_plain_event(name, measurement, plain_length)
+    end
+
     def record_binary_event(name, measurement, binary_length)
       @pending_binary_events.writeInt32LE(@names_map[name], @pending_binary_offset)
       @pending_binary_events = @pending_binary_events.slice(0, @pending_binary_offset + @event_name_size_in_bytes)

data/lib/statscloud/jobs/register_connection_job.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "eventmachine"
+
 require_relative "../helpers/logger_helper"
 
 module StatsCloud

data/lib/statscloud/statscloud_client.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require "yaml"
-require "json"
-require "eventmachine"
-require "singleton"
-require "socket"
 require_relative "version"
 require_relative "statsmeter_client"
 require_relative "cluster_client"
@@ -16,12 +11,20 @@ require_relative "jobs/register_connection_job"
 module StatsCloud
   # Module which implements StatsCloud framework support.
   class Client
-    include Singleton
     include StatsCloud::AssetsHelper
     include StatsCloud::LoggerHelper
     include StatsCloud::PluginsHelper
     include StatsCloud::StatsCloudHelper
 
+    # Creates new StatsCloud::Client instance with empty configuration.
+    #
+    # @return instance of StatsCloud::Client
+    #
+    # @api public
+    def initialize
+      initialize_values
+    end
+
     # Configures statsmeter.io support for application and initializes a statscloud.io client.
     #
     # @param [+String] env
@@ -34,19 +37,22 @@ module StatsCloud
     #
     # @api public
     def start(base_config = nil)
-      initialize_values
-      generate_configuration(base_config)
-      collect_statscloud_assets(@config, @source_mappings)
-      config_values
-      clear_data
+      process_configuration(base_config)
       configure_statscloud_plugins
       configure_cluster
       connect_to_cluster
+    rescue StandardError => error
+      log_error error
     end
 
     # Configures Statscloud environment.
     #
-    # @return StatsCloud::Client
+    # @param [+String+] env
+    #   Environment
+    #
+    # @return instance of StatsCloud::Client
+    #
+    # @api public
     def with_environment(env)
       config_environment(env)
       self
@@ -54,15 +60,33 @@ module StatsCloud
 
     # Configures Statscloud tags.
     #
-    # @return StatsCloud::Client
+    # @param [+Array+] tags
+    #   List of tags
+    #
+    # @return instance of StatsCloud::Client
+    #
+    # @api public
     def with_tags(tags)
       config_tags(tags)
       self
     end
 
+    # Allows to start several instances of StatsCloud::Client with different confifurations.
+    #
+    # @param [+String+] file
+    #   Main configuration file for StatsCloud::Client
+    #
+    # @return instance of StatsCloud::Client
+    #
+    # @api public
+    def with_config_file(file)
+      update_config_file(file)
+      self
+    end
+
     # Returns statscloud.io client aka Statsmeter client
     #
-    # @return [StatsCloud::StatsmeterClient]
+    # @return instance of StatsCloud::StatsmeterClient
     #
     # @api public
     def meter
@@ -77,6 +101,8 @@ module StatsCloud
     #   optional measurement, depending on metrics type.
     #
     # Calls statsmeter client record_event method.
+    #
+    # @api public
     def record_event(name, measurement = 0)
       @statsmeter_client&.record_event(name, measurement)
     end
@@ -87,6 +113,8 @@ module StatsCloud
     #   events to send (each should have name and optional measurement fields).
     #
     # Calls statsmeter record_events method.
+    #
+    # @api public
     def record_events(*events)
       @statsmeter_client&.record_events(*events)
     end
@@ -97,6 +125,8 @@ module StatsCloud
     #   array of events to send (each shoud have name and optional measurement fields).
     #
     # Calls statsmeter client record_events_array method.
+    #
+    # @api public
     def record_events_array(events)
       @statsmeter_client&.record_events_array(events)
     end
@@ -111,12 +141,14 @@ module StatsCloud
 
       cluster = @cluster_client.get_cluster(@token, @app)&.body
       check_cluster_status(cluster)
-      cluster[:status][:status] if cluster
+      cluster["status"]["status"] if cluster
+    rescue StandardError => error
+      log_error error
     end
 
     # Stops statscloud.io service.
     #
-    # @return [NilClass]
+    # @return nil
     #
     # @api public
     def stop
@@ -124,30 +156,19 @@ module StatsCloud
       @statsmeter_client = nil
       @cluster_client&.undeploy_cluster(@token, @app)
       @cluster_client = nil
+    rescue StandardError => error
+      log_error error
     end
 
     private
 
     attr_reader :config, :source_mappings, :statsmeter_client, :cluster, :token, :app, :graphite_url
 
-    def initialize_values
-      stop
-      @config = {}
-      @source_mappings = { metrics: [], admins: [], dashboards: [], alerts: [] }
-    end
-
-    def generate_configuration(base_config)
-      if base_config
-        join_configs(@config, base_config, @source_mappings, "")
-      else
-        base_config = get_config_from_file(File.join(__dir__, ".statscloud.yml"))
-        join_configs(@config, base_config, @source_mappings, ".statscloud.yml")
-      end
-    end
-
-    def clear_data
-      @config.delete("propagateErrors")
-      @config.delete("token")
+    def process_configuration(base_config)
+      generate_configuration(base_config)
+      collect_statscloud_assets(@config, @source_mappings)
+      config_values
+      clear_data
     end
 
     def configure_statscloud_plugins

data/lib/statscloud/statsmeter_client.rb

@@ -1,14 +1,13 @@
 # frozen_string_literal: true
 
+require "crc32"
+require "eventmachine"
+
 require_relative "helpers/socketio_helper"
 require_relative "helpers/statsmeter_helper"
 require_relative "helpers/logger_helper"
 require_relative "helpers/event_helper"
 require_relative "helpers/plugins_helper"
-require "leon"
-require "eventmachine"
-require "statscloud.io-ruby-socket.io-client-simple"
-require "crc32"
 
 module StatsCloud
   # Client for Statsmeter.
@@ -104,18 +103,10 @@ module StatsCloud
     # Save events in pending binary and plain arrays. Check flush condition.
     def record_events_array(events)
       events.each do |event|
-        name = get_event_name(event)
-        measurement = get_event_measurement(event)&.to_f
-
-        next unless @names_map && @names_map[name]
-
-        binary_length = get_binary_length(@event_name_size_in_bytes)
-        plain_length = get_plain_length(name, measurement)
-
-        flush_events if flush_condition(binary_length, plain_length)
-        record_binary_event(name, measurement, binary_length)
-        record_plain_event(name, measurement, plain_length)
+        process_single_event(event)
       end
+    rescue StandardError => error
+      log_error error
     end
 
     # Sends all pending events to statscloud.
@@ -140,8 +131,8 @@ module StatsCloud
     # Stops socket.io connection.
     def close
       stop_eventmachine
-      client.auto_reconnection = false
-      client.disconnect
+      client&.auto_reconnection = false
+      client&.disconnect
       set_client_to_nil
     end
 
@@ -176,7 +167,7 @@ module StatsCloud
     end
 
     def stop_eventmachine
-      eventmachine.stop_event_loop
+      eventmachine.stop_event_loop if eventmachine.reactor_running?
     end
 
     def crc32

data/lib/statscloud/version.rb

@@ -4,5 +4,5 @@ module StatsCloud
   # version of statscloud-ruby-client.
   #
   # Type: *String*
-  VERSION = "1.0.9"
+  VERSION = "1.1.0"
 end

data/lib/statscloud.rb

@@ -1,111 +1,4 @@
 # frozen_string_literal: true
 
 require "statscloud/statscloud_client"
-require "statscloud/helpers/logger_helper"
-
-# StatsCloud.io ruby client
-module StatsCloud
-  class << self
-    include LoggerHelper
-
-    # Configures statsmeter.io support for application and initializes a statscloud.io client.
-    #
-    # @param [+String+] env
-    #   statsmeter.io cluster environment
-    #
-    # @param [+Hash+] base_config
-    #   statsmeter.io configuration
-    #
-    # @return [Thread]
-    #
-    # @api public
-    def start(base_config = nil)
-      stats_cloud_instance.start(base_config)
-    rescue StandardError => error
-      log_error error
-    end
-
-    # Configures Statscloud environment.
-    #
-    # @return StatsCloud::Client
-    def with_environment(env)
-      stats_cloud_instance.with_environment(env)
-    rescue StandardError => error
-      log_error error
-    end
-
-    # Configures Statscloud tags.
-    #
-    # @return StatsCloud::Client
-    def with_tags(tags)
-      stats_cloud_instance.with_tags(tags)
-    rescue StandardError => error
-      log_error error
-    end
-
-    # Returns statscloud.io client aka Statsmeter client
-    #
-    # @return [StatsCloud::StatsmeterClient]
-    #
-    # @api public
-    def meter
-      stats_cloud_instance.meter
-    rescue StandardError => error
-      log_error error
-    end
-
-    # Records a single event.
-    #
-    # @param [+String+] name
-    #   name of the event to record.
-    # @param [+Integer+] measurement
-    #   optional measurement, depending on metrics type.
-    def record_event(name, measurement = 0)
-      stats_cloud_instance.record_event(name, measurement)
-    end
-
-    # Records several events at once.
-    #
-    # @param [+Array+] events
-    #   events to send (each should have name and optional measurement fields).
-    def record_events(*events)
-      stats_cloud_instance.record_events(*events)
-    end
-
-    # Records an array of events at once.
-    #
-    # @param [+Array+] events
-    #   array of events to send (each shoud have name and optional measurement fields).
-    def record_events_array(events)
-      stats_cloud_instance.record_events_array(events)
-    end
-
-    # Returns cluster status.
-    #
-    # @return [Hash]
-    #
-    # @api public
-    def cluster_status
-      stats_cloud_instance.cluster_status
-    rescue StandardError => error
-      log_error error
-    end
-
-    # Stops statscloud.io service.
-    #
-    # @return [NilClass]
-    #
-    # @api public
-    def stop
-      stats_cloud_instance.stop
-    rescue StandardError => error
-      log_error error
-    end
-
-    private
-
-    def stats_cloud_instance
-      StatsCloud::Client.instance
-    end
-  end
-end
+require "statscloud/version"

data/lib/templates/statscloud/statscloud_template.rb

@@ -1,4 +1,7 @@
 # frozen_string_literal: true
 
-StatsCloud.start
-at_exit { StatsCloud.stop }
+unless defined?(::Rails::Console)
+  ::StatsCloudClient = StatsCloud::Client.new
+  StatsCloudClient.start
+  at_exit { StatsCloudClient.stop }
+end

data/statscloud.gemspec

@@ -41,7 +41,9 @@ Gem::Specification.new do |spec|
   spec.add_dependency "rest-client", "~> 2.0.2"
   spec.add_dependency "statscloud.io-ruby-socket.io-client-simple", "~> 1.2.1.pre.3"
 
+  spec.add_development_dependency "activesupport", "~> 5.2.2"
   spec.add_development_dependency "bundler", "~> 1.16"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 0.61.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: statscloud
 version: !ruby/object:Gem::Version
-  version: 1.0.9
+  version: 1.1.0
 platform: ruby
 authors:
 - Roman Ovcharov
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-12-12 00:00:00.000000000 Z
+date: 2018-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: crc32
@@ -108,6 +108,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.2.1.pre.3
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.2.2
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -150,6 +164,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.61.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.61.1
 description: PaaS application monitoring system.
 email:
 - roman.o.as@agiliumlabs.com
@@ -158,6 +186,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".gitlab-ci.yml"
 - ".rspec"
 - ".rubocop.yml"
 - Gemfile