tracelit 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: baa72093ff99cee94e4ba7221714f16691cac2907b37fc8973be2db9d58995cd
-  data.tar.gz: f18620a662414111c86741d4acf81da3add9db0577a384b973842cab3053721e
+  metadata.gz: 66ee178565bf80581941df2481fb09e981e013c335ac8a2e4c6d8845a62fb4f1
+  data.tar.gz: a40528eb98fe34dd2dd3d7399cf0e5d40ea5fd0fb83900daec8ee6728d98b846
 SHA512:
-  metadata.gz: 7a7961d36cb65b10d80b43cfecea3f767798ca5eb38d12352a8933ab2969d86d9a73d947e6d25eb0444ab1ea4374300ce215a8f34a65621b3a465f009ac24d28
-  data.tar.gz: c45e5931a15e408165258bea86c2ffd70285286a27e08e36c9dd30e0e9a705fff8ec2a2104cb35ae177a33f46379700c032bd91fd1b76d307bf2e409722df16a
+  metadata.gz: 19b1d323be4bc9f8f1cf531f9728d371537a5430a1e0f6eb82aba66af17ee20b5bddb819e83bd1b8d5f624444ac0a6afaeb68319bbdb380469f7c8ab1ea0945e
+  data.tar.gz: d8c722105fb3b85f0cab312ec82ea81a2de12fae214f9f555bfb7ce6c3929184f231c13f228b182c9c268ab62e3ee94751295b00f939347012cfa43ed797e81a

data/README.md

@@ -6,12 +6,6 @@ Official Ruby SDK for [Tracelit](https://tracelit.io) — drop-in OpenTelemetry
 
 ---
 
-## Set up with AI
-
-Want an AI assistant (Cursor, Claude, ChatGPT, etc.) to integrate Tracelit into your app automatically? Copy the contents of [`llm_prompt.txt`](./llm_prompt.txt) and paste it as your prompt. It covers gem installation, initializer setup, manual spans, custom metrics, and test guard — everything the AI needs in one shot.
-
----
-
 ## Installation
 
 Add to your `Gemfile` and run `bundle install`:
@@ -273,9 +267,6 @@ TRACELIT_ENABLED=false
 
 ---
 
-## Running the SDK's own tests
+## Changelog
 
-```bash
-bundle install
-bundle exec rspec
-```
+See the [release history](https://docs.tracelit.io/changelog) on the Tracelit docs.

data/lib/tracelit/metrics.rb

@@ -48,6 +48,7 @@ module Tracelit
       install_sidekiq_middleware      if defined?(::Sidekiq)
       install_connection_pool_poller  if defined?(::ActiveRecord)
       install_memory_poller
+      install_cpu_poller
     rescue StandardError => e
       OpenTelemetry.logger.warn("[Tracelit] failed to set up metrics: #{e.message}")
     end
@@ -62,8 +63,10 @@ module Tracelit
     def self.restart_pollers(config)
       @connection_pool_poller_installed = false
       @memory_poller_installed          = false
+      @cpu_poller_installed             = false
       install_connection_pool_poller if defined?(::ActiveRecord)
       install_memory_poller
+      install_cpu_poller
     rescue StandardError => e
       OpenTelemetry.logger.warn("[Tracelit] failed to restart pollers after fork: #{e.message}")
     end
@@ -349,5 +352,100 @@ module Tracelit
     rescue StandardError => e
       OpenTelemetry.logger.warn("[Tracelit] failed to install memory poller: #{e.message}")
     end
+
+    # Polls process CPU utilisation every 30 seconds on a daemon thread.
+    # Computes a percentage by tracking the delta in CPU time (user + system)
+    # against wall-clock elapsed time — same approach as the Go and Node SDKs.
+    #
+    # On Linux:  reads /proc/self/stat (utime + stime in jiffies at 100 Hz).
+    # On macOS:  reads `ps -o %cpu= -p <pid>` as a direct percentage.
+    #
+    # Emits: process.runtime.cpu.usage (%)
+    # Attributes: process.pid, process.runtime
+    def self.install_cpu_poller
+      return if @cpu_poller_installed
+      @cpu_poller_installed = true
+
+      cpu_gauge = @meter.create_gauge(
+        "process.runtime.cpu.usage",
+        description: "Process CPU utilisation percentage",
+        unit: "%"
+      )
+
+      pid      = Process.pid
+      linux    = File.exist?("/proc/self/stat")
+      interval = 30 # seconds
+
+      thread = Thread.new do
+        Thread.current[:tracelit_cpu_poller] = true
+
+        last_cpu_time  = read_cpu_time_s(pid, linux)
+        last_wall_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+
+        loop do
+          sleep interval
+          begin
+            now      = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+            elapsed  = now - last_wall_time
+            cpu_time = read_cpu_time_s(pid, linux)
+
+            next if elapsed <= 0 || cpu_time.nil? || last_cpu_time.nil?
+
+            delta = cpu_time - last_cpu_time
+            last_cpu_time  = cpu_time
+            last_wall_time = now
+
+            next if delta < 0
+
+            pct = [[delta / elapsed * 100.0, 100.0].min, 0.0].max
+
+            cpu_gauge.record(pct, attributes: {
+              "process.pid"     => pid.to_s,
+              "process.runtime" => "ruby",
+            })
+          rescue StandardError
+            # Retry next cycle — never crash on a metric poll failure
+          end
+        end
+      end
+      thread.abort_on_exception = false
+      thread
+    rescue StandardError => e
+      OpenTelemetry.logger.warn("[Tracelit] failed to install CPU poller: #{e.message}")
+    end
+
+    # Returns cumulative CPU time (user + system) for this process in seconds.
+    # On Linux reads /proc/self/stat; on macOS/BSD falls back to ps %cpu
+    # which gives an instantaneous percentage instead (treated as fractional
+    # seconds over a 1-second window — good enough for a 30 s gauge).
+    def self.read_cpu_time_s(pid, linux)
+      if linux
+        stat = begin
+          File.read("/proc/self/stat")
+        rescue
+          return nil
+        end
+        # Format: pid (comm) state ppid ... utime stime ...
+        # comm can contain spaces — find last ')' and split from there.
+        after_comm = stat[stat.rindex(")").to_i + 1..]
+        return nil unless after_comm
+
+        fields = after_comm.split
+        # After ')': state(0) ppid(1) ... utime(11) stime(12)
+        utime = fields[11]&.to_i
+        stime = fields[12]&.to_i
+        return nil unless utime && stime
+
+        # Jiffies at 100 Hz → seconds
+        (utime + stime) / 100.0
+      else
+        # macOS/BSD: `ps` gives current CPU % directly.
+        # Return it as a fractional "seconds per second" proxy so the
+        # delta calculation above yields the right percentage.
+        out = `ps -o %cpu= -p #{Integer(pid)} 2>/dev/null`.strip
+        return nil if out.empty?
+        out.to_f / 100.0
+      end
+    end
   end
 end

data/lib/tracelit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tracelit
-  VERSION = "0.1.7"
+  VERSION = "0.1.8"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tracelit
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - Tracelit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
+date: 2026-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-sdk