chronos-ruby 0.7.0.pre.1 → 0.8.0.pre.1

data/lib/chronos/observability_facade.rb

@@ -0,0 +1,43 @@
+module Chronos
+  # Public entry points for optional version 0.8 observability integrations.
+  #
+  # @responsibility Delegate dependency, cache, and outbound HTTP integration calls to the agent.
+  # @motivation Keep the main public facade small while preserving one stable Chronos namespace.
+  # @limits It installs only explicitly supplied Net::HTTP connections and never enables features.
+  # @collaborators Chronos::Agent and Chronos::Integrations::NetHttp.
+  # @thread_safety Agent access uses the facade's synchronized current_agent lookup.
+  # @compatibility Ruby 2.2.10 through Ruby 2.6.
+  # @example
+  #   Chronos.instrument_net_http(Net::HTTP.new("api.example.com"))
+  # @errors Integration failures return false or safe disabled options.
+  # @performance Delegation is constant-time; dependency collection remains at-most-once.
+  module ObservabilityFacade
+    def report_dependencies
+      agent = current_agent
+      agent ? agent.report_dependencies : false
+    rescue StandardError
+      false
+    end
+
+    def external_http_integration_options
+      agent = current_agent
+      agent ? agent.external_http_integration_options : {:enabled => false}
+    rescue StandardError
+      {:enabled => false}
+    end
+
+    def cache_integration_options
+      agent = current_agent
+      agent ? agent.cache_integration_options : {:project_id => "", :key_mode => :none}
+    rescue StandardError
+      {:project_id => "", :key_mode => :none}
+    end
+
+    def instrument_net_http(connection, options = {})
+      require "chronos/net_http"
+      Integrations::NetHttp.install(connection, options.merge(:notifier => self))
+    rescue StandardError
+      false
+    end
+  end
+end

data/lib/chronos/rails/notifications_subscriber.rb

@@ -4,7 +4,7 @@ module Chronos
     #
     # @responsibility Subscribe once and normalize controller, view, SQL, mailer, job, and cache events.
     # @motivation Support Rails 4.2 and 5.2 through feature detection and public notification APIs.
-    # @limits It never sends SQL text, bind values, cache keys, mail bodies, or job arguments.
+    # @limits It never sends SQL text, binds, raw cache keys/values, mail bodies, or job arguments.
     # @collaborators ActiveSupport::Notifications and the Chronos facade.
     # @thread_safety Subscription registry is mutex-protected; callbacks own their state.
     # @compatibility ActiveSupport notification argument shapes from Rails 4.2 through 5.2.
@@ -30,6 +30,10 @@ module Chronos
         @notifier = notifier
         @notifications = notifications || active_support_notifications
         @sql_normalizer = Core::SqlNormalizer.new
+        cache_options = notifier.respond_to?(:cache_integration_options) ? notifier.cache_integration_options : {}
+        @cache_normalizer = Core::CacheNormalizer.new(
+          cache_options[:project_id].to_s, cache_options[:key_mode] || :none
+        )
       end
 
       def install
@@ -148,10 +152,7 @@ module Chronos
       end
 
       def cache(name, payload, duration)
-        data = {
-          "operation" => name.split(".").first, "store" => value(payload, :store).to_s,
-          "hit" => value(payload, :hit), "duration_ms" => duration
-        }
+        data = @cache_normalizer.call(name, payload).merge("duration_ms" => duration)
         @notifier.record_event("cache", data)
       end
 

data/lib/chronos/version.rb

@@ -1,4 +1,4 @@
 module Chronos
   # Current version of the legacy Chronos Ruby agent.
-  VERSION = "0.7.0.pre.1".freeze
+  VERSION = "0.8.0.pre.1".freeze
 end

data/lib/chronos.rb

@@ -18,6 +18,7 @@ require "chronos/core/payload_serializer"
 require "chronos/core/telemetry_event"
 require "chronos/core/sql_normalizer"
 require "chronos/core/metric_aggregate"
+require "chronos/core/cache_normalizer"
 require "chronos/ports/transport"
 require "chronos/ports/context_store"
 require "chronos/internal/safe_logger"
