hyperprobe-agent 1.2.27.pre.3-java

data/lib/hyperprobe/lambda.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module HyperProbe
+  module Lambda
+    class << self
+      def wrap(options = {}, &handler)
+        is_aws_lambda = !ENV['AWS_LAMBDA_FUNCTION_NAME'].nil?
+        is_local_emulator = ENV['IS_OFFLINE'] == 'true' || ENV['AWS_SAM_LOCAL'] == 'true'
+        is_ephemeral = (options[:is_lambda] || is_aws_lambda) && !is_local_emulator
+
+        # If running locally in emulator, standard background agent mode
+        unless is_ephemeral
+          HyperProbe.start(options)
+          return handler
+        end
+
+        # Ephemeral Lambda wrapper
+        lambda do |event:, context:|
+          agent = nil
+          begin
+            HyperProbe.start(options.merge(is_lambda: true)) unless HyperProbe.instance
+            agent = HyperProbe.instance
+            agent = nil if agent && agent.agent_disabled?
+            if agent
+              remaining_ms = context.respond_to?(:get_remaining_time_in_millis) ? context.get_remaining_time_in_millis : nil
+              sync_timeout_ms = options[:lambda_sync_timeout_ms] || 2000
+              if remaining_ms
+                dynamic_budget = (remaining_ms * 0.2).to_i
+                sync_timeout_ms = dynamic_budget < 100 ? 0 : [sync_timeout_ms, dynamic_budget].min
+              end
+              agent.force_sync(sync_timeout_ms / 1000.0) if sync_timeout_ms.positive?
+            end
+          rescue SignalException, SystemExit
+            raise
+          rescue Exception
+            # This boundary never encloses application handler execution.
+          end
+
+          begin
+            params = handler.parameters
+            has_keywords = params.any? { |type, _| type == :keyreq || type == :key || type == :keyrest }
+
+            if has_keywords
+              handler.call(event: event, context: context)
+            elsif params.length == 1 && (params.first[0] == :req || params.first[0] == :opt)
+              handler.call(event)
+            else
+              handler.call(event, context)
+            end
+          ensure
+            begin
+              if agent
+                remaining_ms = context.respond_to?(:get_remaining_time_in_millis) ? context.get_remaining_time_in_millis : nil
+                flush_timeout_ms = options[:flush_timeout_ms] || 1500
+                if remaining_ms.nil? || remaining_ms > 500
+                  flush_timeout_ms = [remaining_ms - 200, flush_timeout_ms].min if remaining_ms
+                  agent.force_flush(flush_timeout_ms / 1000.0)
+                end
+              end
+            rescue SignalException, SystemExit
+              raise
+            rescue Exception
+              # Never mask a handler exception with instrumentation cleanup.
+            end
+          end
+        end
+      rescue SignalException, SystemExit
+        raise
+      rescue Exception
+        handler
+      end
+
+      def stop
+        agent = HyperProbe.instance
+        if agent && !agent.agent_disabled?
+          begin
+            agent.force_flush(1.0)
+          rescue SignalException, SystemExit
+            raise
+          rescue Exception
+            # Best effort
+          end
+        end
+        HyperProbe.shutdown
+      rescue SignalException, SystemExit
+        raise
+      rescue Exception
+        nil
+      end
+    end
+  end
+end

