chronos-ruby 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0127def72275a2d4c08314040c04e34a9606fed13982d84b06c465dee7be4cf6
-  data.tar.gz: 99f272314517e6a525223ce86964b70fcdfce717eb0e434b9c77e275031913b7
+  metadata.gz: f2ff96797e03af3f2ec69047e39bd05cce161f74704264851903d72508120399
+  data.tar.gz: 7b809747cbdfcee40abc07989945c76b25576176f20b8792ac6840f6b9624e36
 SHA512:
-  metadata.gz: 93b37af1a5b51284a6c6de1c19e12de18ac23b04bfa4a04f33b7fce5cb611ec6f940d4ec2508c8a2b8d72f91e9a2a9a812a3b48d72f60dfefd642fb7cf3fe138
-  data.tar.gz: 4c653acb6d7aa90d534a7d496568fca64fb9ba9bce9039c6ca68fad71c1b5aef3f4e5de541a3f3d0f6064f08653359bcc2afc30e3a2d82c910942f0c1e103d4a
+  metadata.gz: 15bbdc2faf14f1e2684a9c3f27ee5fec193c34cd3342d9910e3a617ba9ea113e3e221904fb0d736c842465f4bbbe59d1d293b32cce2f820f954156fc36ae41d4
+  data.tar.gz: c47fbd431496ab36cbc3d7c0b1cc5a0360ba6433cfc1aef1efce12b14a793f7ea7cda443da2e27edcde88604de3c203aa911ce5846e9acf2361bf35bc4fe25b9

data/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes are documented here. The project follows Semantic Versioning
 
 ## [Unreleased]
 
+## [1.1.1] - 2026-08-11
+
+### Changed
+
+- the Rails install generator now writes every public configuration option with explanatory English comments;
+- the official `https://chronosmonitor.com.br` endpoint is now the default host when applications omit `config.host`;
+- generated initializers no longer read `CHRONOS_HOST`, while explicit `config.host` assignments remain supported.
+
 ## [1.1.0] - 2026-08-05
 
 ### Added

data/README.md

@@ -1,6 +1,6 @@
 # Chronos Ruby
 
-Chronos Ruby 1.1.0 é 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.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.
 
 ## 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.0 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.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.
 
 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.0"
+gem "chronos-ruby", "~> 1.1.1"
 ```
 
 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.0
+gem install chronos-ruby -v 1.1.1
 ```
 
 ## Instalação em Rails
@@ -54,7 +54,7 @@ gem install chronos-ruby -v 1.1.0
 Obrigatório: carregue a integração Rails explicitamente para manter Rails/ActiveSupport fora de aplicações Ruby puras.
 
 ```ruby
-gem "chronos-ruby", "~> 1.1.0", :require => "chronos/rails"
+gem "chronos-ruby", "~> 1.1.1", :require => "chronos/rails"
 ```
 
 Gere o initializer:
@@ -67,7 +67,8 @@ A Versão 0.5 introduziu Railtie, middleware e subscribers idempotentes por APIs
 
 ## Configuração mínima
 
-Obrigatório quando o agente está habilitado: `project_id`, `project_key` e `host` HTTPS. Recomendado: definir ambiente e serviço explicitamente.
+Obrigatório quando o agente está habilitado: `project_id` e `project_key`. O `host` usa
+`https://chronosmonitor.com.br` por padrão. Recomendado: definir ambiente e serviço explicitamente.
 
 ```ruby
 require "chronos"
@@ -75,7 +76,7 @@ require "chronos"
 Chronos.configure do |config|
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  config.host = "https://chronos.example.com"
+  config.host = "https://chronosmonitor.com.br"
   config.environment = ENV["APP_ENV"] || "production"
   config.service_name = "billing"
   config.app_version = ENV["APP_VERSION"]
@@ -208,7 +209,7 @@ A versão `0.6.0.pre.1` introduziu middleware Sidekiq 4/5; a API estável manté
 
 ```ruby
 gem "sidekiq", "~> 5.0"
-gem "chronos-ruby", "~> 1.1.0", :require => "chronos/sidekiq"
+gem "chronos-ruby", "~> 1.1.1", :require => "chronos/sidekiq"
 ```
 
 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).

data/docs/configuration.md

@@ -6,7 +6,7 @@
 |---|---:|---|---|
 | `project_id` | Yes when enabled | `nil` | Public project identifier included in the envelope |
 | `project_key` | Yes when enabled | `nil` | Secret authentication key sent only as an HTTP header |
-| `host` | Yes when enabled | `nil` | Absolute Chronos HTTP endpoint; HTTPS is required by default |
+| `host` | Optional | `https://chronosmonitor.com.br` | Absolute Chronos HTTP endpoint; HTTPS is required by default |
 | `environment` | Recommended | `production` | Application environment |
 | `app_version` | Optional | `nil` | Application release/version identifier |
 | `service_name` | Recommended | `nil` | Logical service name |

data/lib/chronos/configuration.rb

@@ -23,6 +23,7 @@ module Chronos
   class Configuration
     include Internal::ConfigurationValidation
     include Internal::ApmConfigurationValidation
+    DEFAULT_HOST = "https://chronosmonitor.com.br".freeze
     DEFAULT_BLOCKLIST_KEYS = %w(
       password password_confirmation passwd secret api_key apikey authorization
       token access_token refresh_token private_key client_secret cookie set-cookie
@@ -105,7 +106,7 @@ module Chronos
     def initialize_core_defaults
       @project_id = nil
       @project_key = nil
-      @host = nil
+      @host = DEFAULT_HOST
       @environment = "production"
       @app_version = nil
       @service_name = nil

data/lib/chronos/version.rb

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

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

@@ -1,20 +1,166 @@
 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.
 Chronos.configure do |config|
-  # Chronos reads only the environment variables explicitly selected here.
+  # Identifies the project that will receive monitoring events.
   config.project_id = ENV["CHRONOS_PROJECT_ID"]
+  # Authenticates event delivery. Keep this value in a secret manager.
   config.project_key = ENV["CHRONOS_PROJECT_KEY"]
-  config.host = ENV["CHRONOS_HOST"]
+  # 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
-  config.service_name = ENV["CHRONOS_SERVICE_NAME"]
+  # Identifies the deployed application version.
   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)
 
-  # Safe legacy defaults: test and console integrations remain disabled.
-  config.rails_capture_in_test = false
+  # 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
 end
 
-# Safe when the Railtie already ran or will run later; installation is idempotent.
+# Installation is idempotent, regardless of when the Railtie was evaluated.
 Chronos::Rails::Installer.new.install(Rails.application)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chronos-ruby
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Antonio Jefferson
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-05 00:00:00.000000000 Z
+date: 2026-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler