chronos-ruby 1.1.1 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f2ff96797e03af3f2ec69047e39bd05cce161f74704264851903d72508120399
-  data.tar.gz: 7b809747cbdfcee40abc07989945c76b25576176f20b8792ac6840f6b9624e36
+  metadata.gz: 348e3ca2ba28d8d97f80281bf0ffb545b013dfac248d7f14527f5d955513d7a2
+  data.tar.gz: 44e7047ef9d47aac49f5a22e416447aa82efd3944a93eabd61eb36fa74d3fb2b
 SHA512:
-  metadata.gz: 15bbdc2faf14f1e2684a9c3f27ee5fec193c34cd3342d9910e3a617ba9ea113e3e221904fb0d736c842465f4bbbe59d1d293b32cce2f820f954156fc36ae41d4
-  data.tar.gz: c47fbd431496ab36cbc3d7c0b1cc5a0360ba6433cfc1aef1efce12b14a793f7ea7cda443da2e27edcde88604de3c203aa911ce5846e9acf2361bf35bc4fe25b9
+  metadata.gz: 2b4b15808ff7363b470d0c4348fc0a338f4c2ea3eb4112db5b5d6e9c1437315ea57f7ac70f84e7618ea2f120e9210425c31041b328cdc9940c2ebc8593f4a2f3
+  data.tar.gz: 92a4bdf9041d68747c5c139061f9000f9526ac26ba9b1b913d73fb1413dd4492764bbb700067e7ffdec7610ebf4e16d671b49792c05e2e694664ca97b72b6e99

data/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes are documented here. The project follows Semantic Versioning
 
 ## [Unreleased]
 
+## [1.1.3] - 2026-08-13
+
+### Changed
+
+- expanded the gem summary and description to clarify its exception, metrics, and telemetry monitoring purpose;
+- highlighted https://chronosmonitor.com.br as the official Chronos Monitor platform for receiving and visualizing observability data;
+- synchronized stable legacy release references and installation examples with version `1.1.3`.
+
+## [1.1.2] - 2026-08-13
+
+### Changed
+
+- the generated Rails initializer now exposes only common application-facing options with safe environment overrides;
+- the official Chronos endpoint remains an internal default and is no longer assigned in generated initializers;
+- Rails derives the service name from the application namespace when `CHRONOS_SERVICE_NAME` is absent;
+- Rails applications automatically install the optional Sidekiq 4/5 client and server middleware when Sidekiq is available.
+
+### Fixed
+
+- configuration snapshots no longer freeze the Rails-owned logger, preventing later logger extensions from raising `FrozenError`;
+- logger lookup and optional Sidekiq installation failures are contained so they cannot abort Rails boot.
+
+### Security
+
+- `CHRONOS_SSL_VERIFY` remains enabled by default and unknown Boolean values retain the secure default;
+- generated Boolean overrides accept only explicit `1/0`, `true/false`, `yes/no`, and `on/off` forms.
+
 ## [1.1.1] - 2026-08-11
 
 ### Changed

data/README.md

@@ -1,6 +1,6 @@
 # Chronos Ruby
 
-Chronos Ruby 1.1.1 é o agente independente de framework para enviar exceções e telemetria limitada de aplicações Ruby ao Chronos. Esta é a linha estável legado, compatível com o protocolo v1 e voltada a Ruby 2.2.10–2.6.
+Chronos Ruby 1.1.3 é o agente independente de framework para enviar exceções e telemetria limitada de aplicações Ruby ao Chronos. Esta é a linha estável legado, compatível com o protocolo v1 e voltada a Ruby 2.2.10–2.6.
 
 ## O que a gem coleta
 
@@ -24,7 +24,7 @@ A gem não varre variáveis de ambiente, sistema de arquivos ou lockfiles e não
 
 ## Versões Ruby e Rails suportadas
 
