exis_ray 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5162f50fce688356ff17e9adff2464f6bc7ba9c83ee2e3a1f662dc4568fb6d3
-  data.tar.gz: b2559412f57a487971edbf42cd0b24e18bbbe9fe33890096e8e6769647895e49
+  metadata.gz: bb94b36fd16b408d5359621e78a03c722c89dab7c087322b67c975db743ad24e
+  data.tar.gz: ef093be07091568e6bad52d26de306dd82f91fc8e8f554d4eb04a7ca8c3b1581
 SHA512:
-  metadata.gz: 9efba79f9584005d1beb8c1d749dc4efb54959aa47433a671b611cbc15ce93bb4f081f390047b736039a1fad1d621cc2d5661fb82c3f340c2f57a7bddc461f19
-  data.tar.gz: a2878c45410719109283a4a2b44201bc0b45fbe5a7ee2c70ba020a5b255392ab42af18fa52995f75e98dc4e32ae0727c718429b590daa3af797202e1488db897
+  metadata.gz: ce25522741b66f66318fa6d5223c0db754f1fe8f7eb1067a867f219988a1bc4ae78ef55c61e0895d553df955f129165af211a52dd41c86d6e3f6fe7066f7d7b2
+  data.tar.gz: 7ab403c8790dae80419260834d18787faa060bb2528d10974a4ef255bd6a0ea79c9aa837040015360db531b6114c8d99b4412c592d6749a0cba298ce24d072bc

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.4.1] - 2026-03-23
+
+### Changed
+- **Data-Driven Internal Logging:** Refactored internal library logs (boot, instrumentation, task status) from plain text messages to structured Key-Value (KV) strings.
+- This leverages the `JsonFormatter`'s KV parser to elevate fields like `component`, `event`, and `status` to the JSON root, eliminating the need for unstructured `message` fields in infrastructure logs.
+- Simplified `TaskMonitor#log_event` and `Railtie.log_boot` to emit raw KV strings directly to the logger.
+- **Improved local debugging:** The `Reporter` now uses `exception.full_message` in non-production environments to provide a more readable backtrace in the development console.
+
 ## [0.4.0] - 2026-03-23
 
 ### Breaking Changes

data/lib/exis_ray/railtie.rb

@@ -41,18 +41,14 @@ module ExisRay
         require "exis_ray/log_subscriber"
         ExisRay::LogSubscriber.install!
 
-        Rails.logger.info({ message: "[ExisRay] JSON Logging unificado activado." })
+        log_boot("component=exis_ray event=json_logging_enabled")
       end
 
       # --- Instrumentación de ActiveResource ---
       if defined?(ActiveResource::Base)
         require "exis_ray/active_resource_instrumentation"
         ActiveResource::Base.send(:prepend, ExisRay::ActiveResourceInstrumentation)
-
-        log_message(
-          text: "[ExisRay] ActiveResource instrumentado.",
-          json: { message: "[ExisRay] ActiveResource instrumentado." }
-        )
+        log_boot("component=exis_ray event=active_resource_instrumented")
       end
 
       # --- Instrumentación de Sidekiq ---
@@ -75,27 +71,21 @@ module ExisRay
           end
         end
 
-        # Sidekiq maneja su propio logger. Lo forzamos a usar nuestra estructura JSON.
         if ExisRay.configuration.json_logs? && ::Sidekiq.logger
           ::Sidekiq.logger.formatter = ExisRay::JsonFormatter.new
-          Rails.logger.info({ message: "[ExisRay] Sidekiq Middleware y JsonFormatter integrados." })
-        else
-          Rails.logger.info "[ExisRay] Sidekiq Middleware integrado."
         end
+        log_boot("component=exis_ray event=sidekiq_instrumented")
       end
     end
 
-    # Helper interno para imprimir logs de inicialización respetando el formato elegido.
+    # Emite un log de boot en DEBUG con formato key=value.
+    # En modo texto es legible directamente. En modo JSON el JsonFormatter
+    # lo parsea y eleva cada campo al nivel raíz del JSON automáticamente.
     #
-    # @param text [String] El mensaje para el formato texto.
-    # @param json [Hash] El payload para el formato JSON.
+    # @param message [String] String en formato key=value.
     # @return [void]
-    def self.log_message(text:, json:)
-      if ExisRay.configuration.json_logs?
-        Rails.logger.info(json)
-      else
-        Rails.logger.info(text)
-      end
+    def self.log_boot(message)
+      Rails.logger.debug(message)
     end
   end
 end

data/lib/exis_ray/reporter.rb

@@ -32,7 +32,7 @@ module ExisRay
       prepare_scope(context, tags, fingerprint, transaction_name)
       add_tags(exception: excep.class.to_s)
 
-      Rails.logger.error(excep) unless Rails.env.production?
+      Rails.logger.error(excep.full_message) unless Rails.env.production?
 
       if report_to_new_sentry?
         exception_to_new_sentry(excep)

data/lib/exis_ray/task_monitor.rb

@@ -29,14 +29,14 @@ module ExisRay
         curr.correlation_id = ExisRay::Tracer.correlation_id
       end
 
-      log_event(:info, "Iniciando tarea: #{task_name}", task: task_name, status: "started")
+      log_event(:info, "component=exis_ray event=task_started task=#{task_name} status=started")
 
       # Bloque de ejecución con o sin tags dependiendo de la configuración
       execute_with_optional_tags { yield }
 
-      log_event(:info, "Finalizada con éxito.", task: task_name, status: "success")
+      log_event(:info, "component=exis_ray event=task_finished task=#{task_name} status=success")
     rescue StandardError => e
-      log_event(:error, "Falló la tarea #{task_name}: #{e.message}", task: task_name, status: "failed", error: e.message)
+      log_event(:error, "component=exis_ray event=task_failed task=#{task_name} status=failed error=#{e.message.inspect}")
       raise e
     ensure
       # Limpieza centralizada obligatoria para evitar filtraciones de memoria o contexto
@@ -89,12 +89,8 @@ module ExisRay
     # @param message [String] Mensaje en texto plano para el modo clásico.
     # @param payload [Hash] Datos estructurados para el modo JSON.
     # @return [void]
-    def self.log_event(level, message, **payload)
-      if ExisRay.configuration.json_logs?
-        Rails.logger.send(level, payload.merge(message: "[ExisRay] #{message}"))
-      else
-        Rails.logger.send(level, "[ExisRay] #{message}")
-      end
+    def self.log_event(level, message)
+      Rails.logger.send(level, message)
     rescue StandardError
       # El logger nunca debe interrumpir el flujo principal de la tarea.
     end

data/lib/exis_ray/version.rb

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

metadata

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