vernier 1.7.0 → 1.7.1
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 +18 -2
- data/lib/vernier/output/file_listing.rb +1 -1
- data/lib/vernier/output/firefox.rb +1 -1
- data/lib/vernier/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 356fbbcbb8c60616fe3a92c4eed26d7cac97f3a1e230e4904571f9666f4b64aa
|
4
|
+
data.tar.gz: cb7f9542080591e8fe680ab7f1b5688f0c5265e8d32d8ce2d8d56efab639ded0
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 2bf9a5882a9494b23c6a695836ee253a04054c501bab46b20b12b73516d7b21c103d1bb306ccb2a6ac3b5dce61d882620e6abbc53e056d0fd3e9260e68e97c44
|
7
|
+
data.tar.gz: e82f4becfb5a9e30cafebbe5271bd6b2e9883c3422eb5e61ee2ffae8589a0861f55a19b190c9d5a829894755a227438c7f4d2aa2225d55697f0f954738a49f10
|
data/README.md
CHANGED
@@ -32,7 +32,7 @@ gem "vernier", "~> 1.0"
|
|
32
32
|
|
33
33
|
## Usage
|
34
34
|
|
35
|
-
The output can be viewed in the web app at https://vernier.prof, locally using the [`profile-viewer` gem](https://github.com/tenderlove/profiler/tree/ruby) (both lightly customized versions of the
|
35
|
+
The output can be viewed in the web app at https://vernier.prof, locally using the [`profile-viewer` gem](https://github.com/tenderlove/profiler/tree/ruby) (both lightly customized versions of the Firefox profiler frontend which profiles are compatible with), or by using the `vernier view` command in the CLI.
|
36
36
|
|
37
37
|
- **Flame Graph**: Shows proportionally how much time is spent within particular stack frames. Frames are grouped together, which means that x-axis / left-to-right order is not meaningful.
|
38
38
|
- **Stack Chart**: Shows the stack at each sample with the x-axis representing time and can be read left-to-right.
|
@@ -133,10 +133,26 @@ ruby -r vernier -e 'Vernier.trace_retained(out: "irb_profile.json") { require "i
|
|
133
133
|
| `mode` | N/A | Sampling mode: `:wall`, `:retained`, or `:custom`. | `:wall` (`:wall`) |
|
134
134
|
| `out` | N/A | File to write the profile to. | N/A (Auto-generated) |
|
135
135
|
| `interval` | `vernier_interval` | Sampling interval (µs). Only in `:wall` mode. | `500` (`200`) |
|
136
|
-
| `allocation_interval` | `vernier_allocation_interval` | Allocation sampling interval. Only in `:wall` mode. | `0
|
136
|
+
| `allocation_interval` | `vernier_allocation_interval` | Allocation sampling interval. Only in `:wall` mode. | `0` i.e. disabled (`200`) |
|
137
137
|
| `gc` | N/A | Run full GC cycle before profiling. Only in `:retained` mode. | `true` (N/A) |
|
138
138
|
| `metadata` | N/A | Metadata key-value pairs to include in the profile. | `{}` (N/A) |
|
139
139
|
|
140
|
+
#### Hook options
|
141
|
+
|
142
|
+
Vernier offers some optional hooks:
|
143
|
+
|
144
|
+
- `:rails` / `:activesupport` - Adds selected Active Support event markers to the Firefox output
|
145
|
+
|
146
|
+
- `:memory_usage` - Adds a memory usage counter to the Firefox output
|
147
|
+
|
148
|
+
Usage example:
|
149
|
+
|
150
|
+
```ruby
|
151
|
+
Vernier.profile(out: "time_profile.json", hooks: [:rails, :memory_usage]) do
|
152
|
+
# ...
|
153
|
+
end
|
154
|
+
```
|
155
|
+
|
140
156
|
## Development
|
141
157
|
|
142
158
|
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
data/lib/vernier/version.rb
CHANGED
metadata
CHANGED
@@ -1,13 +1,13 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: vernier
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.7.
|
4
|
+
version: 1.7.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- John Hawthorn
|
8
8
|
bindir: exe
|
9
9
|
cert_chain: []
|
10
|
-
date: 2025-
|
10
|
+
date: 2025-05-16 00:00:00.000000000 Z
|
11
11
|
dependencies:
|
12
12
|
- !ruby/object:Gem::Dependency
|
13
13
|
name: activesupport
|