-A versão 1.1.1 suporta Ruby puro e Rack em Ruby 2.2.10, 2.3.8, 2.4.10, 2.5.9 e 2.6.10. As combinações Rails validadas são Rails 4.2 com Ruby 2.2.10/2.3.8 e Rails 5.2 com Ruby 2.5.9/2.6.10. Sidekiq 4.2.10 com Ruby 2.2.10 e Sidekiq 5.2.10 com Ruby 2.5.9 também possuem gates dedicados. Ruby 2.7/Rails 6 não é declarado nesta release porque ainda não possui aplicação e matriz completas.
+A versão 1.1.3 suporta Ruby puro e Rack em Ruby 2.2.10, 2.3.8, 2.4.10, 2.5.9 e 2.6.10. As combinações Rails validadas são Rails 4.2 com Ruby 2.2.10/2.3.8 e Rails 5.2 com Ruby 2.5.9/2.6.10. Sidekiq 4.2.10 com Ruby 2.2.10 e Sidekiq 5.2.10 com Ruby 2.5.9 também possuem gates dedicados. Ruby 2.7/Rails 6 não é declarado nesta release porque ainda não possui aplicação e matriz completas.
 
 Rubies e frameworks antigos estão fora do suporte de segurança de seus mantenedores. A Chronos oferece compatibilidade técnica, não manutenção de segurança do runtime. Veja [Compatibilidade](docs/compatibility.md).
 
@@ -33,7 +33,7 @@ Rubies e frameworks antigos estão fora do suporte de segurança de seus mantene
 Obrigatório: adicione a versão estável ao `Gemfile`.
 
 ```ruby
-gem "chronos-ruby", "~> 1.1.1"
+gem "chronos-ruby", "~> 1.1.3"
 ```
 
 Em runtimes antigos, use Bundler compatível:
@@ -46,7 +46,7 @@ bundle _1.17.3_ install
 Sem Bundler:
 
 ```bash
-gem install chronos-ruby -v 1.1.1
+gem install chronos-ruby -v 1.1.3
 ```
 
 ## Instalação em Rails
@@ -54,7 +54,7 @@ gem install chronos-ruby -v 1.1.1
 Obrigatório: carregue a integração Rails explicitamente para manter Rails/ActiveSupport fora de aplicações Ruby puras.
 
 ```ruby
-gem "chronos-ruby", "~> 1.1.1", :require => "chronos/rails"
+gem "chronos-ruby", "~> 1.1.3", :require => "chronos/rails"
 ```
 
 Gere o initializer:
@@ -76,7 +76,6 @@ require "chronos"
 Chronos.configure do |config|
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  config.host = "https://chronosmonitor.com.br"
   config.environment = ENV["APP_ENV"] || "production"
   config.service_name = "billing"
   config.app_version = ENV["APP_VERSION"]
@@ -205,13 +204,15 @@ Por padrão, SQL bruto e binds não são lidos pelo pipeline de análise. A insp
 
 ## Sidekiq e Active Job
 
-A versão `0.6.0.pre.1` introduziu middleware Sidekiq 4/5; a API estável mantém o require explícito:
+A versão `0.6.0.pre.1` introduziu middleware Sidekiq 4/5. Em Rails, a versão 1.1.3 detecta Sidekiq e instala automaticamente os middlewares de cliente e servidor:
 
 ```ruby
 gem "sidekiq", "~> 5.0"
-gem "chronos-ruby", "~> 1.1.1", :require => "chronos/sidekiq"
+gem "chronos-ruby", "~> 1.1.3", :require => "chronos/rails"
 ```
 
+Aplicações Ruby sem Rails continuam usando `require "chronos/sidekiq"` explicitamente.
+
 O envelope de contexto não altera argumentos públicos e contém somente IDs limitados de trace/request. Active Job usa um campo serializado com namespace (`chronos_context`) e hooks públicos. Erros aninhados são deduplicados e reerguidos. Veja [Sidekiq legado](docs/modules/sidekiq-legacy.md), [Active Job](docs/modules/active-job.md) e [Jobs](docs/modules/job-monitoring.md).
 
 ## Deploy tracking
@@ -262,7 +263,6 @@ A gem não varre o ambiente. Leia somente variáveis escolhidas pela aplicação
 Chronos.configure do |config|
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  config.host = ENV["CHRONOS_HOST"]
   config.environment = ENV["APP_ENV"] || "production"
   config.enabled = ENV["CHRONOS_ENABLED"] != "false"
   config.queue_size = 100

