cirron 0.2.9 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e8d1c23ccd7fd4048aeb66e99872feece2af74b94efb711459cc8eab1b9b97f
-  data.tar.gz: 78cfa7c9ffcb276bd17360e30796b1158ad015ae09c39d8cef01ca10fca87273
+  metadata.gz: 9c007b251356de7d4d30dc444f70ce6440b1df51aca80292e1d4f1f6be1f282f
+  data.tar.gz: 168cf0a7b01bf1bf59bcbeba407be5580dfe3f6634f676527284e912eb1e3f8b
 SHA512:
-  metadata.gz: 285ba864a24717610ba6e0322a55c491a62d22dc6f0c098ec17853a36eb5e6d4b26f33f05c162b8511e1ec7bad8feb229d49f96400f32462b9bbbdabc5897d6c
-  data.tar.gz: 38de94ae0f78f8751fbfb24f62f2eb9ffeb321345c9ae8eb78c187499af07f2b11b5dd06bfcc6e22b552ceb9bb9a6662a7579bff2b39ecd061f2b8dfbecb442d
+  metadata.gz: 10db47d299a3200ccf6f7e4b7d76825fd1d5433b865b5bdc73f3d0ac1a99198b0b1f2ea340545de3519d087aa42adf4d7dc87cb14bf2e580cdf05e8d3151fc48
+  data.tar.gz: 4b4cbf8ffeb1c032cbd329eb7717d5caa878c2919010e227dac5bd06b78e9c81613052e8276bc98569af8bafdc3ca658223e27ee46f825f92812e39684e737cf

data/README.md

@@ -16,20 +16,19 @@ It can also trace syscalls using +strace+, Linux only!
 
 === Performance Counters
   $ sudo irb
-  irb> require 'cirron'
-
-  # Start collecting performance metrics
-  irb> counters = Cirron::collector do
-  irb>  # Your code here
-  irb>  puts "Hello"
-  irb> end
-  => Counter(time_enabled_ns: 0, instruction_count: 39066, branch_misses: 546, page_faults: 0)
+  irb(main):001> require 'cirron'
+  => true
+  irb(main):002* c = Cirron::collector do
+  irb(main):003*   puts "Hello"
+  irb(main):004> end
+  Hello
+  => Counter(time_enabled_ns: 110260, instruction_count: 15406, branch_misses: 525, page_faults: 0)
 
 === Syscalls
 
   $ sudo irb
   irb> require 'cirron'
-
+  => true
   irb> trace = Cirron::tracer do
   irb>  # Your code here
   irb>  puts "Hello"

data/cirron.gemspec

@@ -6,7 +6,7 @@ require 'pathname'
 
 Gem::Specification.new do |spec|
   spec.name = "cirron"
-  spec.version = "0.2.9"
+  spec.version = "0.3.1"
   spec.authors = ["Matt Stuchlik"]
   spec.email = ["matej.stuchlik@gmail.com"]
 
@@ -33,10 +33,4 @@ Gem::Specification.new do |spec|
   spec.bindir = "exe"
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
 end

data/lib/cirronlib.cpp

@@ -123,7 +123,7 @@ int start()
     // load pmc db
     int ret = 0;
     kpep_db *db = NULL;
