appsignal 4.8.1-java → 4.8.3-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43b923f86f68b59e5398b10394ecbab0e020644aa52ac3d115f648c7600676a1
-  data.tar.gz: 8fff3cc2fe093c596164b50309bf88aa72ee84fb036310d542f43dc1bf5bd938
+  metadata.gz: cd64c501f9026dc4658364532b105f9a866c21533fd510bf2c0abea321c2d513
+  data.tar.gz: ff044b5dda35caaeeb9eb51789100937122db57a2d28f798c037b99b74367f01
 SHA512:
-  metadata.gz: faa0243f4174d6ace6df6e39585b5484917f5efa9453b352cc74d816c7d12084c13cc2e6052cd05247bdffa180110e542125a17c5aea8384a4a03da8cb8b927f
-  data.tar.gz: 9edbcb359dbfb4414ffbfd83b00d4c9dc3424aeab0a6f1bf0eb10eee5c0887b43a185b48fdea30e98e7ec1b11ac3aedc735e6bbab69ac387fe2173db4a740878
+  metadata.gz: c7d95a9271fd861afb88e398f9db80288870114d26a6719517a6a9f5654e40b0b6f332d3432e2cfebe29d061d1fb75247587ce7e36757da630f119e990c13171
+  data.tar.gz: 6c4c27891167d520cfa0d86f1ce6771fe8b9c3a24189ed4b05a43a124fd1be41667628182c08bd6baed443de81089c77197e31cf25b1193ffd07d2b8be46fd5c

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # 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._
+
+### Added
+
+- Log where `Appsignal.configure` is called. When a warning is emitted about `Appsignal.configure` being called from an application where `config/appsignal.yml` or `config/appsignal.rb` exist, log the location from which `Appsignal.configure` was called alongside the location of the configuration file. (patch [a9097107](https://github.com/appsignal/appsignal-ruby/commit/a90971075370bcf1d37f568d934dd8aeb71c1223))
+
+### Fixed
+
+- Fix the `bundle exec appsignal install` CLI command on Ruby 4 by removing the dependency on the `ostruct` gem, which is no longer part of the standard library. (patch [d3bd5198](https://github.com/appsignal/appsignal-ruby/commit/d3bd5198486a762353bfbd7807f4d042a85a9d3d))
+
 ## 4.8.1
 
 _Published on 2025-12-16._

data/build_matrix.yml

@@ -118,8 +118,7 @@ matrix:
       - "rails-8.1"
 
   ruby:
-    - ruby: "4.0.0-preview2"
-    - ruby: "3.5.0-preview1"
+    - ruby: "4.0.0"
     - ruby: "3.4.1"
     - ruby: "3.3.4"
     - ruby: "3.2.5"
@@ -145,8 +144,7 @@ matrix:
     - gem: "dry-monitor"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -156,7 +154,6 @@ matrix:
     - gem: "hanami-2.0"
       only:
         ruby:
-          - "3.5.0-preview1"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -165,7 +162,6 @@ matrix:
     - gem: "hanami-2.1"
       only:
         ruby:
-          - "3.5.0-preview1"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -174,7 +170,6 @@ matrix:
     - gem: "hanami-2.2"
       only:
         ruby:
-          - "3.5.0-preview1"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -184,12 +179,11 @@ matrix:
     - gem: "padrino"
       exclude:
         ruby:
-          - "4.0.0-preview2"
+          - "4.0.0"
     - gem: "psych-3"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -199,8 +193,7 @@ matrix:
     - gem: "psych-4"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -227,8 +220,7 @@ matrix:
     - gem: "rails-7.0"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -239,8 +231,7 @@ matrix:
     - gem: "rails-7.1"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -250,8 +241,7 @@ matrix:
     - gem: "rails-7.2"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -260,15 +250,13 @@ matrix:
     - gem: "rails-8.0"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
     - gem: "rails-8.1"
       only:
         ruby:
-          - "3.5.0-preview1"
           - "3.4.1"
           - "3.3.4"
           - "3.2.5"
@@ -280,12 +268,10 @@ matrix:
     - gem: "sidekiq-7"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"
     - gem: "sidekiq-8"
       only:
         ruby:
-          - "4.0.0-preview2"
-          - "3.5.0-preview1"
+          - "4.0.0"
           - "3.4.1"

data/lib/appsignal/cli/install.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "erb"
-require "ostruct"
 require "io/console"
 require "appsignal/demo"
 
@@ -366,7 +365,7 @@ module Appsignal
         def write_config_file(template_path, path, data)
           file_contents = File.read(template_path)
           template = ERB.new(file_contents, :trim_mode => "-")
-          config = template.result(OpenStruct.new(data).instance_eval { binding })
+          config = template.result_with_hash(data)
 
           FileUtils.mkdir_p(File.join(Dir.pwd, "config"))
           File.write(path, config)

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.1"
+  VERSION = "4.8.3"
 end

data/lib/appsignal.rb

@@ -184,12 +184,14 @@ module Appsignal
         if config
           # When calling `Appsignal.configure` from an app, not the
           # `config/appsignal.rb` file, with also a Ruby config file present.
+          caller_location = external_caller_location
           message = "The `Appsignal.configure` helper is called from within an " \
             "app while a `#{context.dsl_config_file}` file is present. " \
             "The `config/appsignal.rb` file is ignored when the " \
             "config is loaded with `Appsignal.configure` from within an app. " \
             "We recommend moving all config to the `config/appsignal.rb` file " \
             "or the `Appsignal.configure` helper in the app."
+          message += "\n  Called from: #{caller_location}" if caller_location
           Appsignal::Utils::StdoutAndLoggerMessage.warning(message)
         else
           # Load it when no config is present
@@ -340,6 +342,7 @@ module Appsignal
       # When calling `Appsignal.configure` from a Rails initializer and a YAML
       # file is present. We will not load the YAML file in the future.
       if !config_file_context? && config.yml_config_file?
+        caller_location = external_caller_location
         message = "The `Appsignal.configure` helper is called while a " \
           "`config/appsignal.yml` file is present. In future versions the " \
           "`config/appsignal.yml` file will be ignored when loading the " \
@@ -347,6 +350,7 @@ module Appsignal
           "`config/appsignal.rb` file, or the `Appsignal.configure` helper " \
           "in Rails initializer file, and remove the " \
           "`config/appsignal.yml` file."
+        message += "\n  Called from: #{caller_location}" if caller_location
         Appsignal::Utils::StdoutAndLoggerMessage.warning(message)
       end
 
@@ -616,6 +620,26 @@ module Appsignal
       end
       Appsignal::Environment.report_supported_gems
     end
+
+    # Returns a formatted string with the file and line number where
+    # Appsignal.configure was called from, excluding internal AppSignal frames.
+    #
+    # @return [String, nil] Formatted caller location or nil if not found
+    def external_caller_location
+      # Get the call stack, skipping this method itself
+      locations = caller_locations(1)
+      return unless locations
+
+      # Find the first location outside the AppSignal gem's lib directory
+      appsignal_lib_path = File.expand_path(__dir__)
+      external_location = locations.find do |location|
+        !location.path.start_with?(appsignal_lib_path)
+      end
+
+      return unless external_location
+
+      "#{external_location.path}:#{external_location.lineno}"
+    end
   end
 
   # @!visibility private

data/sig/appsignal.rbi

@@ -8,7 +8,7 @@
 module Appsignal
   extend Appsignal::Helpers::Metrics
   extend Appsignal::Helpers::Instrumentation
-  VERSION = T.let("4.8.1", 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.1
+  version: 4.8.3
 platform: java
 authors:
 - Robert Beekman