@@ -32,9 +33,12 @@ require "chronos/application/circuit_breaker"
 require "chronos/application/remote_configuration"
 require "chronos/application/delivery_pipeline"
 require "chronos/application/capture_exception"
+require "chronos/application/apm_error_classifier"
 require "chronos/application/apm_aggregator"
+require "chronos/application/dependency_reporter"
 require "chronos/application/capture_telemetry"
 require "chronos/agent"
+require "chronos/observability_facade"
 require "chronos/integrations"
 require "chronos/integrations/rack"
 require "chronos/integrations/rack/middleware"
@@ -55,6 +59,8 @@ require "chronos/integrations/rack/middleware"
 #   end
 #   Chronos.notify(RuntimeError.new("failed"))
 module Chronos
+  extend ObservabilityFacade
+
   @mutex = Mutex.new
   @agent = nil
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chronos-ruby
 version: !ruby/object:Gem::Version
-  version: 0.7.0.pre.1
+  version: 0.8.0.pre.1
 platform: ruby
 authors:
 - Antonio Jefferson
@@ -87,6 +87,7 @@ files:
 - README.md
 - SECURITY.md
 - contracts/apm-batch-v1.schema.json
+- contracts/dependencies-v1.schema.json
 - contracts/event-v1.schema.json
 - contracts/rack-context-v1.schema.json
 - contracts/sidekiq-job-v1.schema.json
@@ -101,6 +102,7 @@ files:
 - docs/adr/ADR-013-legacy-rails-notifications.md
 - docs/adr/ADR-014-sidekiq-envelope-context.md
 - docs/adr/ADR-015-bounded-apm-aggregation.md
+- docs/adr/ADR-016-explicit-observability-integrations.md
 - docs/architecture.md
 - docs/compatibility.md
 - docs/configuration.md
@@ -108,7 +110,10 @@ files:
 - docs/examples/plain-ruby.md
 - docs/modules/apm-aggregation.md
 - docs/modules/async-queue.md
+- docs/modules/cache-observability.md
 - docs/modules/configuration.md
+- docs/modules/dependencies.md
+- docs/modules/external-http.md
 - docs/modules/notice-pipeline.md
 - docs/modules/rack-context.md
 - docs/modules/rails-legacy.md
@@ -129,10 +134,12 @@ files:
 - lib/chronos/agent.rb
 - lib/chronos/application.rb
 - lib/chronos/application/apm_aggregator.rb
+- lib/chronos/application/apm_error_classifier.rb
 - lib/chronos/application/capture_exception.rb
 - lib/chronos/application/capture_telemetry.rb
 - lib/chronos/application/circuit_breaker.rb
 - lib/chronos/application/delivery_pipeline.rb
+- lib/chronos/application/dependency_reporter.rb
 - lib/chronos/application/remote_configuration.rb
 - lib/chronos/application/retry_policy.rb
 - lib/chronos/configuration.rb
@@ -142,6 +149,7 @@ files:
 - lib/chronos/core.rb
 - lib/chronos/core/backtrace_parser.rb
 - lib/chronos/core/breadcrumb.rb
+- lib/chronos/core/cache_normalizer.rb
 - lib/chronos/core/exception_cause_collector.rb
 - lib/chronos/core/metric_aggregate.rb
 - lib/chronos/core/notice.rb
@@ -156,6 +164,7 @@ files:
 - lib/chronos/errors.rb
 - lib/chronos/integrations.rb
 - lib/chronos/integrations/job_payload.rb
+- lib/chronos/integrations/net_http.rb
 - lib/chronos/integrations/rack.rb
 - lib/chronos/integrations/rack/middleware.rb
 - lib/chronos/integrations/sidekiq.rb
@@ -164,6 +173,8 @@ files:
 - lib/chronos/internal/memory_backlog.rb
 - lib/chronos/internal/safe_logger.rb
 - lib/chronos/internal/worker_pool.rb
+- lib/chronos/net_http.rb
+- lib/chronos/observability_facade.rb
 - lib/chronos/ports.rb
 - lib/chronos/ports/context_store.rb
 - lib/chronos/ports/transport.rb