cloudwatch-metrics 1.1.2 → 1.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c05a115e1d85721a94703a582811740101ded81e2eaab2bbbbf6812a28d5d02e
-  data.tar.gz: 9cc9c8113894d10d20592206c4c0131e281e3b8973be026f3d9c7d907dca6b98
+  metadata.gz: 7a695784586836327fc97343e6d10959f915f3dc21f30fa50b734c5b4051075c
+  data.tar.gz: 372ea580850057678c327936ade66bb35904353cd52aee416d6b6fca304e3b60
 SHA512:
-  metadata.gz: c3d062eff18b802d34fb9b1126d52297832d339beac6dfc0db6af23ebe131c0c11b28281140e9bd8f631943ad625ce7f1160409d8c2aad36c8941abcaa0e79cd
-  data.tar.gz: 600219d188edd77b5969fbfafe3633ed888abba04afc40edb43e99f06189b5b1cdf155c5056ebdf5ffcfd99126e2f4f5571ab05cefefdd76b4932fa117f2848d
+  metadata.gz: b2ae2faa48dd04d4773760a31ea7d274bd5837cb55472a2101728316bea718e4d2cc4eb54ea4355a61a99a6f35fa1829ee4e2be7afc2c0dd8a6ecf061d067926
+  data.tar.gz: 429579c99ee8f7068dd35aa3000ac9ab6dee585c7c7004ca40b92d0faaf63afca336287f57a510034f0d6dd6efa255226942b204de4813f02eaff6282226f0a7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cloudwatch-metrics (1.1.2)
+    cloudwatch-metrics (1.1.3)
       activesupport (~> 7.0)
       aws-sdk-cloudwatch (~> 1.73)
       rake (~> 13.0)
@@ -16,16 +16,16 @@ GEM
       tzinfo (~> 2.0)
     ast (2.4.2)
     aws-eventstream (1.2.0)
-    aws-partitions (1.781.0)
-    aws-sdk-cloudwatch (1.75.0)
-      aws-sdk-core (~> 3, >= 3.174.0)
+    aws-partitions (1.788.0)
+    aws-sdk-cloudwatch (1.78.0)
+      aws-sdk-core (~> 3, >= 3.177.0)
       aws-sigv4 (~> 1.1)
-    aws-sdk-core (3.175.0)
+    aws-sdk-core (3.178.0)
       aws-eventstream (~> 1, >= 1.0.2)
       aws-partitions (~> 1, >= 1.651.0)
       aws-sigv4 (~> 1.5)
       jmespath (~> 1, >= 1.6.1)
-    aws-sigv4 (1.5.2)
+    aws-sigv4 (1.6.0)
       aws-eventstream (~> 1, >= 1.0.2)
     concurrent-ruby (1.2.2)
     debug (1.8.0)

data/README.md

@@ -1,3 +1,7 @@
+# DEPRECATED
+
+We no longer write metrics to Cloudwatch. Write to Datadog instead.
+
 # CloudwatchMetrics
 
 `CloudwatchMetrics` is a Ruby gem for writing custom metrics to AWS Cloudwatch.