data/docs/compatibility.md

@@ -33,7 +33,7 @@ Chronos Ruby 1.1 is the current stable legacy line. Technical compatibility does
 
 Active Job uses the public `serialize`, `deserialize`, and `perform_now` extension points with a bounded namespaced field. Support follows the validated Rails pairs above. Adapters that bypass these hooks require their own evidence.
 
-The release workflow repeats every supported pair before publishing. Historical 1.0 evidence remains in [Version 1.0 readiness](release-1.0-readiness.md); the 1.1 candidate is recorded in [Version 1.1 readiness](release-1.1-readiness.md).
+The release workflow repeats every supported pair before publishing. Version 1.1.3 evidence is recorded in [Version 1.1.3 readiness](release-1.1.3-readiness.md); historical evidence remains in [Version 1.1.2 readiness](release-1.1.2-readiness.md), [Version 1.0 readiness](release-1.0-readiness.md), and [Version 1.1 readiness](release-1.1-readiness.md).
 
 Status meanings:
 

data/docs/modules/rails-legacy.md

@@ -16,7 +16,7 @@ Run:
 rails generate chronos:install
 ```
 
-The generator creates `config/initializers/chronos.rb`. The template reads only explicitly named `CHRONOS_*` variables, uses `Rails.env`, adopts `Rails.logger` when available, and disables automatic integration in test and console by default. It invokes the idempotent installer as a fallback for applications that disabled Bundler auto-require, so the Railtie and initializer paths cannot create duplicate hooks. It never scans all environment variables or modifies routes and application classes.
+The generator creates `config/initializers/chronos.rb`. The concise template reads only explicitly named `CHRONOS_*` variables, uses documented safe defaults, derives the service name from the Rails application namespace, adopts `Rails.logger` without freezing it, and disables automatic integration in test and console by default. It invokes the idempotent installer as a fallback for applications that disabled Bundler auto-require, so the Railtie and initializer paths cannot create duplicate hooks. When Sidekiq is available, the installer also activates its existing optional client and server middleware. It never scans all environment variables or modifies routes and application classes.
 
 ## Captured integrations
 
@@ -57,4 +57,4 @@ The repository contains independent applications under `examples/rails-4.2` and
 
 ## Limits
 
-Version 0.7 aggregates controller, SQL, and job timings into bounded APM batches. SQL literals and binds remain excluded while a bounded normalized query and fingerprint are produced. Sidekiq support remains a separate optional integration. Version `0.9.0.pre.2` provides bounded Active Job trace/request propagation through a namespaced serialized field; adapters that replace the standard Active Job serialization/execution hooks require separate compatibility evidence.
+Version 0.7 aggregates controller, SQL, and job timings into bounded APM batches. SQL literals and binds remain excluded while a bounded normalized query and fingerprint are produced. Sidekiq remains an optional dependency but is installed automatically when present in Rails. Version `0.9.0.pre.2` provides bounded Active Job trace/request propagation through a namespaced serialized field; adapters that replace the standard Active Job serialization/execution hooks require separate compatibility evidence.

data/docs/modules/sidekiq-legacy.md

@@ -1,13 +1,13 @@
 # Sidekiq 4/5 legacy integration
 
-Version `0.6.0.pre.1` starts the legacy jobs line with optional Sidekiq 4 and 5 client and server middleware. Load it after declaring Sidekiq:
+Version `0.6.0.pre.1` starts the legacy jobs line with optional Sidekiq 4 and 5 client and server middleware. Version `1.1.3` installs it automatically when Sidekiq is available in a Rails application:
 
 ```ruby
 gem "sidekiq", "~> 5.0"