-    if ((ret = kpep_db_create("a9", &db)))
+    if ((ret = kpep_db_create(NULL, &db)))
     {
         printf("Error: cannot load pmc database: %d.\n", ret);
         return 1;

data/lib/collector.rb

@@ -46,6 +46,17 @@ class Counter < FFI::Struct
 end
 
 module Cirron
+  @overhead = {}
+
+  def self.calculate_overhead
+    10.times do
+      counter = collector(measure_overhead: false) {}
+      Counter.members.each do |field|
+        @overhead[field] = [@overhead[field], counter[field]].compact.min
+      end
+    end
+  end
+
   def self.start
     ret_val = CirronInterOp.start
     if ret_val == -1
@@ -58,13 +69,22 @@ module Cirron
     CirronInterOp.end(fd, counter)
   end
 
-  def self.collector(&blk)
+  def self.collector(measure_overhead: true, &blk)
+    calculate_overhead if measure_overhead && @overhead.empty?
+
     counter = Counter.new
     ret_val = self.start
 
     yield
 
     self.end(ret_val, counter)
+
+    if measure_overhead && !@overhead.empty?
+      Counter.members.each do |field|
+        counter[field] = [counter[field] - @overhead[field], 0].max
+      end
+    end
+
     counter
   end
 end

data/lib/tracer.rb

@@ -73,8 +73,8 @@ def parse_strace(file)
 end
 
 def filter_trace(trace, marker_path)
-  start_index = trace.index { |event| event.args.include?(marker_path) }
-  end_index = trace.rindex { |event| event.args.include?(marker_path) }
+  start_index = trace.index { |event| event.is_a?(Syscall) && event.args.include?(marker_path) }
+  end_index = trace.rindex { |event| event.is_a?(Syscall) && event.args.include?(marker_path) }
 
   if start_index && end_index
     trace[start_index + 1...end_index]

metadata

@@ -1,32 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: cirron
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.3.1
 platform: ruby
 authors:
 - Matt Stuchlik
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-07-06 00:00:00.000000000 Z
+date: 2024-07-09 00:00:00.000000000 Z
 dependencies: []
 description: "= Cirron\n\nCirron measures a piece of Ruby code and reports back several
   performance counters: \nCPU instruction count, branch misses, page faults and time
   spent measuring. \nIt uses the Linux perf events interface or @ibireme's KPC demo[https://gist.github.com/ibireme/173517c208c7dc333ba962c1f0d67d12]
   on OSX.\n\nIt can also trace syscalls using +strace+, Linux only!\n\n== Prerequisites\n\n
   \ - Linux with perf events support / Apple ARM OSX\n  - C++\n  - Ruby 3.x\n\n==
-  Usage\n\n=== Performance Counters\n  $ sudo irb\n  irb> require 'cirron'\n\n  #
-  Start collecting performance metrics\n  irb> counters = Cirron::collector do\n  irb>
-  \ # Your code here\n  irb>  puts \"Hello\"\n  irb> end\n  => Counter(time_enabled_ns:
-  0, instruction_count: 39066, branch_misses: 546, page_faults: 0)\n\n=== Syscalls\n\n
-  \ $ sudo irb\n  irb> require 'cirron'\n\n  irb> trace = Cirron::tracer do\n  irb>
-  \ # Your code here\n  irb>  puts \"Hello\"\n  irb> end\n  => [#<Syscall:0x00007c6c1a4b3608
-  @args=\"1, [{iov_base=\\\"Hello\\\", iov_len=5}, {iov_base=\\\"\\\\n\\\", iov_len=1}],
-  2\", @duration=\"0.000201\", @name=\"writev\", @pid=\"2261962\", @retval=\"6\",
-  @timestamp=\"1720285300.334976\">]\n  # Save the trace for ingesting to Perfetto\n
-  \ irb> File.write(\"/tmp/trace\", Cirron::to_tef(trace))\n  => 267\n\n== Additional
-  Information\n\nFor more detailed information, please visit the project's GitHub
-  page: https://github.com/s7nfo/Cirron"
+  Usage\n\n=== Performance Counters\n  $ sudo irb\n  irb(main):001> require 'cirron'\n
+  \ => true\n  irb(main):002* c = Cirron::collector do\n  irb(main):003*   puts \"Hello\"\n
+  \ irb(main):004> end\n  Hello\n  => Counter(time_enabled_ns: 110260, instruction_count:
+  15406, branch_misses: 525, page_faults: 0)\n\n=== Syscalls\n\n  $ sudo irb\n  irb>
+  require 'cirron'\n  => true\n  irb> trace = Cirron::tracer do\n  irb>  # Your code
+  here\n  irb>  puts \"Hello\"\n  irb> end\n  => [#<Syscall:0x00007c6c1a4b3608 @args=\"1,
+  [{iov_base=\\\"Hello\\\", iov_len=5}, {iov_base=\\\"\\\\n\\\", iov_len=1}], 2\",
+  @duration=\"0.000201\", @name=\"writev\", @pid=\"2261962\", @retval=\"6\", @timestamp=\"1720285300.334976\">]\n
+  \ # Save the trace for ingesting to Perfetto\n  irb> File.write(\"/tmp/trace\",
+  Cirron::to_tef(trace))\n  => 267\n\n== Additional Information\n\nFor more detailed
+  information, please visit the project's GitHub page: https://github.com/s7nfo/Cirron"
 email:
 - matej.stuchlik@gmail.com
 executables: []