@@ -19,46 +23,11 @@ To create the initializer:
 rails generate cloudwatch_metrics:initializer
 ```
 
-The initializer contains descriptions for all available options. The only options you must provide a value for are listed below:
-
-* **namespace**: This is the default namespace that all metrics will be published to. This should probably match the name of your application or service.
+The initializer contains descriptions for all available options. More detailed descriptions are available in the user guide, linked below. The only option you must provide a value for is `namespace`.
 
 ## Usage
 
-Available methods are in the `CloudwatchMetrics` module. For convenience this is aliased to `CW` by default. I.e `CloudwatchMetrics.record(...)` is equivalent to `CW.record(...)`.
-
-Metrics are recorded using `CW.record` for single data points, or `CW.record_all` for collections of data points. Required and optional parameters for these methods are detailed below.
-
-### CW.record Required Parameters
-
-* `name`: The name of the metric.
-* `value`: The value for the single data point being recorded.
-
-E.g. `CW.record(name: 'search_result_count', value: 25)`
-
-
-`CW.record_all` has a similar method signature, but takes an array of values, and a corresponding array indicating how many times each value occurred during the period.
-
-### CW.record_all Required Parameters
-
-* `name`: The name of the metric.
-* `values`: Array of values for the data points being recorded.
-* `counts`: Array of numbers indicating the number of times each value occurred during the period. The length of this array should match the length of the `values` array.
-
-E.g. `CW.record_all(name: 'search_result_count', values: [25, 50, 65], counts: [1, 2, 1])`
-
-This means that for the `search_result_count` metric we had one search with 25 results, two searches with 50 results, and one search with 65 results.
-
-### Optional Parameters
-
-Both recording methods accept optional parameters, which are detailed below, along with their default values
-
-* `unit`: The unit of measure for this data point. Units help provide conceptual meaning to your data, but CloudWatch attaches no significance to a unit internally. Common values are `Seconds`, `Kilobytes`, `Percent`, `Count`, `Kilobytes/Second`. Default value is `None`. A full list of available units is available at `CloudwatchMetrics::Units`.
-* `namespace`: Override the namespace set in the initializer. Default is `nil`.
-* `dimensions`: A hash of name/value pairs that form part of the identity of a metric. Dimensions allow you to group and filter data points for a particular metric. Default is `nil`.
-* `timestamp`: The time associated with the data point. The timestamp can be up to two weeks in the past and up to two hours into the future. Default is the current time.
-
-E.g. `CW.record(name: 'search_result_count', value: 25, unit: CW::COUNT, namespace: 'custom_namespace', dimensions: { group: 'A', subgroup: 'B' }, timestamp: Time.current - 1.day)`
+See [How To: Publish Custom Metrics to CloudWatch](https://www.notion.so/pathccm/How-To-Publish-Custom-Metrics-to-CloudWatch-821be6ddec404b3b827c146a2f5de792#74c9ec588d5841f5bad58b59853054b9) for the user guide.
 
 ### Local development
 
@@ -82,11 +51,14 @@ region = us-west-2
 output = json
 ```
 
-## Cloudwatch Concepts
+## Changing this gem
 
-Refer to the [Cloudwatch Documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) for a general overview of custom metrics in CloudWatch.
+### Development
 
-## Changing this gem
+Run `bundle install` to update gemlock file
+Run `rake` to run tests
+
+### Deploy new gem
 
 If you make changes to this gem you need to do a few things to make those updates available to clients.
 

data/lib/cloudwatch_metrics/configuration.rb

@@ -18,7 +18,7 @@ module CloudwatchMetrics
     end
 
     def non_production_prefix
-      @non_production_prefix ||= 'test-'
+      @non_production_prefix ||= 'test/'
     end
   end
 end

data/lib/cloudwatch_metrics/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CloudwatchMetrics
-  VERSION = '1.1.2'
+  VERSION = '1.1.4'
 end

data/lib/cloudwatch_metrics.rb

@@ -9,6 +9,8 @@ require_relative 'cloudwatch_metrics/constants'
 
 # Posts custom metrics to AWS CloudWatch
 module CloudwatchMetrics
+  extend Gem::Deprecate
+
   class Error < StandardError; end
 
   class << self
@@ -48,6 +50,7 @@ module CloudwatchMetrics
     rescue StandardError => e
       handle_error(e)
     end
+    deprecate :record, :none, 2025, 1
 
     def record_all(
       name:, values:, counts:, unit: nil, namespace: nil, dimensions: nil, timestamp: nil
@@ -64,6 +67,7 @@ module CloudwatchMetrics
     rescue StandardError => e
       handle_error(e)
     end
+    deprecate :record_all, :none, 2025, 1
 
     private
 

data/lib/generators/cloudwatch_metrics/templates/cloudwatch_metrics.rb

@@ -35,8 +35,8 @@ CloudwatchMetrics.configure do |config|
 
   # This is an optional configuration to set the namespace prefix for non-production
   # environments. This is useful if you want to avoid polluting your production
-  # metrics with test data. If empty or nil no prefix will be applied. Defaults to 'test-'.
-  # config.non_production_prefix = 'test-'
+  # metrics with test data. If empty or nil no prefix will be applied. Defaults to 'test/'.
+  # config.non_production_prefix = 'test/'
 
   # This is an optional configuration to set an error handler proc.
   # If not set the default error handler will log the error

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cloudwatch-metrics
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.4
 platform: ruby
 authors:
 - Seth Puckett
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-21 00:00:00.000000000 Z
+date: 2024-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -100,5 +100,5 @@ requirements: []
 rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
-summary: Ruby gem for pushing custom metrics to Cloudwatch
+summary: "[Deprecated] Ruby gem for pushing custom metrics to Cloudwatch"
 test_files: []