data/lib/hyperprobe/protos/agent_descriptor.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+# Generated by rake proto:descriptor. DO NOT EDIT.
+module Hyperprobe
+  module JavaProto
+    DESCRIPTOR_DATA = "\n\x0b\x61gent.proto\x12\x13hyperprobe.agent.v1\"\x9c\x01\n\x10GetProbesRequest\x12\x10\n\x08\x61gent_id\x18\x01 \x01(\t\x12\x12\n\nservice_id\x18\x02 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x03 \x01(\t\x12\x12\n\ncommit_sha\x18\x04 \x01(\t\x12\x10\n\x08language\x18\x05 \x01(\t\x12\x15\n\ragent_version\x18\x06 \x01(\t\x12\x10\n\x08hostname\x18\x07 \x01(\t\"\xbc\x01\n\x11GetProbesResponse\x12*\n\x06probes\x18\x01 \x03(\x0b\x32\x1a.hyperprobe.agent.v1.Probe\x12\"\n\x15next_sync_interval_ms\x18\x02 \x01(\x05H\x00\x88\x01\x01\x12=\n\rglobal_config\x18\x03 \x01(\x0b\x32&.hyperprobe.agent.v1.AgentGlobalConfigB\x18\n\x16_next_sync_interval_ms\"U\n\x16SourceMapStatusRequest\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\"C\n\x17SourceMapStatusResponse\x12\x13\n\x0bis_uploader\x18\x01 \x01(\x08\x12\x13\n\x0bis_complete\x18\x02 \x01(\x08\"n\n\x0eSourceMapChunk\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\x12\x11\n\tfile_name\x18\x04 \x01(\t\x12\x0c\n\x04\x64\x61ta\x18\x05 \x01(\x0c\"!\n\x0eUploadResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"[\n\x1cMarkSourceMapCompleteRequest\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\"0\n\x1dMarkSourceMapCompleteResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"\x85\x03\n\x11\x41gentGlobalConfig\x12\x13\n\x0bredact_keys\x18\x01 \x03(\t\x12\x15\n\rredact_values\x18\x02 \x03(\t\x12\x1d\n\x10max_object_depth\x18\x03 \x01(\x05H\x00\x88\x01\x01\x12\x1d\n\x10max_array_length\x18\x04 \x01(\x05H\x01\x88\x01\x01\x12\x1e\n\x11stack_frame_depth\x18\x05 \x01(\x05H\x02\x88\x01\x01\x12\"\n\x15max_object_properties\x18\x06 \x01(\x05H\x03\x88\x01\x01\x12\x1e\n\x11max_string_length\x18\x07 \x01(\x05H\x04\x88\x01\x01\x12\x1d\n\x10\x63\x61pture_closures\x18\x08 \x01(\x08H\x05\x88\x01\x01\x42\x13\n\x11_max_object_depthB\x13\n\x11_max_array_lengthB\x14\n\x12_stack_frame_depthB\x18\n\x16_max_object_propertiesB\x14\n\x12_max_string_lengthB\x13\n\x11_capture_closures\"\x91\x07\n\x05Probe\x12\n\n\x02id\x18\x01 \x01(\t\x12,\n\x04type\x18\x02 \x01(\x0e\x32\x1e.hyperprobe.agent.v1.ProbeType\x12\x18\n\x10runtime_location\x18\x03 \x01(\t\x12\x14\n\x0cruntime_line\x18\x04 \x01(\x05\x12\"\n\x1asecondary_runtime_location\x18\x05 \x01(\t\x12\x1e\n\x16secondary_runtime_line\x18\x06 \x01(\x05\x12\x11\n\tcondition\x18\x07 \x01(\t\x12\x10\n\x08template\x18\x08 \x01(\t\x12\x13\n\x0bmetric_name\x18\t \x01(\t\x12\x19\n\x11metric_expression\x18\n \x01(\t\x12\x19\n\x11watch_expressions\x18\x0b \x03(\t\x12\x11\n\thit_limit\x18\x0c \x01(\x05\x12\x13\n\x0b\x65xpiry_time\x18\r \x01(\x03\x12\x16\n\x0eruntime_column\x18\x0e \x01(\x05\x12 \n\x18secondary_runtime_column\x18\x0f \x01(\x05\x12\x1e\n\x16\x63orrelation_expression\x18\x10 \x01(\t\x12\x1d\n\x10max_object_depth\x18\x11 \x01(\x05H\x00\x88\x01\x01\x12\x1d\n\x10max_array_length\x18\x12 \x01(\x05H\x01\x88\x01\x01\x12\x1e\n\x11stack_frame_depth\x18\x13 \x01(\x05H\x02\x88\x01\x01\x12\"\n\x15max_object_properties\x18\x14 \x01(\x05H\x03\x88\x01\x01\x12\x1e\n\x11max_string_length\x18\x15 \x01(\x05H\x04\x88\x01\x01\x12$\n\x17should_capture_trace_id\x18\x16 \x01(\x08H\x05\x88\x01\x01\x12\x16\n\tlog_level\x18\x17 \x01(\tH\x06\x88\x01\x01\x12!\n\x14should_log_to_stdout\x18\x18 \x01(\x08H\x07\x88\x01\x01\x12\x1d\n\x10\x63\x61pture_closures\x18\x19 \x01(\x08H\x08\x88\x01\x01\x42\x13\n\x11_max_object_depthB\x13\n\x11_max_array_lengthB\x14\n\x12_stack_frame_depthB\x18\n\x16_max_object_propertiesB\x14\n\x12_max_string_lengthB\x1a\n\x18_should_capture_trace_idB\x0c\n\n_log_levelB\x17\n\x15_should_log_to_stdoutB\x13\n\x11_capture_closures\"W\n\x0eTelemetryBatch\x12\x10\n\x08\x61gent_id\x18\x01 \x01(\t\x12\x33\n\x06\x65vents\x18\x02 \x03(\x0b\x32#.hyperprobe.agent.v1.TelemetryEvent\"\x8a\x01\n\nStackFrame\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x13\n\x0bline_number\x18\x03 \x01(\x05\x12\x15\n\rcolumn_number\x18\x04 \x01(\x05\x12\x17\n\nclass_name\x18\x05 \x01(\tH\x00\x88\x01\x01\x42\r\n\x0b_class_name\"\x8f\x02\n\x0eTelemetryEvent\x12\x10\n\x08probe_id\x18\x01 \x01(\t\x12\x14\n\x0ctimestamp_ms\x18\x02 \x01(\x03\x12\x35\n\x0cstack_frames\x18\x03 \x03(\x0b\x32\x1f.hyperprobe.agent.v1.StackFrame\x12\x1a\n\x12\x63\x61ptured_vars_json\x18\x04 \x01(\t\x12\x1a\n\x12watch_results_json\x18\x05 \x01(\t\x12\x15\n\revaluated_log\x18\x06 \x01(\t\x12\x14\n\x0cmetric_value\x18\x07 \x01(\x01\x12\x15\n\rcapture_error\x18\x08 \x01(\t\x12\x15\n\x08trace_id\x18\t \x01(\tH\x00\x88\x01\x01\x42\x0b\n\t_trace_id\"/\n\x11TelemetryResponse\x12\x1a\n\x12\x66inished_probe_ids\x18\x01 \x03(\t*\x9c\x01\n\tProbeType\x12\x1a\n\x16PROBE_TYPE_UNSPECIFIED\x10\x00\x12\x17\n\x13PROBE_TYPE_SNAPSHOT\x10\x01\x12\x12\n\x0ePROBE_TYPE_LOG\x10\x02\x12\x16\n\x12PROBE_TYPE_COUNTER\x10\x03\x12\x15\n\x11PROBE_TYPE_METRIC\x10\x04\x12\x17\n\x13PROBE_TYPE_DURATION\x10\x05\x32\x99\x04\n\x0b\x41gentBroker\x12Z\n\tGetProbes\x12%.hyperprobe.agent.v1.GetProbesRequest\x1a&.hyperprobe.agent.v1.GetProbesResponse\x12^\n\x0fReportTelemetry\x12#.hyperprobe.agent.v1.TelemetryBatch\x1a&.hyperprobe.agent.v1.TelemetryResponse\x12o\n\x12GetSourceMapStatus\x12+.hyperprobe.agent.v1.SourceMapStatusRequest\x1a,.hyperprobe.agent.v1.SourceMapStatusResponse\x12]\n\x0fUploadSourceMap\x12#.hyperprobe.agent.v1.SourceMapChunk\x1a#.hyperprobe.agent.v1.UploadResponse(\x01\x12~\n\x15MarkSourceMapComplete\x12\x31.hyperprobe.agent.v1.MarkSourceMapCompleteRequest\x1a\x32.hyperprobe.agent.v1.MarkSourceMapCompleteResponseB\tB\x05\x41gentP\x00\x62\x06proto3".b.freeze
+  end
+end

data/lib/hyperprobe/protos/agent_pb.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: agent.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x0b\x61gent.proto\x12\x13hyperprobe.agent.v1\"\x9c\x01\n\x10GetProbesRequest\x12\x10\n\x08\x61gent_id\x18\x01 \x01(\t\x12\x12\n\nservice_id\x18\x02 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x03 \x01(\t\x12\x12\n\ncommit_sha\x18\x04 \x01(\t\x12\x10\n\x08language\x18\x05 \x01(\t\x12\x15\n\ragent_version\x18\x06 \x01(\t\x12\x10\n\x08hostname\x18\x07 \x01(\t\"\xbc\x01\n\x11GetProbesResponse\x12*\n\x06probes\x18\x01 \x03(\x0b\x32\x1a.hyperprobe.agent.v1.Probe\x12\"\n\x15next_sync_interval_ms\x18\x02 \x01(\x05H\x00\x88\x01\x01\x12=\n\rglobal_config\x18\x03 \x01(\x0b\x32&.hyperprobe.agent.v1.AgentGlobalConfigB\x18\n\x16_next_sync_interval_ms\"U\n\x16SourceMapStatusRequest\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\"C\n\x17SourceMapStatusResponse\x12\x13\n\x0bis_uploader\x18\x01 \x01(\x08\x12\x13\n\x0bis_complete\x18\x02 \x01(\x08\"n\n\x0eSourceMapChunk\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\x12\x11\n\tfile_name\x18\x04 \x01(\t\x12\x0c\n\x04\x64\x61ta\x18\x05 \x01(\x0c\"!\n\x0eUploadResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"[\n\x1cMarkSourceMapCompleteRequest\x12\x12\n\nservice_id\x18\x01 \x01(\t\x12\x13\n\x0b\x65nvironment\x18\x02 \x01(\t\x12\x12\n\ncommit_sha\x18\x03 \x01(\t\"0\n\x1dMarkSourceMapCompleteResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\"\x85\x03\n\x11\x41gentGlobalConfig\x12\x13\n\x0bredact_keys\x18\x01 \x03(\t\x12\x15\n\rredact_values\x18\x02 \x03(\t\x12\x1d\n\x10max_object_depth\x18\x03 \x01(\x05H\x00\x88\x01\x01\x12\x1d\n\x10max_array_length\x18\x04 \x01(\x05H\x01\x88\x01\x01\x12\x1e\n\x11stack_frame_depth\x18\x05 \x01(\x05H\x02\x88\x01\x01\x12\"\n\x15max_object_properties\x18\x06 \x01(\x05H\x03\x88\x01\x01\x12\x1e\n\x11max_string_length\x18\x07 \x01(\x05H\x04\x88\x01\x01\x12\x1d\n\x10\x63\x61pture_closures\x18\x08 \x01(\x08H\x05\x88\x01\x01\x42\x13\n\x11_max_object_depthB\x13\n\x11_max_array_lengthB\x14\n\x12_stack_frame_depthB\x18\n\x16_max_object_propertiesB\x14\n\x12_max_string_lengthB\x13\n\x11_capture_closures\"\x91\x07\n\x05Probe\x12\n\n\x02id\x18\x01 \x01(\t\x12,\n\x04type\x18\x02 \x01(\x0e\x32\x1e.hyperprobe.agent.v1.ProbeType\x12\x18\n\x10runtime_location\x18\x03 \x01(\t\x12\x14\n\x0cruntime_line\x18\x04 \x01(\x05\x12\"\n\x1asecondary_runtime_location\x18\x05 \x01(\t\x12\x1e\n\x16secondary_runtime_line\x18\x06 \x01(\x05\x12\x11\n\tcondition\x18\x07 \x01(\t\x12\x10\n\x08template\x18\x08 \x01(\t\x12\x13\n\x0bmetric_name\x18\t \x01(\t\x12\x19\n\x11metric_expression\x18\n \x01(\t\x12\x19\n\x11watch_expressions\x18\x0b \x03(\t\x12\x11\n\thit_limit\x18\x0c \x01(\x05\x12\x13\n\x0b\x65xpiry_time\x18\r \x01(\x03\x12\x16\n\x0eruntime_column\x18\x0e \x01(\x05\x12 \n\x18secondary_runtime_column\x18\x0f \x01(\x05\x12\x1e\n\x16\x63orrelation_expression\x18\x10 \x01(\t\x12\x1d\n\x10max_object_depth\x18\x11 \x01(\x05H\x00\x88\x01\x01\x12\x1d\n\x10max_array_length\x18\x12 \x01(\x05H\x01\x88\x01\x01\x12\x1e\n\x11stack_frame_depth\x18\x13 \x01(\x05H\x02\x88\x01\x01\x12\"\n\x15max_object_properties\x18\x14 \x01(\x05H\x03\x88\x01\x01\x12\x1e\n\x11max_string_length\x18\x15 \x01(\x05H\x04\x88\x01\x01\x12$\n\x17should_capture_trace_id\x18\x16 \x01(\x08H\x05\x88\x01\x01\x12\x16\n\tlog_level\x18\x17 \x01(\tH\x06\x88\x01\x01\x12!\n\x14should_log_to_stdout\x18\x18 \x01(\x08H\x07\x88\x01\x01\x12\x1d\n\x10\x63\x61pture_closures\x18\x19 \x01(\x08H\x08\x88\x01\x01\x42\x13\n\x11_max_object_depthB\x13\n\x11_max_array_lengthB\x14\n\x12_stack_frame_depthB\x18\n\x16_max_object_propertiesB\x14\n\x12_max_string_lengthB\x1a\n\x18_should_capture_trace_idB\x0c\n\n_log_levelB\x17\n\x15_should_log_to_stdoutB\x13\n\x11_capture_closures\"W\n\x0eTelemetryBatch\x12\x10\n\x08\x61gent_id\x18\x01 \x01(\t\x12\x33\n\x06\x65vents\x18\x02 \x03(\x0b\x32#.hyperprobe.agent.v1.TelemetryEvent\"\x8a\x01\n\nStackFrame\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x11\n\tfile_name\x18\x02 \x01(\t\x12\x13\n\x0bline_number\x18\x03 \x01(\x05\x12\x15\n\rcolumn_number\x18\x04 \x01(\x05\x12\x17\n\nclass_name\x18\x05 \x01(\tH\x00\x88\x01\x01\x42\r\n\x0b_class_name\"\x8f\x02\n\x0eTelemetryEvent\x12\x10\n\x08probe_id\x18\x01 \x01(\t\x12\x14\n\x0ctimestamp_ms\x18\x02 \x01(\x03\x12\x35\n\x0cstack_frames\x18\x03 \x03(\x0b\x32\x1f.hyperprobe.agent.v1.StackFrame\x12\x1a\n\x12\x63\x61ptured_vars_json\x18\x04 \x01(\t\x12\x1a\n\x12watch_results_json\x18\x05 \x01(\t\x12\x15\n\revaluated_log\x18\x06 \x01(\t\x12\x14\n\x0cmetric_value\x18\x07 \x01(\x01\x12\x15\n\rcapture_error\x18\x08 \x01(\t\x12\x15\n\x08trace_id\x18\t \x01(\tH\x00\x88\x01\x01\x42\x0b\n\t_trace_id\"/\n\x11TelemetryResponse\x12\x1a\n\x12\x66inished_probe_ids\x18\x01 \x03(\t*\x9c\x01\n\tProbeType\x12\x1a\n\x16PROBE_TYPE_UNSPECIFIED\x10\x00\x12\x17\n\x13PROBE_TYPE_SNAPSHOT\x10\x01\x12\x12\n\x0ePROBE_TYPE_LOG\x10\x02\x12\x16\n\x12PROBE_TYPE_COUNTER\x10\x03\x12\x15\n\x11PROBE_TYPE_METRIC\x10\x04\x12\x17\n\x13PROBE_TYPE_DURATION\x10\x05\x32\x99\x04\n\x0b\x41gentBroker\x12Z\n\tGetProbes\x12%.hyperprobe.agent.v1.GetProbesRequest\x1a&.hyperprobe.agent.v1.GetProbesResponse\x12^\n\x0fReportTelemetry\x12#.hyperprobe.agent.v1.TelemetryBatch\x1a&.hyperprobe.agent.v1.TelemetryResponse\x12o\n\x12GetSourceMapStatus\x12+.hyperprobe.agent.v1.SourceMapStatusRequest\x1a,.hyperprobe.agent.v1.SourceMapStatusResponse\x12]\n\x0fUploadSourceMap\x12#.hyperprobe.agent.v1.SourceMapChunk\x1a#.hyperprobe.agent.v1.UploadResponse(\x01\x12~\n\x15MarkSourceMapComplete\x12\x31.hyperprobe.agent.v1.MarkSourceMapCompleteRequest\x1a\x32.hyperprobe.agent.v1.MarkSourceMapCompleteResponseB\tB\x05\x41gentP\x00\x62\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Hyperprobe
+  module Agent
+    module V1
+      GetProbesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.GetProbesRequest").msgclass
+      GetProbesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.GetProbesResponse").msgclass
+      SourceMapStatusRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.SourceMapStatusRequest").msgclass
+      SourceMapStatusResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.SourceMapStatusResponse").msgclass
+      SourceMapChunk = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.SourceMapChunk").msgclass
+      UploadResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.UploadResponse").msgclass
+      MarkSourceMapCompleteRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.MarkSourceMapCompleteRequest").msgclass
+      MarkSourceMapCompleteResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.MarkSourceMapCompleteResponse").msgclass
+      AgentGlobalConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.AgentGlobalConfig").msgclass
+      Probe = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.Probe").msgclass
+      TelemetryBatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.TelemetryBatch").msgclass
+      StackFrame = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.StackFrame").msgclass
+      TelemetryEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.TelemetryEvent").msgclass
+      TelemetryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.TelemetryResponse").msgclass
+      ProbeType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("hyperprobe.agent.v1.ProbeType").enummodule
+    end
+  end
+end

data/lib/hyperprobe/protos/agent_services_pb.rb

@@ -0,0 +1,31 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: agent.proto for package 'hyperprobe.agent.v1'
+
+require 'grpc'
+require 'agent_pb'
+
+module Hyperprobe
+  module Agent
+    module V1
+      module AgentBroker
+        class Service
+
+          include ::GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'hyperprobe.agent.v1.AgentBroker'
+
+          rpc :GetProbes, ::Hyperprobe::Agent::V1::GetProbesRequest, ::Hyperprobe::Agent::V1::GetProbesResponse
+          rpc :ReportTelemetry, ::Hyperprobe::Agent::V1::TelemetryBatch, ::Hyperprobe::Agent::V1::TelemetryResponse
+          # Handshake for JS source maps
+          rpc :GetSourceMapStatus, ::Hyperprobe::Agent::V1::SourceMapStatusRequest, ::Hyperprobe::Agent::V1::SourceMapStatusResponse
+          rpc :UploadSourceMap, stream(::Hyperprobe::Agent::V1::SourceMapChunk), ::Hyperprobe::Agent::V1::UploadResponse
+          rpc :MarkSourceMapComplete, ::Hyperprobe::Agent::V1::MarkSourceMapCompleteRequest, ::Hyperprobe::Agent::V1::MarkSourceMapCompleteResponse
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end

data/lib/hyperprobe/protos/java_messages.rb

@@ -0,0 +1,199 @@
+# frozen_string_literal: true
+
+require 'java'
+require_relative 'agent_descriptor'
+
+begin
+  require_relative '../jars/hyperprobe-grpc.jar'
+  JavaUtilities.get_proxy_class('co.hyperprobe.transport.ProtoCodec')
+rescue Java::JavaLang::LinkageError => e
+  raise LoadError, "Cannot load HyperProbe protobuf codec (Java 11+ required): #{e.message}"
+end
+
+module Hyperprobe
+  module Agent
+    module V1
+    end
+  end
+
+  # Only the SDK's canonical messages are exposed, not Google's Ruby runtime API.
+  module JavaProto
+    CODEC = JavaUtilities.get_proxy_class('co.hyperprobe.transport.ProtoCodec').new(DESCRIPTOR_DATA.to_java_bytes)
+    CLASSES = {}
+
+    class Message
+      class << self
+        attr_accessor :descriptor, :fields
+
+        def decode(bytes)
+          raise TypeError, 'Expected protobuf bytes as a String' unless bytes.is_a?(String)
+          raise ArgumentError, 'Protobuf payload exceeds 4 MiB' if bytes.bytesize > 4 * 1024 * 1024
+
+          from_java(CODEC.decode(descriptor, bytes.to_java_bytes))
+        rescue Java::JavaLang::Exception => e
+          raise ArgumentError, "Invalid protobuf: #{e.message}"
+        end
+
+        def encode(message)
+          raise TypeError, "Expected #{self}" unless message.is_a?(self)
+
+          message.to_proto
+        end
+
+        def from_java(message)
+          result = new
+          message.getAllFields.each do |field, value|
+            decoded = field.isRepeated ? value.map { |item| decode_value(field, item) } : decode_value(field, value)
+            result.public_send("#{field.getName}=", decoded)
+          end
+          result.instance_variable_set(:@unknown_fields, message.getUnknownFields)
+          result
+        end
+
+        def decode_value(field, value)
+          case field.getJavaType.to_s
+          when 'MESSAGE' then CLASSES.fetch(field.getMessageType.getFullName).from_java(value)
+          when 'ENUM' then value.getIndex < 0 ? value.getNumber : value.getName.to_sym
+          when 'BYTE_STRING' then String.from_java_bytes(value.toByteArray)
+          else value
+          end
+        end
+
+        def normalize(field, value)
+          case field.getJavaType.to_s
+          when 'MESSAGE'
+            klass = CLASSES.fetch(field.getMessageType.getFullName)
+            value = klass.new(value) if value.is_a?(Hash)
+            raise TypeError, "Expected #{klass} for #{field.getName}" unless value.is_a?(klass)
+          when 'ENUM'
+            enum = field.getEnumType
+            if value.is_a?(Symbol)
+              entry = enum.findValueByName(value.to_s)
+              raise ArgumentError, "Unknown enum #{value}" unless entry
+              return value
+            end
+            integer!(field, value, 32)
+            entry = enum.findValueByNumber(value)
+            value = entry.getName.to_sym if entry
+          when 'INT', 'LONG'
+            integer!(field, value, field.getJavaType.to_s == 'INT' ? 32 : 64)
+          when 'DOUBLE', 'FLOAT'
+            raise TypeError, "Expected number for #{field.getName}" unless value.is_a?(Numeric) && !value.is_a?(Complex)
+            value = value.to_f
+          when 'BOOLEAN'
+            raise TypeError, "Expected boolean for #{field.getName}" unless value.equal?(true) || value.equal?(false)
+          when 'STRING', 'BYTE_STRING'
+            raise TypeError, "Expected String for #{field.getName}" unless value.is_a?(String)
+            value = field.getJavaType.to_s == 'STRING' ? value.encode(Encoding::UTF_8) : value.b
+            raise ArgumentError, 'Invalid UTF-8 protobuf string' unless value.valid_encoding?
+            value = value.dup.freeze
+          else
+            raise ArgumentError, "Unsupported canonical field #{field.getName}"
+          end
+          value
+        end
+
+        def integer!(field, value, bits)
+          raise TypeError, "Expected Integer for #{field.getName}" unless value.is_a?(Integer)
+          raise RangeError, "Out of range for #{field.getName}" unless value >= -(2**(bits - 1)) && value < 2**(bits - 1)
+        end
+
+        def java_value(field, value)
+          case field.getJavaType.to_s
+          when 'MESSAGE' then value.to_java_message
+          when 'ENUM'
+            enum = field.getEnumType
+            value.is_a?(Symbol) ? enum.findValueByName(value.to_s) : enum.findValueByNumberCreatingIfUnknown(value)
+          when 'BYTE_STRING' then CODEC.bytes(value.to_java_bytes)
+          when 'STRING' then value.to_java(:string)
+          when 'INT' then value.to_java(:int)
+          when 'LONG' then value.to_java(:long)
+          when 'FLOAT' then value.to_java(:float)
+          when 'DOUBLE' then value.to_java(:double)
+          when 'BOOLEAN' then value.to_java(:boolean)
+          end
+        end
+      end
+
+      def initialize(values = {})
+        raise ArgumentError, 'Expected a field Hash' unless values.is_a?(Hash)
+
+        @values = {}
+        values.each do |name, value|
+          key = name.to_s
+          raise ArgumentError, "Unknown field #{key}" unless self.class.fields.key?(key)
+          public_send("#{key}=", value) unless value.nil?
+        end
+      end
+
+      def to_java_message
+        builder = CODEC.builder(self.class.descriptor)
+        builder.mergeUnknownFields(@unknown_fields) if @unknown_fields
+        @values.each do |name, value|
+          field = self.class.fields.fetch(name)
+          if field.isRepeated
+            # Arrays remain mutable; scalar setters already normalize and freeze strings.
+            value.each { |item| builder.addRepeatedField(field, self.class.java_value(field, self.class.normalize(field, item))) }
+          else
+            builder.setField(field, self.class.java_value(field, value))
+          end
+        end
+        builder.build
+      end
+
+      def to_proto
+        String.from_java_bytes(to_java_message.toByteArray)
+      end
+
+      def serialized_size
+        to_java_message.getSerializedSize
+      end
+
+      def ==(other)
+        other.instance_of?(self.class) && to_java_message == other.to_java_message
+      end
+      alias eql? ==
+
+      def hash
+        to_java_message.hashCode
+      end
+    end
+
+    CODEC.getFile.getEnumTypes.each do |enum|
+      mod = Module.new
+      enum.getValues.each { |value| mod.const_set(value.getName, value.getNumber) }
+      Agent::V1.const_set(enum.getName, mod)
+    end
+
+    CODEC.getFile.getMessageTypes.each do |descriptor|
+      klass = Class.new(Message)
+      klass.descriptor = descriptor
+      klass.fields = descriptor.getFields.each_with_object({}) { |field, fields| fields[field.getName] = field }.freeze
+      CLASSES[descriptor.getFullName] = klass
+      Agent::V1.const_set(descriptor.getName, klass)
+      klass.fields.each do |name, field|
+        klass.define_method(name) do
+          return @values[name] if @values.key?(name)
+          return @values[name] = [] if field.isRepeated
+          return nil if field.getJavaType.to_s == 'MESSAGE'
+
+          self.class.decode_value(field, field.getDefaultValue)
+        end
+        klass.define_method("#{name}=") do |value|
+          if value.nil? && field.hasPresence
+            @values.delete(name)
+          elsif field.isRepeated
+            raise TypeError, "Expected Array for #{name}" unless value.is_a?(Array)
+            @values[name] = value.map { |item| self.class.normalize(field, item) }
+          else
+            @values[name] = self.class.normalize(field, value)
+          end
+        end
+        if field.hasPresence
+          klass.define_method("has_#{name}?") { @values.key?(name) }
+        end
+      end
+    end
+    CLASSES.freeze
+  end
+end

data/lib/hyperprobe/protos.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+if RUBY_PLATFORM =~ /java/
+  require_relative 'protos/java_messages'
+else
+  protos_dir = File.expand_path('protos', __dir__)
+  $LOAD_PATH.unshift(protos_dir) unless $LOAD_PATH.include?(protos_dir)
+  require 'agent_pb'
+  begin
+    require 'agent_services_pb'
+  rescue LoadError
+    # Environments without the C-grpc gem can still use the messages.
+  end
+end

data/lib/hyperprobe/railtie.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module HyperProbe
+  if defined?(::Rails::Railtie)
+    class Railtie < ::Rails::Railtie
+      config.after_initialize do
+        enabled = ENV['HYPERPROBE_ENABLED'] != 'false' && ENV['HYPERPROBE_DISABLED'] != 'YES'
+        has_service_id = !ENV['HYPERPROBE_SERVICE_ID'].nil? && !ENV['HYPERPROBE_SERVICE_ID'].empty?
+
+        if enabled && has_service_id
+          HyperProbe.start
+        end
+
+        if defined?(::Spring) && ::Spring.respond_to?(:after_fork)
+          ::Spring.after_fork do
+            HyperProbe.after_fork
+          end
+        end
+      end
+    end
+  end
+end

data/lib/hyperprobe/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module HyperProbe
+  VERSION = '1.2.27.pre.3'
+end

data/lib/hyperprobe-agent.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'hyperprobe'