1 files changed, 41 insertions, 0 deletions
diff --git a/lib/gitlab/puma/error_handler.rb b/lib/gitlab/puma/error_handler.rb
new file mode 100644
index 00000000000..4efc4866431
--- /dev/null
+++ b/lib/gitlab/puma/error_handler.rb
@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Puma
+    class ErrorHandler
+      PROD_ERROR_MESSAGE = "An error has occurred and reported in the system's low-level error handler."
+      DEV_ERROR_MESSAGE = <<~MSG
+        Server Error: An error has been caught by Puma's low-level error handler.
+        Read the Puma section of the troubleshooting docs for next steps - https://gitlab.com/gitlab-org/gitlab-development-kit/-/blob/main/doc/troubleshooting/index.md#puma.
+      MSG
+
+      def initialize(is_production)
+        @is_production = is_production
+      end
+
+      def execute(ex, env, status_code)
+        # Puma v6.4.0 added the status_code argument in
+        # https://github.com/puma/puma/pull/3094
+        status_code ||= 500
+
+        if Raven.configuration.capture_allowed?
+          Raven.capture_exception(ex, tags: { handler: 'puma_low_level' },
+            extra: { puma_env: env, status_code: status_code })
+        end
+
+        # note the below is just a Rack response
+        [status_code, {}, message]
+      end
+
+      private
+
+      def message
+        if @is_production
+          PROD_ERROR_MESSAGE
+        else
+          DEV_ERROR_MESSAGE
+        end
+      end
+    end
+  end
+end