-gem "chronos-ruby", "~> 1.1.0", :require => "chronos/sidekiq"
+gem "chronos-ruby", "~> 1.1.3", :require => "chronos/rails"
 ```
 
-`chronos/sidekiq` installs middleware through the public `configure_client` and `configure_server` APIs. It does nothing when Sidekiq is unavailable, and the core gem never requires Sidekiq. Installation adds no Chronos thread or Redis/database connection per job; delivery continues through the agent's existing fixed worker pool.
+Plain Ruby applications continue to use `require "chronos/sidekiq"` explicitly. Both entry points install middleware through the public `configure_client` and `configure_server` APIs. They do nothing when Sidekiq is unavailable, and the framework-independent core never requires Sidekiq. Installation adds no Chronos thread or Redis/database connection per job; delivery continues through the agent's existing fixed worker pool.
 
 The client middleware adds a top-level `chronos` metadata object to the Sidekiq envelope. It never changes the public `args` array. Only `trace_id` and `request_id` propagate, with schema version and enqueue time. The server scopes that context for the worker, measures duration and calculable queue latency, and emits one `job` event.
 

data/docs/release-1.1.2-readiness.md

@@ -0,0 +1,21 @@
+# Version 1.1.2 release evidence
+
+Version `1.1.2` is a backward-compatible maintenance release of the stable legacy line. It simplifies the generated Rails initializer, keeps the official host internal, derives a default Rails service name, preserves application ownership of the logger, and automatically installs the existing optional Sidekiq 4/5 middleware in Rails applications.
+
+The release preserves Ruby 2.2.10–2.6.10, Rails 4.2/5.2, Sidekiq 4.2.10/5.2.10, and protocol `schema_version: "1.0"`. It introduces no mandatory framework dependency and no transitional 1.2-only API.
+
+## Required gates
+
+- complete unit, integration, contract, privacy, concurrency, transport, and lint suite on Ruby 2.2.10–2.6.10;
+- real Rails 4.2 applications on Ruby 2.2.10/2.3.8 and Rails 5.2 applications on Ruby 2.5.9/2.6.10;
+- real Sidekiq 4.2.10 and 5.2.10 client/server middleware smoke tests;
+- generated initializer boot, service-name fallback, logger mutability, optional Sidekiq installation, and idempotency tests;
+- documentation verification, repeatable benchmarks, and the bounded fake-endpoint privacy/load gate;
+- gem build, package inspection, SHA-256 checksum, SPDX SBOM, and RubyGems Trusted Publishing.
+
+The release tag must be exactly `v1.1.2` and match `Chronos::VERSION`. Do not publish manually. After the reviewed commit and all gates are green:
+
+```bash
+git tag v1.1.2
+git push origin v1.1.2
+```

data/docs/release-1.1.3-readiness.md

@@ -0,0 +1,22 @@
+# Version 1.1.3 release evidence
+
+Version `1.1.3` is a backward-compatible documentation and package-metadata maintenance release of the stable legacy line. It clarifies that the gem captures exceptions, metrics, and telemetry from Ruby and Rails applications and identifies https://chronosmonitor.com.br as the official Chronos Monitor platform for receiving and visualizing those observability signals.
+
+The release preserves Ruby 2.2.10–2.6.10, Rails 4.2/5.2, Sidekiq 4.2.10/5.2.10, and protocol `schema_version: "1.0"`. It changes no runtime behavior, public API, collected field, framework dependency, or compatibility claim.
+
+## Required gates
+
+- complete unit, integration, contract, privacy, concurrency, transport, and lint suite on Ruby 2.2.10–2.6.10;
+- real Rails 4.2 applications on Ruby 2.2.10/2.3.8 and Rails 5.2 applications on Ruby 2.5.9/2.6.10;
+- real Sidekiq 4.2.10 and 5.2.10 client/server middleware smoke tests;
+- documentation and pull request description verification;
+- dependency audit with the CI-pinned tooling;
+- repeatable query-analysis and Rack benchmarks plus the bounded fake-endpoint privacy/load gate;
+- gem build, package inspection, SHA-256 checksum, SPDX SBOM, and RubyGems Trusted Publishing.
+
+The release tag must be exactly `v1.1.3` and match `Chronos::VERSION`. Do not publish manually. After the reviewed commit and all gates are green:
+
+```bash
+git tag v1.1.3
+git push origin v1.1.3
+```

data/docs/troubleshooting.md

@@ -56,7 +56,7 @@ Require `chronos/capistrano` after the Capistrano/Rake task DSL is loaded. The i
 
 ## Sidekiq telemetry is missing
 
-Require `chronos/sidekiq` after Sidekiq is available and configure Chronos before jobs run. The entry point uses Sidekiq's public client/server middleware configuration and remains optional. Requiring only `chronos` or `chronos/rails` does not load Sidekiq. A job already enqueued before client middleware installation may lack propagated trace context, but server timing and failure capture can still run.
+In Rails, require `chronos/rails` and configure Chronos before jobs run; version 1.1.3 detects Sidekiq and installs its public client/server middleware automatically. In plain Ruby, require `chronos/sidekiq` explicitly after Sidekiq is available. Sidekiq remains optional in both cases. A job already enqueued before client middleware installation may lack propagated trace context, but server timing and failure capture can still run.
 
 ## A failed Sidekiq job appears twice
 

data/lib/chronos/configuration/snapshot.rb

@@ -3,7 +3,7 @@ module Chronos
   #
   # @responsibility Expose validated settings without mutable containers.
   # @motivation Keep capture behavior stable while multiple threads run.
-  # @limits It cannot be edited after creation.
+  # @limits Snapshot values cannot be edited; the host application's logger remains externally owned.
   # @collaborators Configuration and runtime services.
   # @thread_safety Safe to share between threads after construction.
   # @compatibility Ruby 2.2.10 through Ruby 2.6.
@@ -17,7 +17,7 @@ module Chronos
     def initialize(values)
       Configuration::ATTRIBUTES.each do |attribute|
         value = values[attribute]
-        deep_freeze(value)
+        deep_freeze(value) unless attribute == :logger
         instance_variable_set("@#{attribute}", value)
       end
       freeze

data/lib/chronos/rails/installer.rb

@@ -34,6 +34,7 @@ module Chronos
 
           install_middleware(application, options)
           install_active_job
+          install_sidekiq
           @subscriber.install
           self.class.applications[application.object_id] = true
         end
@@ -65,6 +66,24 @@ module Chronos
         Chronos::Integrations::ActiveJob.install(::ActiveJob::Base, @notifier)
       end
 
+      def install_sidekiq
+        library = sidekiq_library
+        return false unless library
+
+        Chronos::Integrations::Sidekiq.install(library, @notifier)
+      rescue StandardError
+        false
+      end
+
+      def sidekiq_library
+        return ::Sidekiq if defined?(::Sidekiq)
+
+        require "sidekiq"
+        ::Sidekiq if defined?(::Sidekiq)
+      rescue LoadError
+        nil
+      end
+
       def environment
         defined?(::Rails) && ::Rails.respond_to?(:env) ? ::Rails.env.to_s : nil
       end

data/lib/chronos/rails.rb

@@ -2,6 +2,7 @@ require "chronos"
 require "chronos/rails/active_record_query_inspector"
 require "chronos/rails/notifications_subscriber"
 require "chronos/integrations/active_job"
+require "chronos/integrations/sidekiq"
 require "chronos/rails/installer"
 
 require "chronos/rails/railtie" if defined?(::Rails::Railtie)
@@ -14,5 +15,16 @@ module Chronos
   # @limits Version 0.5 targets public APIs present in Rails 4.2 and 5.2.
   # @thread_safety Installation and subscriptions are protected against duplication.
   # @compatibility Rails 4.2 through Rails 5.2 with their supported legacy Rubies.
-  module Rails; end
+  module Rails
+    class << self
+      # Returns the namespace that owns the Rails application class.
+      def application_name(application = ::Rails.application)
+        class_name = application.class.name.to_s
+        name = class_name.sub(/::Application\z/, "")
+        name.empty? || name == class_name ? nil : name
+      rescue StandardError
+        nil
+      end
+    end
+  end
 end

data/lib/chronos/version.rb

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

data/lib/generators/chronos/install/templates/chronos.rb

@@ -1,165 +1,61 @@
 require "chronos/rails"
 
-# This initializer lists every public Chronos option so the application's
-# monitoring behavior is explicit and can be reviewed in one place.
+# Common Chronos settings. Every environment variable is optional unless your
+# Chronos project requires it; omitted values fall back to safe SDK defaults.
+env_boolean = lambda do |name, default|
+  normalized = ENV[name].to_s.downcase
+  next true if %w(1 true yes on).include?(normalized)
+  next false if %w(0 false no off).include?(normalized)
+
+  default
+end
+
 Chronos.configure do |config|
-  # Identifies the project that will receive monitoring events.
+  # Identification and authentication
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
-  # Authenticates event delivery. Keep this value in a secret manager.
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  # Defines the Chronos Monitor endpoint used to deliver events.
-  config.host = "https://chronosmonitor.com.br"
-  # Labels events with the current Rails environment.
-  config.environment = Rails.env.to_s
-  # Identifies the deployed application version.
+  config.environment = ENV.fetch("CHRONOS_ENVIRONMENT", Rails.env.to_s)
+  config.service_name = ENV["CHRONOS_SERVICE_NAME"] || Chronos::Rails.application_name
   config.app_version = ENV["CHRONOS_APP_VERSION"]
-  # Distinguishes this application from other monitored services.
-  config.service_name = ENV["CHRONOS_SERVICE_NAME"]
-  # Records the source revision, such as a Git commit SHA.
   config.revision = ENV["CHRONOS_REVISION"]
-  # Associates events with a specific deployment.
-  config.deploy_id = ENV["CHRONOS_DEPLOY_ID"]
-  # Identifies the infrastructure region running the application.
-  config.region = ENV["CHRONOS_REGION"]
-  # Identifies the process, container, or host producing an event.
-  config.instance_id = ENV["CHRONOS_INSTANCE_ID"]
-  # Removes the application root from reported file paths.
-  config.root_directory = Rails.root.to_s
-  # Sends internal Chronos diagnostics through the Rails logger.
-  config.logger = Rails.logger if Rails.respond_to?(:logger)
-
-  # Limits how long an established request waits for the server.
-  config.timeout = 5
-  # Limits how long Chronos waits while opening a connection.
-  config.open_timeout = 2
-  # Sets the maximum number of events in the in-memory queue.
-  config.queue_size = 100
-  # Sets the number of background delivery workers.
-  config.workers = 1
-  # Enables or disables all event collection and delivery.
-  config.enabled = true
-  # Controls whether captured exceptions are sent to Chronos.
-  config.error_notifications = true
-  # Prevents delivery from the listed application environments.
-  config.ignored_environments = []
-  # Routes outbound requests through a proxy URL when required.
-  config.proxy = nil
-  # Verifies the TLS certificate presented by the endpoint.
-  config.ssl_verify = true
-  # Identifies this SDK in outbound HTTP requests.
-  config.user_agent = "chronos-ruby/#{Chronos::VERSION}"
-  # Rejects serialized events larger than this number of bytes.
-  config.max_payload_size = 1_048_576
-  # Compresses request payloads with gzip when enabled.
-  config.gzip = false
-
-  # Removes values whose keys commonly contain private data.
-  config.blocklist_keys = Chronos::Configuration::DEFAULT_BLOCKLIST_KEYS.dup
-  # Keeps only the listed keys when this list is not empty.
-  config.allowlist_keys = []
-  # Applies custom callables that transform or discard events.
-  config.filters = []
-  # Replaces values for these keys with stable hashes.
-  config.hash_keys = []
-  # Removes the final segment of captured IP addresses.
-  config.anonymize_ip = true
-  # Discards events matching any configured ignore rule.
-  config.ignore_rules = []
-  # Limits the ignore rules evaluated for each event.
-  config.max_ignore_rules = 20
 
-  # Sets the number of retries after a recoverable failure.
-  config.max_retries = 3
-  # Sets the initial exponential-backoff delay in seconds.
-  config.retry_base_interval = 0.5
-  # Caps the retry delay in seconds.
-  config.retry_max_interval = 30
-  # Randomizes retry delays to prevent synchronized traffic.
-  config.retry_jitter = 0.25
-  # Keeps this many failed events for later delivery attempts.
-  config.backlog_size = 100
-  # Opens the circuit breaker after consecutive failures.
-  config.circuit_failure_threshold = 5
-  # Waits this many seconds before testing an open circuit.
-  config.circuit_reset_timeout = 30
-  # Allows bounded runtime configuration from the server.
-  config.remote_configuration = true
-  # Limits an accepted remote configuration response in bytes.
-  config.remote_config_max_bytes = 4_096
-  # Captures this fraction of eligible events, from 0.0 to 1.0.
-  config.sampling_rate = 1.0
-  # Restricts remote collection to these event categories.
-  config.enabled_event_types = %w(
-    exception request query job cache external_http dependencies deploy metric_batch
-  )
-  # Caps the server-requested delivery interval in seconds.
-  config.max_remote_send_interval = 60
-
-  # Stores request and trace context independently in each thread.
-  config.context_store = :thread_local
-  # Keeps this many recent breadcrumbs per execution context.
-  config.breadcrumb_capacity = 20
-  # Limits each serialized breadcrumb in bytes.
-  config.breadcrumb_max_bytes = 2_048
-
-  # Installs Rails request, job, cache, SQL, and error integrations.
-  config.rails_enabled = true
-  # Captures events from Rails console sessions when enabled.
-  config.rails_capture_in_console = false
-  # Captures events from the Rails test environment when enabled.
-  config.rails_capture_in_test = false
-  # Includes the request User-Agent in metadata when enabled.
-  config.rails_capture_user_agent = false
-
-  # Enables transaction, span, query, and performance aggregation.
-  config.apm_enabled = true
-  # Limits the metric groups retained between flushes.
-  config.apm_max_groups = 200
-  # Flushes APM aggregates after this many observations.
-  config.apm_flush_count = 100
-  # Sends at most this many APM items in one request.
-  config.apm_batch_size = 50
-  # Limits SQL queries recorded for one request or transaction.
-  config.apm_max_queries_per_request = 100
-  # Marks queries slower than this duration in milliseconds.
-  config.apm_slow_query_threshold_ms = 500
-  # Marks transactions longer than this duration in milliseconds.
-  config.apm_long_transaction_threshold_ms = 1_000
-  # Reports repeated equivalent queries after this count.
-  config.apm_n_plus_one_threshold = 5
-  # Defines duration buckets in milliseconds for APM histograms.
-  config.apm_histogram_buckets = [5, 10, 25, 50, 100, 250, 500, 1_000, 2_500, 5_000]
-  # Retains active trace state for this many seconds.
-  config.apm_trace_ttl_seconds = 60
-  # Normalizes SQL and records bounded analysis metadata.
-  config.apm_query_analysis_enabled = true
-  # Limits analyzed queries retained per transaction.
-  config.apm_query_analysis_max_queries = 100
-  # Enables database-specific inspection for slow queries.
-  config.apm_query_inspection_enabled = false
-  # Collects database query statistics when supported.
-  config.apm_query_statistics_enabled = false
-  # Collects query execution plans when supported.
-  config.apm_query_plan_enabled = false
-  # Inspects only queries at least this slow in milliseconds.
-  config.apm_query_inspection_min_duration_ms = 500
-  # Limits inspected queries retained per transaction.
-  config.apm_query_inspection_max_queries = 20
-  # Tracks database transaction lifecycles and durations.
-  config.apm_transaction_tracking_enabled = true
-  # Limits database connections tracked for transaction state.
-  config.apm_transaction_max_connections = 100
-
-  # Instruments supported outbound HTTP clients when enabled.
-  config.external_http_enabled = false
-  # Propagates Chronos trace headers on outbound requests.
-  config.external_http_trace_headers = true
-  # Controls cache key reporting; :none collects no key material.
-  config.cache_key_mode = :none
-  # Reports a bounded inventory of application dependencies.
-  config.dependency_reporting = true
-  # Limits dependencies included in an inventory event.
-  config.dependency_max_items = 100
+  # General behavior and transport
+  config.enabled = env_boolean.call("CHRONOS_ENABLED", true)
+  config.error_notifications = env_boolean.call("CHRONOS_ERROR_NOTIFICATIONS", true)
+  config.ssl_verify = env_boolean.call("CHRONOS_SSL_VERIFY", true)
+  config.timeout = ENV.fetch("CHRONOS_TIMEOUT", "5").to_f
+  config.open_timeout = ENV.fetch("CHRONOS_OPEN_TIMEOUT", "2").to_f
+  config.queue_size = ENV.fetch("CHRONOS_QUEUE_SIZE", "100").to_i
+  config.workers = ENV.fetch("CHRONOS_WORKERS", "1").to_i
+  config.sampling_rate = ENV.fetch("CHRONOS_SAMPLING_RATE", "1.0").to_f
+  config.ignored_environments = ENV.fetch("CHRONOS_IGNORED_ENVIRONMENTS", "")
+                                   .split(",").map(&:strip).reject(&:empty?)
+
+  # Rails integration and privacy
+  config.root_directory = Rails.root.to_s
+  config.rails_enabled = env_boolean.call("CHRONOS_RAILS_ENABLED", true)
+  config.rails_capture_in_console = env_boolean.call("CHRONOS_RAILS_CAPTURE_IN_CONSOLE", false)
+  config.rails_capture_in_test = env_boolean.call("CHRONOS_RAILS_CAPTURE_IN_TEST", false)
+  config.anonymize_ip = env_boolean.call("CHRONOS_ANONYMIZE_IP", true)
+
+  # Application performance monitoring
+  config.apm_enabled = env_boolean.call("CHRONOS_APM_ENABLED", true)
+  config.apm_slow_query_threshold_ms = ENV.fetch(
+    "CHRONOS_APM_SLOW_QUERY_THRESHOLD_MS", "500"
+  ).to_f
+  config.apm_long_transaction_threshold_ms = ENV.fetch(
+    "CHRONOS_APM_LONG_TRANSACTION_THRESHOLD_MS", "1000"
+  ).to_f
+  config.apm_n_plus_one_threshold = ENV.fetch("CHRONOS_APM_N_PLUS_ONE_THRESHOLD", "5").to_i
+  config.external_http_enabled = env_boolean.call("CHRONOS_EXTERNAL_HTTP_ENABLED", false)
+
+  # Chronos keeps the shared Rails logger mutable and contains logger failures.
+  begin
+    config.logger = Rails.logger if Rails.respond_to?(:logger)
+  rescue StandardError
+    # Chronos safely continues without an application logger.
+    nil
+  end
 end
 
 # Installation is idempotent, regardless of when the Railtie was evaluated.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chronos-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.1.3
 platform: ruby
 authors:
 - Antonio Jefferson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-11 00:00:00.000000000 Z
+date: 2026-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -86,8 +86,11 @@ dependencies:
     - - '='
       - !ruby/object:Gem::Version
         version: 1.19.2
-description: Base do cliente Chronos para excecoes, telemetria e observabilidade em
-  aplicacoes Ruby legadas.
+description: Cliente oficial do Chronos para capturar e enviar exceções, métricas
+  e dados de telemetria de aplicações Ruby e Rails. A gem centraliza sinais de observabilidade
+  para facilitar o monitoramento, a análise de desempenho e o diagnóstico de falhas
+  no Chronos Monitor. Conheça a plataforma oficial de recebimento e visualização dos
+  dados em https://chronosmonitor.com.br.
 email:
 - antoniojeferson96@gmail.com
 executables: []
@@ -166,6 +169,8 @@ files:
 - docs/protocol-v1.md
 - docs/release-1.0-readiness.md
 - docs/release-1.1-readiness.md
+- docs/release-1.1.2-readiness.md
+- docs/release-1.1.3-readiness.md
 - docs/security-review.md
 - docs/semver.md
 - docs/troubleshooting.md
@@ -271,5 +276,5 @@ requirements: []
 rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
-summary: Cliente Ruby para captura de eventos do Chronos
+summary: Monitoramento de exceções, métricas e telemetria para Ruby e Rails
 test_files: []