appsignal 4.0.3-java → 4.0.5-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ea322f2119a448a34c283e7a5cac3000f0e9acfec8f5d1a406265eb42f859d6
-  data.tar.gz: 1ab95f249d94eedba7e86e36d3f74d217bd57deed236e6b352b190dc34007eb5
+  metadata.gz: 265860dc1cb9e7ef2035d4dcc288d6789d14b6d656c6812ab26f69fc6e3d9e2e
+  data.tar.gz: 702e3e82530b79db9d8b26519d14cb9664d728a12f3d6c5999b63bfbda022fd1
 SHA512:
-  metadata.gz: e4d10c4f4684675cf908972044fb11be5eafd1041fb6b80d684580285ab9681a746e5fc36fbc79e84816766a33c507a233b22df7ee911b1cc9253abfa14a2a46
-  data.tar.gz: d25b331756ceafe336d5b430577fb98da0696f5f92613a47d89f30007b910a4057cf981ddb1d841d295cfdb31f48d69bb8fecb1e7071d933dba47b1160d701bf
+  metadata.gz: 8e5589a001f66450dd0c2f7250134be2813bcab36a9c4576886cc3997206109e8e6ae53fbd60fb8924ffa9e34bddd225617a92dfec6b442e6565bc2ea3433d53
+  data.tar.gz: bf73768bfbbc2db0c042cb84ddc185362707f7b0b622d0565ce7a5142ddd0479daea6e76d7d87d9b7542ff01929b7a24cf566ca9036e3bd66a5fb0f2de1e622a

data/CHANGELOG.md

@@ -1,5 +1,56 @@
 # AppSignal for Ruby gem Changelog
 
