Prerelease 9.14.0-pre

CHANGELOG.md

@@ -1,8 +1,8 @@
 # New Relic Ruby Agent Release Notes
 
-## dev
+## v9.14.0
 
-Version <dev> adds Apache Kafka instrumentation for the rdkafka and ruby-kafka gems, introduces a configuration-based, automatic way to add custom instrumentation method tracers, correctly captures MIME type for AcionDispatch 7.0+ requests, properly handles Boolean coercion for `newrelic.yml` configuration, fixes a JRuby bug in the configuration manager, and fixes a bug related to `Bundler.rubygems.installed_specs`.
+Version 9.14.0 adds Apache Kafka instrumentation for the rdkafka and ruby-kafka gems, introduces a configuration-based, automatic way to add custom instrumentation method tracers, correctly captures MIME type for AcionDispatch 7.0+ requests, properly handles Boolean coercion for `newrelic.yml` configuration, fixes a JRuby bug in the configuration manager, and fixes a bug related to `Bundler.rubygems.installed_specs`.
 
 - **Feature: Add Apache Kafka instrumentation for the rdkafka and ruby-kafka gems**
 

lib/new_relic/version.rb

@@ -6,7 +6,7 @@
 module NewRelic
   module VERSION # :nodoc:
     MAJOR = 9
-    MINOR = 13
+    MINOR = 14
     TINY = 0
 
     STRING = "#{MAJOR}.#{MINOR}.#{TINY}"

newrelic.yml

@@ -113,6 +113,53 @@ common: &default_settings
   # Specifies a path to the audit log file (including the filename).
   # audit_log.path: log/newrelic_audit.log
 
+  # An array of CLASS#METHOD (for instance methods) and/or CLASS.METHOD (for class
+  # methods) strings representing Ruby methods for the agent to automatically add
+  # custom instrumentation to without the need for altering any of the source code
+  # that defines the methods.
+  #
+  # Use fully qualified class names (using the :: delimiter) that include any
+  # module or class namespacing.
+  #
+  # Here is some Ruby source code that defines a render_png instance method for an
+  # Image class and a notify class method for a User class, both within a
+  # MyCompany module namespace:
+  # 
+  # module MyCompany
+  #   class Image
+  #     def render_png
+  #       # code to render a PNG
+  #     end
+  #   end
+  #
+  #   class User
+  #     def self.notify
+  #       # code to notify users
+  #     end
+  #   end
+  # end
+  # 
+  # Given that source code, the newrelic.yml config file might request
+  # instrumentation for both of these methods like so:
+  # 
+  # automatic_custom_instrumentation_method_list:
+  # - MyCompany::Image#render_png
+  # - MyCompany::User.notify
+  #
+  # That configuration example uses YAML array syntax to specify both methods.
+  # Alternatively, a comma-delimited string can be used instead:
+  # 
+  # automatic_custom_instrumentation_method_list: 'MyCompany::Image#render_png, MyCompany::User.notify'
+  # 
+  # Whitespace around the comma(s) in the list is optional. When configuring the
+  # agent with a list of methods via the
+  # NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST environment variable,
+  # this comma-delimited string format should be used:
+  # 
+  # export NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST='MyCompany::Image#render_png, MyCompany::User.notify'
+  # 
+  # automatic_custom_instrumentation_method_list: []
+
   # Specify a list of constants that should prevent the agent from starting
   # automatically. Separate individual constants with a comma ,. For example,
   # "Rails::Console,UninstrumentedBackgroundJob".
@@ -535,6 +582,10 @@ common: &default_settings
   # prepend, chain, disabled.
   # instrumentation.rake: auto
 
+  # Controls auto-instrumentation of the rdkafka library at start-up. May be one
+  # of auto, prepend, chain, disabled.
+  # instrumentation.rdkafka: auto
+
   # Controls auto-instrumentation of Redis at start-up. May be one of: auto,
   # prepend, chain, disabled.
   # instrumentation.redis: auto
@@ -547,6 +598,10 @@ common: &default_settings
   # prepend, chain, disabled.
   # instrumentation.roda: auto
 
+  # Controls auto-instrumentation of the ruby-kafka library at start-up. May be
+  # one of auto, prepend, chain, disabled.
+  # instrumentation.ruby_kafka: auto
+
   # Controls auto-instrumentation of the ruby-openai gem at start-up. May be one
   # of: auto, prepend, chain, disabled. Defaults to disabled in high security
   # mode.