appsignal 4.8.2-java → 4.8.3-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d3b0a7b974307c3481bcec024d44f2e04bc388ebc7732401be0f1fc9b53b53a
-  data.tar.gz: a213da6461793f487e86633222afd41317a58278654f4231da4002abf1b4d45e
+  metadata.gz: cd64c501f9026dc4658364532b105f9a866c21533fd510bf2c0abea321c2d513
+  data.tar.gz: ff044b5dda35caaeeb9eb51789100937122db57a2d28f798c037b99b74367f01
 SHA512:
-  metadata.gz: d1f5e8b6334777942146ad8c48966d6a9ad2e2987596cfc21d140c30f54a5c0c150346a8f67b3537528bbc23b3d588f1bf43c35f0230ca83c74ba76dd2c0a14b
-  data.tar.gz: 10fafdc1f77f5eaf68cde39e598206e5fb8e0779b1046a40df6e76e6e894528f5f05a546da68aa4d42482aa0080fb43a20ba60e153287c2f2de4142944686a8b
+  metadata.gz: c7d95a9271fd861afb88e398f9db80288870114d26a6719517a6a9f5654e40b0b6f332d3432e2cfebe29d061d1fb75247587ce7e36757da630f119e990c13171
+  data.tar.gz: 6c4c27891167d520cfa0d86f1ce6771fe8b9c3a24189ed4b05a43a124fd1be41667628182c08bd6baed443de81089c77197e31cf25b1193ffd07d2b8be46fd5c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # AppSignal for Ruby gem Changelog
 
+## 4.8.3
+
+_Published on 2026-02-17._
+
+### Added
+
+- Add a `default_tags` configuration option. Tags set in this configuration option will be set for all transactions. (patch [3b9d9f48](https://github.com/appsignal/appsignal-ruby/commit/3b9d9f4844295d3c8f94fe750509f69f579cb372))
+
 ## 4.8.2
 
 _Published on 2026-02-05._

data/lib/appsignal/config.rb

@@ -132,7 +132,8 @@ module Appsignal
       :send_environment_metadata => true,
       :send_params => true,
       :send_session_data => true,
-      :sidekiq_report_errors => "all"
+      :sidekiq_report_errors => "all",
+      :default_tags => {}
     }.freeze
 
     # @!visibility private
@@ -221,6 +222,11 @@ module Appsignal
       :cpu_count => "APPSIGNAL_CPU_COUNT"
     }.freeze
 
+    # @!visibility private
+    HASH_OPTIONS = {
+      :default_tags => "APPSIGNAL_DEFAULT_TAGS"
+    }.freeze
+
     # @!visibility private
     attr_reader :root_path, :env, :config_hash
 
@@ -639,9 +645,34 @@ module Appsignal
         config[option] = env_var.to_f
       end
 
+      # Configuration with hash type
+      HASH_OPTIONS.each do |option, env_key|
+        env_var = ENV.fetch(env_key, nil)
+        next unless env_var
+
+        config[option] = parse_tags_from_env(env_var)
+      end
+
       config
     end
 
+    # Parse tags from environment variable string format "foo=bar,baz=quux"
+    # @param env_var [String] the environment variable value
+    # @return [Hash] parsed tags with string keys and values
+    # @api private
+    def parse_tags_from_env(env_var)
+      return {} if env_var.nil? || env_var.strip.empty?
+
+      env_var.split(",").each_with_object({}) do |pair, hash|
+        key, value = pair.split("=", 2)
+
+        # Skip malformed pairs (no key, no value, or missing "=")
+        next unless key && value && !key.strip.empty? && !value.strip.empty?
+
+        hash[key.strip] = value.strip
+      end
+    end
+
     # Set config options based on the final user config. Fix any conflicting
     # config.
     def determine_overrides
@@ -891,6 +922,24 @@ module Appsignal
         end
       end
 
+      # @!group Hash Configuration Options
+
+      # @!attribute [rw] default_tags
+      #   @return [Hash] Default tags to set on all transactions
+
+      # @!endgroup
+
+      # Custom getter for default_tags to ensure consistent format
+      def default_tags
+        fetch_option(:default_tags) || {}
+      end
+
+      # Custom setter for default_tags with validation
+      def default_tags=(value)
+        parsed_tags = parse_and_validate_tags(value)
+        update_option(:default_tags, parsed_tags)
+      end
+
       private
 
       def fetch_option(key)
@@ -904,6 +953,48 @@ module Appsignal
       def update_option(key, value)
         @dsl_options[key] = value
       end
+
+      # Parse tags from various input formats and validate values
+      # @param value [Hash, nil] input tags
+      # @return [Hash] validated tags with string keys
+      # @api private
+      def parse_and_validate_tags(value)
+        case value
+        when Hash
+          validate_tag_values(value)
+        when nil
+          {}
+        else
+          Appsignal.internal_logger.warn(
+            "Invalid value for 'default_tags' config option: #{value.class}. " \
+              "The 'default_tags' config option must be a Hash."
+          )
+          {}
+        end
+      end
+
+      # Validate tag values are allowed types, log errors for invalid types
+      # @param tags [Hash] tags to validate
+      # @return [Hash] tags with only valid values
+      # @api private
+      def validate_tag_values(tags)
+        tags.each_with_object({}) do |(key, value), valid_tags|
+          # Convert keys to strings for consistency
+          string_key = key.to_s
+
+          # Check if value is an allowed type
+          if [Symbol, String, Integer, TrueClass, FalseClass].any? { |type| value.is_a?(type) }
+            valid_tags[string_key] = value
+          else
+            Appsignal.internal_logger.warn(
+              "Ignored tag '#{string_key}' in 'default_tags' config option because of " \
+                "invalid value type: #{value.class}. " \
+                "Tags in the 'default_tags' config option must have values of type " \
+                "String, Symbol, Integer, or Boolean."
+            )
+          end
+        end
+      end
     end
   end
 end

data/lib/appsignal/transaction.rb

@@ -897,7 +897,18 @@ module Appsignal
     #
     # @see https://docs.appsignal.com/ruby/instrumentation/tagging.html
     def sanitized_tags
-      @tags.select do |key, value|
+      # Start with config default_tags as base (if config is available)
+      base_tags = if Appsignal.config
+                    Appsignal.config[:default_tags] || {}
+                  else
+                    {}
+                  end
+
+      # Merge transaction tags on top (transaction tags take priority)
+      all_tags = base_tags.merge(@tags)
+
+      # Apply existing sanitization filter
+      all_tags.select do |key, value|
         ALLOWED_TAG_KEY_TYPES.any? { |type| key.is_a? type } &&
           ALLOWED_TAG_VALUE_TYPES.any? { |type| value.is_a? type }
       end

data/lib/appsignal/version.rb

@@ -2,5 +2,5 @@
 
 module Appsignal
   # @return [String]
-  VERSION = "4.8.2"
+  VERSION = "4.8.3"
 end

data/sig/appsignal.rbi

@@ -8,7 +8,7 @@
 module Appsignal
   extend Appsignal::Helpers::Metrics
   extend Appsignal::Helpers::Instrumentation
-  VERSION = T.let("4.8.2", T.untyped)
+  VERSION = T.let("4.8.3", T.untyped)
 
   class << self
     # The loaded AppSignal configuration.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: appsignal
 version: !ruby/object:Gem::Version
-  version: 4.8.2
+  version: 4.8.3
 platform: java
 authors:
 - Robert Beekman