+## 4.0.5
+
+_Published on 2024-09-02._
+
+### Added
+
+- Report Puma low-level errors using the `lowlevel_error` reporter. This will report errors previously not caught by our instrumentation middleware. (patch [70cc21f4](https://github.com/appsignal/appsignal-ruby/commit/70cc21f49e19faa9fd2d12a051620cd48e036dcb))
+
+### Changed
+
+- Log a warning when loader defaults are added after AppSignal has already been configured.
+
+  ```ruby
+  # Bad
+  Appsignal.configure # or Appsignal.start
+  Appsignal.load(:sinatra)
+
+  # Good
+  Appsignal.load(:sinatra)
+  Appsignal.configure # or Appsignal.start
+  ```
+
+  (patch [0997dd9c](https://github.com/appsignal/appsignal-ruby/commit/0997dd9c0430123a697b8100785f5676163e20ef))
+- Rename the `path` and `method` transaction metadata to `request_path` and `request_method` to make it more clear what context this metadata is from. The `path` and `method` metadata will continue to be reported until the next major/minor version. (patch [fa314b5f](https://github.com/appsignal/appsignal-ruby/commit/fa314b5fb6fdfbf3e9746df377b0145cde0cfa36))
+- Internal change to how OpenTelemetry metrics are sent. (patch [e66d1d70](https://github.com/appsignal/appsignal-ruby/commit/e66d1d702d5010cb5b8084ba790b24d9e70a9e08))
+
+### Removed
+
+- Drop support for Puma version 2 and lower. (patch [4fab861c](https://github.com/appsignal/appsignal-ruby/commit/4fab861cae74b08aa71bf64e1b134ae4b1df1dff))
+
+### Fixed
+
+- Fix the error log message about our `at_exit` hook reporting no error on process exit when the process exits without an error. (patch [b71f3966](https://github.com/appsignal/appsignal-ruby/commit/b71f39661e9b05c10fa78b821ba0e45bde0c941b))
+
+## 4.0.4
+
+_Published on 2024-08-29._
+
+### Changed
+
+- Send check-ins concurrently. When calling `Appsignal::CheckIn.cron`, instead of blocking the current thread while the check-in events are sent, schedule them to be sent in a separate thread.
+
+  When shutting down your application manually, call `Appsignal.stop` to block until all scheduled check-ins have been sent.
+
+  (patch [46d4ca74](https://github.com/appsignal/appsignal-ruby/commit/46d4ca74f4c188cc011653ed23969ad7ec770812))
+
+### Fixed
+
+- Make our Rack BodyWrapper behave like a Rack BodyProxy. If a method doesn't exist on our BodyWrapper class, but it does exist on the body, behave like the Rack BodyProxy and call the method on the wrapped body. (patch [e2376305](https://github.com/appsignal/appsignal-ruby/commit/e23763058a3fb980f1054e9c1eaf7e0f25f75666))
+- Do not report `SignalException` errors from our `at_exit` error reporter. (patch [3ba3ce31](https://github.com/appsignal/appsignal-ruby/commit/3ba3ce31ee3f3e84665c9f2f18d488c689cff6c2))
+
 ## 4.0.3
 
 _Published on 2024-08-26._

data/ext/agent.rb

@@ -6,7 +6,7 @@
 # Modifications to this file will be overwritten with the next agent release.
 
 APPSIGNAL_AGENT_CONFIG = {
-  "version" => "0.35.21",
+  "version" => "0.35.22",
   "mirrors" => [
     "https://appsignal-agent-releases.global.ssl.fastly.net",
     "https://d135dj0rjqvssy.cloudfront.net"
@@ -14,131 +14,131 @@ APPSIGNAL_AGENT_CONFIG = {
   "triples" => {
     "x86_64-darwin" => {
       "static" => {
-        "checksum" => "0e7b5bc5bf1e9903276b9fbe105af1128011613f9dc7ac7cedd4d230d92011bd",
+        "checksum" => "024cef88b24032d7187488c00682f92095da406d80ae642ac858e6318b840ad6",
         "filename" => "appsignal-x86_64-darwin-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "56cc9aed70014b4fda2b30ff34819370cab2eb2bda588f59d7d86816d60a458f",
+        "checksum" => "ddddf86a951fe57f50e351a449df65d2c6428d703581b8ef5922fad23a688f1d",
         "filename" => "appsignal-x86_64-darwin-all-dynamic.tar.gz"
       }
     },
     "universal-darwin" => {
       "static" => {
-        "checksum" => "0e7b5bc5bf1e9903276b9fbe105af1128011613f9dc7ac7cedd4d230d92011bd",
+        "checksum" => "024cef88b24032d7187488c00682f92095da406d80ae642ac858e6318b840ad6",
         "filename" => "appsignal-x86_64-darwin-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "56cc9aed70014b4fda2b30ff34819370cab2eb2bda588f59d7d86816d60a458f",
+        "checksum" => "ddddf86a951fe57f50e351a449df65d2c6428d703581b8ef5922fad23a688f1d",
         "filename" => "appsignal-x86_64-darwin-all-dynamic.tar.gz"
       }
     },
     "aarch64-darwin" => {
       "static" => {
-        "checksum" => "423178f0178f15d7f663451e45a318ca92d8f7cca136b5e985e753520b4ad3e4",
+        "checksum" => "b8dfebd77322a1f66e0f0acf1717c2583189016e9749286f61956a3ebbc1a16a",
         "filename" => "appsignal-aarch64-darwin-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "c2c0aeba5ddb38584c8b1cc8b2ad2407431c71b944cd4dee47d45828b93619ae",
+        "checksum" => "d94ae45a9fa69566a30aaacf9f65bdf21b5d0d2a5990e4ba8f98dedc5956f62f",
         "filename" => "appsignal-aarch64-darwin-all-dynamic.tar.gz"
       }
     },
     "arm64-darwin" => {
       "static" => {
-        "checksum" => "423178f0178f15d7f663451e45a318ca92d8f7cca136b5e985e753520b4ad3e4",
+        "checksum" => "b8dfebd77322a1f66e0f0acf1717c2583189016e9749286f61956a3ebbc1a16a",
         "filename" => "appsignal-aarch64-darwin-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "c2c0aeba5ddb38584c8b1cc8b2ad2407431c71b944cd4dee47d45828b93619ae",
+        "checksum" => "d94ae45a9fa69566a30aaacf9f65bdf21b5d0d2a5990e4ba8f98dedc5956f62f",
         "filename" => "appsignal-aarch64-darwin-all-dynamic.tar.gz"
       }
     },
     "arm-darwin" => {
       "static" => {
-        "checksum" => "423178f0178f15d7f663451e45a318ca92d8f7cca136b5e985e753520b4ad3e4",
+        "checksum" => "b8dfebd77322a1f66e0f0acf1717c2583189016e9749286f61956a3ebbc1a16a",
         "filename" => "appsignal-aarch64-darwin-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "c2c0aeba5ddb38584c8b1cc8b2ad2407431c71b944cd4dee47d45828b93619ae",
+        "checksum" => "d94ae45a9fa69566a30aaacf9f65bdf21b5d0d2a5990e4ba8f98dedc5956f62f",
         "filename" => "appsignal-aarch64-darwin-all-dynamic.tar.gz"
       }
     },
     "aarch64-linux" => {
       "static" => {
-        "checksum" => "bf94592c9640f89d0321acd5a0a9bd6951154c37f97f4778ddc2fc536203dc4f",
+        "checksum" => "1f21e14f31b9b91f5ce3da0dcb91224bc9f4a0d834ada75e87f396ca9838cf59",
         "filename" => "appsignal-aarch64-linux-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "8f8e60daae9ac10bae66fcf9ea33984046b5c92d911eae71ac1a8bdbaa7fa3eb",
+        "checksum" => "cf81cabcd216cf41d55ad2ad50f5eccfc1b3edc0dc78159973f3c0687f5ad86d",
         "filename" => "appsignal-aarch64-linux-all-dynamic.tar.gz"
       }
     },
     "i686-linux" => {
       "static" => {
-        "checksum" => "1553674c377a3e6fa56e31754d2af175e734531a44a76c680ff14cc49d4f0031",
+        "checksum" => "6111532d1958f9bbbdbea9104c509636d7b6d311090c609a0c134b68e6ef0dd6",
         "filename" => "appsignal-i686-linux-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "93e53b3cb2e2fb89cc3dff690da910fccb46503c3d58e4d3fb1a525fb222eea7",
+        "checksum" => "705fd88f0e2a4370766f64c93d123476d37f169190550cc3a2c85d34ce1b1893",
         "filename" => "appsignal-i686-linux-all-dynamic.tar.gz"
       }
     },
     "x86-linux" => {
       "static" => {
-        "checksum" => "1553674c377a3e6fa56e31754d2af175e734531a44a76c680ff14cc49d4f0031",
+        "checksum" => "6111532d1958f9bbbdbea9104c509636d7b6d311090c609a0c134b68e6ef0dd6",
         "filename" => "appsignal-i686-linux-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "93e53b3cb2e2fb89cc3dff690da910fccb46503c3d58e4d3fb1a525fb222eea7",
+        "checksum" => "705fd88f0e2a4370766f64c93d123476d37f169190550cc3a2c85d34ce1b1893",
         "filename" => "appsignal-i686-linux-all-dynamic.tar.gz"
       }
     },
     "x86_64-linux" => {
       "static" => {
-        "checksum" => "497d280dff46f7e72875af69f7b3756f3925bcad9e1922f030f818c8c5fa5d67",
+        "checksum" => "9e325faf63b7fe9b9804b4e8ce4bac7deefa6c47aec47faf47d90133d44dbaa5",
         "filename" => "appsignal-x86_64-linux-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "1b230cc3e80ef4013defc9d6e80713d1d318ed7f673121433d864b47e239ff73",
+        "checksum" => "11bac70bee7e620b31a26a01093a0c9ef01f7eb7508ac0c0a0eae27973cc643f",
         "filename" => "appsignal-x86_64-linux-all-dynamic.tar.gz"
       }
     },
     "x86_64-linux-musl" => {
       "static" => {
-        "checksum" => "2bcbc6b57a0298a97e6549e025ec092f8b3bd2b4e8f430fe7b040f7a2e274527",
+        "checksum" => "a76de00904eb40a61a7e68082cb06379aa13f61ec0d25ead828fd2ba022f9be9",
         "filename" => "appsignal-x86_64-linux-musl-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "7e89c78e9375d55b035f0e75e13d8dd278c2ddf4618fbe005c26f13d249b303f",
+        "checksum" => "b7b34ed9243059259a5fa10daa65adb6c4748e8b9715f64e6e559f88aa7aec03",
         "filename" => "appsignal-x86_64-linux-musl-all-dynamic.tar.gz"
       }
     },
     "aarch64-linux-musl" => {
       "static" => {
-        "checksum" => "f9bfd06e0107f3a491ff6009a1e8c0d6d2598c128e8ee84bd852a2f8d3e8e16b",
+        "checksum" => "2e197b99b7052357e466a7d93450d87cbdc07d0e5749630e98adcf7c7fad8936",
         "filename" => "appsignal-aarch64-linux-musl-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "187a9a8e58617a0f78077b412dee18351cc975af41500443d7450fc44f2f65d3",
+        "checksum" => "ace9ab040e4c412f9d6c0b7d2209388e81f40882f8719a67cc30c60e0bdc50ed",
         "filename" => "appsignal-aarch64-linux-musl-all-dynamic.tar.gz"
       }
     },
     "x86_64-freebsd" => {
       "static" => {
-        "checksum" => "cf8043c78e0e628cf0747dd57327d6c0ffd4147d3bff7b2426110fd2fada0960",
+        "checksum" => "0c263f693ba5c06373b9fb4062f14d2b6bf1ff33bc0d737abcccc77bab66a634",
         "filename" => "appsignal-x86_64-freebsd-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "072c2312aadf961c3f851552ee255db77f0c4050e47d438dd9f82e536b68bcd6",
+        "checksum" => "7545a50f4d127da466e87d9504df4911ed9f8b0ec67b86023e08f8a58ea2b8c2",
         "filename" => "appsignal-x86_64-freebsd-all-dynamic.tar.gz"
       }
     },
     "amd64-freebsd" => {
       "static" => {
-        "checksum" => "cf8043c78e0e628cf0747dd57327d6c0ffd4147d3bff7b2426110fd2fada0960",
+        "checksum" => "0c263f693ba5c06373b9fb4062f14d2b6bf1ff33bc0d737abcccc77bab66a634",
         "filename" => "appsignal-x86_64-freebsd-all-static.tar.gz"
       },
       "dynamic" => {
-        "checksum" => "072c2312aadf961c3f851552ee255db77f0c4050e47d438dd9f82e536b68bcd6",
+        "checksum" => "7545a50f4d127da466e87d9504df4911ed9f8b0ec67b86023e08f8a58ea2b8c2",
         "filename" => "appsignal-x86_64-freebsd-all-dynamic.tar.gz"
       }
     }

data/lib/appsignal/check_in/cron.rb

@@ -3,15 +3,6 @@
 module Appsignal
   module CheckIn
     class Cron
-      class << self
-        # @api private
-        def transmitter
-          @transmitter ||= Appsignal::Transmitter.new(
-            "#{Appsignal.config[:logging_endpoint]}/check_ins/json"
-          )
-        end
-      end
-
       # @api private
       attr_reader :identifier, :digest
 
@@ -21,11 +12,11 @@ module Appsignal
       end
 
       def start
-        transmit_event("start")
+        CheckIn.scheduler.schedule(event("start"))
       end
 
       def finish
-        transmit_event("finish")
+        CheckIn.scheduler.schedule(event("finish"))
       end
 
       private
@@ -39,29 +30,6 @@ module Appsignal
           :check_in_type => "cron"
         }
       end
-
-      def transmit_event(kind)
-        unless Appsignal.active?
-          Appsignal.internal_logger.debug(
-            "AppSignal not active, not transmitting cron check-in event"
-          )
-          return
-        end
-
-        response = self.class.transmitter.transmit(event(kind))
-
-        if response.code.to_i >= 200 && response.code.to_i < 300
-          Appsignal.internal_logger.debug(
-            "Transmitted cron check-in `#{identifier}` (#{digest}) #{kind} event"
-          )
-        else
-          Appsignal.internal_logger.error(
-            "Failed to transmit cron check-in #{kind} event: status code was #{response.code}"
-          )
-        end
-      rescue => e
-        Appsignal.internal_logger.error("Failed to transmit cron check-in #{kind} event: #{e}")
-      end
     end
   end
 end

data/lib/appsignal/check_in/scheduler.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+module Appsignal
+  module CheckIn
+    class Scheduler
+      INITIAL_DEBOUNCE_SECONDS = 0.1
+      BETWEEN_TRANSMISSIONS_DEBOUNCE_SECONDS = 10
+
+      def initialize
+        # The mutex is used to synchronize access to the events array, the
+        # waker thread and the main thread, as well as queue writes
+        # (which depend on the events array) and closes (so they do not
+        # happen at the same time that an event is added to the scheduler)
+        @mutex = Mutex.new
+        # The transmitter thread will be started when an event is first added.
+        @thread = nil
+        @queue = Thread::Queue.new
+        # Scheduled events that have not been sent to the transmitter thread
+        # yet. A copy of this array is pushed to the queue by the waker thread
+        # after it has awaited the debounce period.
+        @events = []
+        # The waker thread is used to schedule debounces. It will be started
+        # when an event is first added.
+        @waker = nil
+        # For internal testing purposes.
+        @transmitted = 0
+      end
+
+      def schedule(event)
+        unless Appsignal.active?
+          Appsignal.internal_logger.debug(
+            "Cannot transmit #{describe([event])}: AppSignal is not active"
+          )
+          return
+        end
+
+        @mutex.synchronize do
+          if @queue.closed?
+            Appsignal.internal_logger.debug(
+              "Cannot transmit #{describe([event])}: AppSignal is stopped"
+            )
+            return
+          end
+          add_event(event)
+          # If we're not already waiting to be awakened from a scheduled
+          # debounce, schedule a short debounce, which will push the events
+          # to the queue and schedule a long debounce.
+          start_waker(INITIAL_DEBOUNCE_SECONDS) if @waker.nil?
+
+          Appsignal.internal_logger.debug(
+            "Scheduling #{describe([event])} to be transmitted"
+          )
+
+          # Make sure to start the thread after an event has been added.
+          @thread ||= Thread.new(&method(:run))
+        end
+      end
+
+      def stop
+        @mutex.synchronize do
+          # Flush all events before closing the queue.
+          push_events
+        rescue ClosedQueueError
+          # The queue is already closed (by a previous call to `#stop`)
+          # so it is not possible to push events to it anymore.
+        ensure
+          # Ensure calling `#stop` closes the queue and kills
+          # the waker thread, disallowing any further events from being
+          # scheduled with `#schedule`.
+          stop_waker
+          @queue.close
+
+          # Block until the thread has finished.
+          @thread&.join
+        end
+      end
+
+      # @api private
+      # For internal testing purposes.
+      attr_reader :thread, :waker, :queue, :events, :transmitted
+
+      private
+
+      def run
+        loop do
+          events = @queue.pop
+          break if events.nil?
+
+          transmit(events)
+          @transmitted += 1
+        end
+      end
+
+      def transmit(events)
+        description = describe(events)
+
+        begin
+          response = CheckIn.transmitter.transmit(events, :format => :ndjson)
+
+          if (200...300).include?(response.code.to_i)
+            Appsignal.internal_logger.debug(
+              "Transmitted #{description}"
+            )
+          else
+            Appsignal.internal_logger.error(
+              "Failed to transmit #{description}: #{response.code} status code"
+            )
+          end
+        rescue => e
+          Appsignal.internal_logger.error("Failed to transmit #{description}: #{e.message}")
+        end
+      end
+
+      def describe(events)
+        if events.empty?
+          # This shouldn't happen.
+          "no check-in events"
+        elsif events.length > 1
+          "#{events.length} check-in events"
+        else
+          event = events.first
+          if event[:check_in_type] == "cron"
+            "cron check-in `#{event[:identifier] || "unknown"}` " \
+              "#{event[:kind] || "unknown"} event (digest #{event[:digest] || "unknown"})" \
+          else
+            "unknown check-in event"
+          end
+        end
+      end
+
+      # Must be called from within a `@mutex.synchronize` block.
+      def add_event(event)
+        # Remove redundant events, keeping the newly added one, which
+        # should be the one with the most recent timestamp.
+        if event[:check_in_type] == "cron"
+          # Remove any existing cron check-in event with the same identifier,
+          # digest and kind as the one we're adding.
+          @events.reject! do |existing_event|
+            next unless existing_event[:identifier] == event[:identifier] &&
+              existing_event[:digest] == event[:digest] &&
+              existing_event[:kind] == event[:kind] &&
+              existing_event[:check_in_type] == "cron"
+
+            Appsignal.internal_logger.debug(
+              "Replacing previously scheduled #{describe([existing_event])}"
+            )
+
+            true
+          end
+        end
+
+        @events << event
+      end
+
+      # Must be called from within a `@mutex.synchronize` block.
+      def start_waker(debounce)
+        stop_waker
+
+        @waker = Thread.new do
+          sleep(debounce)
+
+          @mutex.synchronize do
+            # Make sure this waker doesn't get killed, so it can push
+            # events and schedule a new waker.
+            @waker = nil
+            push_events
+          end
+        end
+      end
+
+      # Must be called from within a `@mutex.synchronize` block.
+      def stop_waker
+        @waker&.kill
+        @waker&.join
+        @waker = nil
+      end
+
+      # Must be called from within a `@mutex.synchronize` block.
+      def push_events
+        return if @events.empty?
+
+        # Push a copy of the events to the queue, and clear the events array.
+        # This ensures that `@events` always contains events that have not
+        # yet been pushed to the queue.
+        @queue.push(@events.dup)
+        @events.clear
+
+        start_waker(BETWEEN_TRANSMISSIONS_DEBOUNCE_SECONDS)
+      end
+    end
+  end
+end

data/lib/appsignal/check_in.rb

@@ -39,8 +39,26 @@ module Appsignal
         cron.finish
         output
       end
+
+      # @api private
+      def transmitter
+        @transmitter ||= Transmitter.new(
+          "#{Appsignal.config[:logging_endpoint]}/check_ins/json"
+        )
+      end
+
+      # @api private
+      def scheduler
+        @scheduler ||= Scheduler.new
+      end
+
+      # @api private
+      def stop
+        scheduler&.stop
+      end
     end
   end
 end
 
+require "appsignal/check_in/scheduler"
 require "appsignal/check_in/cron"

data/lib/appsignal/cli/diagnose.rb

@@ -150,7 +150,7 @@ module Appsignal
             ENV.fetch("APPSIGNAL_DIAGNOSE_ENDPOINT", DIAGNOSE_ENDPOINT),
             Appsignal.config
           )
-          response = transmitter.transmit(:diagnose => data)
+          response = transmitter.transmit({ :diagnose => data })
 
           unless response.code == "200"
             puts "  Error: Something went wrong while submitting the report " \

data/lib/appsignal/config.rb

@@ -15,6 +15,13 @@ module Appsignal
 
     # @api private
     def self.add_loader_defaults(name, env: nil, root_path: nil, **options)
+      if Appsignal.config
+        Appsignal.internal_logger.warn(
+          "The config defaults from the '#{name}' loader are ignored since " \
+            "the AppSignal config has already been initialized."
+        )
+      end
+
       loader_defaults << {
         :name => name,
         :env => env,

data/lib/appsignal/hooks/at_exit.rb

@@ -24,6 +24,7 @@ module Appsignal
       class AtExitCallback
         def self.call
           error = $! # rubocop:disable Style/SpecialGlobalVars
+          return unless error
           return if ignored_error?(error)
           return if Appsignal::Transaction.last_errors.include?(error)
 
@@ -35,7 +36,8 @@ module Appsignal
 
         IGNORED_ERRORS = [
           # Normal exits from the application we do not need to report
-          SystemExit
+          SystemExit,
+          SignalException
         ].freeze
 
         def self.ignored_error?(error)

data/lib/appsignal/hooks/puma.rb

@@ -7,10 +7,14 @@ module Appsignal
       register :puma
 
       def dependencies_present?
-        defined?(::Puma)
+        defined?(::Puma) &&
+          Gem::Version.new(Puma::Const::VERSION) >= Gem::Version.new("3.0.0")
       end
 
       def install
+        require "appsignal/integrations/puma"
+        ::Puma::Server.prepend(Appsignal::Integrations::PumaServer)
+
         return unless defined?(::Puma::Cluster)
 
         # For clustered mode with multiple workers

data/lib/appsignal/integrations/puma.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Appsignal
+  module Integrations
+    # @api private
+    module PumaServer
+      def lowlevel_error(error, env, response_status = 500)
+        response =
+          if method(:lowlevel_error).super_method.arity.abs == 3 # Puma >= 5
+            super
+          else # Puma <= 4
+            super(error, env)
+          end
+
+        unless PumaServerHelper.ignored_error?(error)
+          Appsignal.report_error(error) do |transaction|
+            Appsignal::Rack::ApplyRackRequest
+              .new(::Rack::Request.new(env))
+              .apply_to(transaction)
+            transaction.add_tags(
+              :reported_by => :puma_lowlevel_error,
+              :response_status => response_status
+            )
+          end
+        end
+
+        response
+      end
+    end
+
+    module PumaServerHelper
+      IGNORED_ERRORS = [
+        # Ignore internal Puma Client IO errors
+        # https://github.com/puma/puma/blob/9ee922d28e1fffd02c1d5480a9e13376f92f46a3/lib/puma/server.rb#L536-L544
+        "Puma::MiniSSL::SSLError",
+        "Puma::HttpParserError",
+        "Puma::HttpParserError501"
+      ].freeze
+
+      def self.ignored_error?(error)
+        IGNORED_ERRORS.include?(error.class.to_s)
+      end
+    end
+  end
+end