cirron 0.2.5 → 0.2.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +6 -3
- data/cirron.gemspec +1 -1
- metadata +10 -10
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3c6c65fcba8e45502f5b64fc1ed150c3685ac487d788309d45c81be29a028da2
|
4
|
+
data.tar.gz: b3c3d949d138853c0f5a7bf46fd8fe9ebf83bb957d72d28087b059686a14a122
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: c9f45039a22835fd70ada492f8ad3bf85358f8186d4088886e52cf7ba8bab3e65fab566c6992a6cc6602ce9b9c7a0b2e1426590a263d414b94aebcf0cffe2c94
|
7
|
+
data.tar.gz: 5aa6c080a082f99090f613f37455a3e3f4afeff43a4e04a303aff42e130fb49a8d413afb8b1223a110dc44087c7ee6dcdaeb7a8f0a08869f924035ba5a038cba
|
data/README.md
CHANGED
@@ -1,12 +1,14 @@
|
|
1
|
-
|
1
|
+
= Cirron
|
2
2
|
|
3
3
|
Cirron measures a piece of Ruby code and reports back several performance counters:
|
4
4
|
CPU instruction count, branch misses, page faults and time spent measuring.
|
5
5
|
It uses the Linux perf events interface or @ibireme's KPC demo[https://gist.github.com/ibireme/173517c208c7dc333ba962c1f0d67d12] on OSX.
|
6
6
|
|
7
|
+
---
|
7
8
|
|
8
9
|
It can also trace syscalls using +strace+, Linux only!
|
9
10
|
|
11
|
+
---
|
10
12
|
|
11
13
|
== Prerequisites
|
12
14
|
|
@@ -14,12 +16,12 @@ It can also trace syscalls using +strace+, Linux only!
|
|
14
16
|
* C++
|
15
17
|
* Ruby 3.x
|
16
18
|
|
19
|
+
---
|
17
20
|
|
18
21
|
== Usage
|
19
22
|
|
20
23
|
=== Performance Counters
|
21
24
|
|
22
|
-
|
23
25
|
require 'cirron'
|
24
26
|
|
25
27
|
# Start collecting performance metrics
|
@@ -31,10 +33,10 @@ It can also trace syscalls using +strace+, Linux only!
|
|
31
33
|
# Retrieve the metrics
|
32
34
|
puts collector.counters
|
33
35
|
|
36
|
+
---
|
34
37
|
|
35
38
|
=== Syscalls
|
36
39
|
|
37
|
-
|
38
40
|
require 'cirron'
|
39
41
|
|
40
42
|
Cirron::Tracer.new do |tracer|
|
@@ -48,6 +50,7 @@ It can also trace syscalls using +strace+, Linux only!
|
|
48
50
|
# Save the trace for ingesting to Perfetto
|
49
51
|
File.write("/tmp/trace", Cirron.to_tef(trace))
|
50
52
|
|
53
|
+
---
|
51
54
|
|
52
55
|
== Additional Information
|
53
56
|
|
data/cirron.gemspec
CHANGED
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: cirron
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.2.
|
4
|
+
version: 0.2.6
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Matt Stuchlik
|
@@ -10,17 +10,17 @@ bindir: exe
|
|
10
10
|
cert_chain: []
|
11
11
|
date: 2024-07-06 00:00:00.000000000 Z
|
12
12
|
dependencies: []
|
13
|
-
description: "
|
13
|
+
description: "= Cirron\n\nCirron measures a piece of Ruby code and reports back several
|
14
14
|
performance counters: \nCPU instruction count, branch misses, page faults and time
|
15
15
|
spent measuring. \nIt uses the Linux perf events interface or @ibireme's KPC demo[https://gist.github.com/ibireme/173517c208c7dc333ba962c1f0d67d12]
|
16
|
-
on OSX.\n\n\nIt can also trace syscalls using +strace+, Linux only!\n\n\n==
|
17
|
-
Linux with perf events support / Apple ARM OSX\n* C++\n* Ruby
|
18
|
-
Performance Counters\n\n
|
19
|
-
metrics\n Cirron::Collector.new do |collector|\n #
|
20
|
-
\ end\n\n # Retrieve the metrics\n puts collector.counters\n\n\n===
|
21
|
-
\
|
22
|
-
...\n end\n\n # Stop collecting and retrieve the trace\n puts tracer.trace\n\n
|
23
|
-
\ # Save the trace for ingesting to Perfetto\n File.write(\"/tmp/trace\", Cirron.to_tef(trace))\n\n\n==
|
16
|
+
on OSX.\n\n---\n\nIt can also trace syscalls using +strace+, Linux only!\n\n---\n\n==
|
17
|
+
Prerequisites\n\n* Linux with perf events support / Apple ARM OSX\n* C++\n* Ruby
|
18
|
+
3.x\n\n---\n\n== Usage\n\n=== Performance Counters\n\n require 'cirron'\n\n #
|
19
|
+
Start collecting performance metrics\n Cirron::Collector.new do |collector|\n #
|
20
|
+
Your code here\n # ...\n end\n\n # Retrieve the metrics\n puts collector.counters\n\n---\n\n===
|
21
|
+
Syscalls\n\n require 'cirron'\n\n Cirron::Tracer.new do |tracer|\n # Your code
|
22
|
+
here\n # ...\n end\n\n # Stop collecting and retrieve the trace\n puts tracer.trace\n\n
|
23
|
+
\ # Save the trace for ingesting to Perfetto\n File.write(\"/tmp/trace\", Cirron.to_tef(trace))\n\n---\n\n==
|
24
24
|
Additional Information\n\nFor more detailed information, please visit the project's
|
25
25
|
GitHub page: https://github.com/s7nfo/Cirron"
|
26
26
|
email:
|