exis_ray 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37c492f253a0a6899c05e68bb34b2d3f2f2bb90a4ee94a205e602fd821aa7a65
-  data.tar.gz: dac186ccd577e7171655656029db9ab1d3dfe52bc6b5b005f61821f50a99259d
+  metadata.gz: 1fd6ad63299e12bd9398e3ccc0436ee48d70f21705cfbdfac492fc97a8fda5af
+  data.tar.gz: 6cea90be719f5d1b85a9dee5cd281ba24cde652b76f6e16b1f07aa3da72ea255
 SHA512:
-  metadata.gz: 54fcb9e9ffe4172373089e229942d960bf60d9a64b36c34ed5080acac7458fb6013f8d647eac6de4f2c702eca45491e905cf8728bd6982483ecb419a62745df7
-  data.tar.gz: d2921731f064a4d1216a402de59bc915cfec98eeea8671d17a4ce39340b1f1180d2795d75e165827072cc16b2d363f9437826626a2f14e4b79316bd7ea202c12
+  metadata.gz: cbb1b60e287ba40f586c8404d4e5c9914b318090cffb1d0fc9d12ac8c27498004b019190eaaf33cfe35bb63927a016dc26a5973990401e32f0a6b4be69e7b43d
+  data.tar.gz: 806578528228d964297e68109f75f6485f901bc22919e04d22cb2a794348d9687f9f1c235441756e245f14cd60eaad41b3898c4fc4ed21328c7e3a023dce8fd1

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [0.3.2] - 2026-03-23
+
+### Added
+- **Global `source` field:** Introduced a standardized `source` field in JSON logs to identify the entry point of execution (`http`, `sidekiq`, or `task`).
+- This facilitates global filtering and dashboard creation in observability platforms.
+
+## [0.3.1] - 2026-03-23
+
+### Changed
+- **Standardized Service Name:** The `service` field in logs now always returns the Rails application name in `snake_case` (e.g., `cold_storage_service`).
+- Removed dynamic service name overrides in `HttpMiddleware`, `Sidekiq::ServerMiddleware`, and `TaskMonitor`.
+- **Enhanced Job/Task Visibility:** Added `sidekiq_job` and `task` fields to the JSON logs, providing specific context without overloading the `service` field.
+
 ## [0.3.0] - 2026-03-23
 
 ### Added

data/lib/exis_ray/http_middleware.rb

@@ -4,13 +4,12 @@ module ExisRay
   class HttpMiddleware
     def initialize(app)
       @app = app
-      @base_service_name = defined?(Rails) ? Rails.application.class.module_parent_name : 'App'
     end
 
     def call(env)
       # 1. Hidratar Infraestructura
-      ExisRay::Tracer.created_at   = Time.now.utc.to_f
-      ExisRay::Tracer.service_name = "#{@base_service_name}-HTTP"
+      ExisRay::Tracer.created_at = Time.now.utc.to_f
+      ExisRay::Tracer.source     = "http"
 
       trace_header_key = ExisRay.configuration.trace_header
 

data/lib/exis_ray/json_formatter.rb

@@ -53,6 +53,9 @@ module ExisRay
 
       payload[:root_id]  = ExisRay::Tracer.root_id
       payload[:trace_id] = ExisRay::Tracer.trace_id if ExisRay::Tracer.trace_id
+      payload[:sidekiq_job] = ExisRay::Tracer.sidekiq_job if ExisRay::Tracer.sidekiq_job
+      payload[:task] = ExisRay::Tracer.task if ExisRay::Tracer.task
+      payload[:source] = ExisRay::Tracer.source if ExisRay::Tracer.source
     end
 
     # Inyecta el contexto de negocio (ID de usuario, ISP, ID de correlación) en el payload.

data/lib/exis_ray/sidekiq/server_middleware.rb

@@ -45,7 +45,8 @@ module ExisRay
       # @return [void]
       def hydrate_tracer(worker, job)
         ExisRay::Tracer.created_at = Time.now.utc.to_f
-        ExisRay::Tracer.service_name = "Sidekiq-#{worker.class.name}"
+        ExisRay::Tracer.sidekiq_job = worker.class.name
+        ExisRay::Tracer.source      = "sidekiq"
 
         if job["exis_ray_trace"]
           # Continuidad: Usamos la traza propagada desde el cliente (Web/Cron)

data/lib/exis_ray/task_monitor.rb

@@ -52,7 +52,8 @@ module ExisRay
     # @param task_name [String, Symbol] El nombre de la tarea en ejecución.
     # @return [void]
     def self.setup_tracer(task_name)
-      ExisRay::Tracer.service_name = task_name.to_s.tr(":", "-").camelize
+      ExisRay::Tracer.task         = task_name.to_s
+      ExisRay::Tracer.source       = "task"
       ExisRay::Tracer.request_id   = SecureRandom.uuid
       ExisRay::Tracer.created_at   = Time.now.utc.to_f
 

data/lib/exis_ray/tracer.rb

@@ -10,14 +10,14 @@ module ExisRay
   #
   # @see https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html Documentación de AWS X-Ray
   class Tracer < ActiveSupport::CurrentAttributes
-    attribute :trace_id, :request_id, :root_id, :self_id, :called_from, :total_time_so_far, :created_at, :service_name
+    attribute :trace_id, :request_id, :root_id, :self_id, :called_from, :total_time_so_far, :created_at, :sidekiq_job, :task, :source
 
-    # Devuelve el nombre del servicio actual.
-    # Si no se ha definido manualmente, hace fallback al nombre de la aplicación Rails.
+    # Devuelve el nombre de la aplicación en snake_case (ej: "cold_storage_service").
+    # Se utiliza como identificador global del servicio en logs y trazabilidad.
     #
-    # @return [String] El nombre del servicio (ej: "Wispro", "Wispro-Worker", "App").
+    # @return [String]
     def self.service_name
-      super || (defined?(Rails) ? Rails.application.class.module_parent_name : 'App')
+      @service_name ||= (defined?(Rails) ? Rails.application.class.module_parent_name.underscore : "app")
     end
 
     # Genera un ID de correlación compuesto, útil para logs y auditoría.

data/lib/exis_ray/version.rb

@@ -2,5 +2,5 @@
 
 module ExisRay
   # Versión actual de la gema.
-  VERSION = "0.3.0"
+  VERSION = "0.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exis_ray
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Gabriel Edera