@node-projects/speedscope 2.1.0 → 2.2.0
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.
- package/README.md +47 -6
- package/dist/release/file-format-schema.json +6 -0
- package/dist/release/index.html +1 -1
- package/dist/release/re2js.LICENSE +21 -0
- package/dist/release/release.txt +3 -3
- package/dist/release/speedscope-5DZPH3NW.js +244 -0
- package/docs/IMPORT_FORMATS.md +174 -0
- package/docs/JAVA_THREAD_DUMPS.md +8 -3
- package/docs/JAVA_THREAD_DUMP_ZIP.md +65 -0
- package/docs/LARGE_TRACE_PERFORMANCE.md +72 -0
- package/docs/OTEL_PROFILES.md +117 -0
- package/docs/PERF_IMPORT.md +66 -0
- package/docs/PPROF_IMPORT.md +50 -0
- package/docs/PROFILE_COMPARISON.md +118 -0
- package/docs/PROPERTY_TESTS.md +36 -0
- package/docs/PYTHON_CPROFILE.md +25 -0
- package/docs/RELEASING.md +19 -6
- package/docs/SEARCH_AND_LAYOUT.md +128 -3
- package/docs/SINGLE_FILE.md +55 -0
- package/docs/SOURCE_AND_LABELS.md +116 -1
- package/package.json +14 -2
- package/src/lib/file-format-spec.ts +4 -0
- package/dist/release/speedscope-OUBBGH23.js +0 -191
package/README.md
CHANGED
|
@@ -37,6 +37,8 @@ speedscope is designed to ingest profiles from a variety of different profilers
|
|
|
37
37
|
- [Importing from rbspy](https://github.com/jlfwong/speedscope/wiki/Importing-from-rbspy-(ruby))
|
|
38
38
|
- [Importing from ruby-prof](https://github.com/jlfwong/speedscope/wiki/Importing-from-ruby-prof)
|
|
39
39
|
- Python
|
|
40
|
+
- [Native cProfile `.prof` / `.pstats` / `.cprofile` statistics](docs/PYTHON_CPROFILE.md): flat self time and explicit immediate-caller projections, without invented full stacks.
|
|
41
|
+
- Python 3.15 `profiling.sampling --collapsed`: import the folded text output. Thread IDs remain stack roots and weights remain raw observation counts; see [format coverage](sample/profiles/python-sampling/README.md).
|
|
40
42
|
- [Importing from py-spy](https://github.com/jlfwong/speedscope/wiki/Importing-from-py-spy-(python))
|
|
41
43
|
- [pyspeedscope](https://github.com/windelbouwman/pyspeedscope)
|
|
42
44
|
- [Importing from Austin](https://github.com/P403n1x87/austin-python#format-conversion)
|
|
@@ -44,6 +46,7 @@ speedscope is designed to ingest profiles from a variety of different profilers
|
|
|
44
46
|
- PHP
|
|
45
47
|
- [Importing from phpspy or sj-i/php-profiler](https://github.com/sj-i/php-profiler/pull/101)
|
|
46
48
|
- Go
|
|
49
|
+
- [Signed pprof heap deltas and contribution-pair comparison](docs/PPROF_IMPORT.md)
|
|
47
50
|
- [Importing from pprof](https://github.com/jlfwong/speedscope/wiki/Importing-from-pprof-(go))
|
|
48
51
|
- Rust
|
|
49
52
|
- [flamescope](https://github.com/coolreader18/flamescope)
|
|
@@ -52,31 +55,52 @@ speedscope is designed to ingest profiles from a variety of different profilers
|
|
|
52
55
|
](https://github.com/jlfwong/speedscope/wiki/Importing-from-async%E2%80%90profiler-(Java))
|
|
53
56
|
- [Importing from Java Flight Recorder](https://github.com/jlfwong/speedscope/wiki/Importing-from-Java-Flight-Recorder)
|
|
54
57
|
- [Importing Java thread dumps (`jstack` / `Thread.print`)](docs/JAVA_THREAD_DUMPS.md)
|
|
58
|
+
- [Importing ZIP archives of Java thread-dump snapshots](docs/JAVA_THREAD_DUMP_ZIP.md)
|
|
59
|
+
- Android
|
|
60
|
+
- [Classic Android method traces (versions 1–3)](docs/IMPORT_FORMATS.md#classic-android-method-traces)
|
|
61
|
+
- OpenTelemetry
|
|
62
|
+
- [Current OTLP Profiles JSON (sampled stacks)](docs/OTEL_PROFILES.md)
|
|
55
63
|
- Erlang/Elixir
|
|
56
64
|
- [eflambe](https://github.com/Stratus3D/eflambe)
|
|
57
65
|
- Native code
|
|
58
66
|
- [Importing from Instruments.app](https://github.com/jlfwong/speedscope/wiki/Importing-from-Instruments.app) (macOS)
|
|
59
67
|
- [Importing from `perf`](https://github.com/jlfwong/speedscope/wiki/Importing-from-perf-(linux)) (linux)
|
|
68
|
+
— see [period weights, CPU time and inferred timelines](docs/PERF_IMPORT.md).
|
|
60
69
|
- [Importing from .NET Core](https://github.com/jlfwong/speedscope/wiki/Importing-from-.NET-Core)
|
|
61
70
|
- [Importing from GHC (Haskell)](https://github.com/jlfwong/speedscope/wiki/Importing-from-Haskell)
|
|
62
71
|
- [Importing from custom sources](https://github.com/jlfwong/speedscope/wiki/Importing-from-custom-sources)
|
|
72
|
+
- [Differential folded files](docs/PROFILE_COMPARISON.md#differential-folded-files), using explicit import to preserve ordinary numeric symbol names.
|
|
73
|
+
- [Producer frame colors](docs/SOURCE_AND_LABELS.md), with theme contrast adaptation and exact RGB export.
|
|
63
74
|
|
|
64
75
|
Contributions to add support for additional formats are welcome! Open an issue in
|
|
65
|
-
[this fork](https://github.com/node-projects/speedscope/issues).
|
|
66
|
-
|
|
76
|
+
[this fork](https://github.com/node-projects/speedscope/issues). Upstream importer
|
|
77
|
+
guides remain useful for their formats; [fork-specific import behavior](docs/IMPORT_FORMATS.md)
|
|
78
|
+
documents the Android, archive, pprof and background-import policies.
|
|
67
79
|
# Usage
|
|
68
80
|
|
|
69
81
|
Visit [the hosted app](https://node-projects.github.io/speedscope/), then browse for a
|
|
70
82
|
profile file or drag it onto the page. Imported profiles stay in your browser.
|
|
71
83
|
After a successful online visit, the hosted app can reopen offline and import a
|
|
72
84
|
local recording. See [offline use and update behavior](docs/OFFLINE.md).
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
85
|
+
Repository builds can also produce a self-contained HTML document with
|
|
86
|
+
`npm run build:single-file`; see [single-file builds and CSP](docs/SINGLE_FILE.md).
|
|
87
|
+
|
|
88
|
+
Recordings of at least 1 MiB use a background importer when workers are available,
|
|
89
|
+
including perf, folded stacks, pprof, JFR, Android traces and renamed captures.
|
|
90
|
+
Recognized gzip perf/folded/text files prefer a worker even when compressed
|
|
91
|
+
below 1 MiB.
|
|
92
|
+
Progress and **Cancel import** keep the app responsive. Supported perf/folded text
|
|
93
|
+
and duration traces stream plain/gzip input; generic fallback formats still
|
|
94
|
+
materialize their input. Final profile models remain proportional to recording
|
|
95
|
+
size. Very large captures can
|
|
76
96
|
still exceed browser memory limits. Search offers Contains, Whole word and Exact
|
|
77
|
-
matching for function names and source paths.
|
|
97
|
+
matching for function names and source paths. **Regex (RE2)** supports bounded,
|
|
98
|
+
linear-time regular-expression matching; unsupported syntax shows an error.
|
|
99
|
+
See [regex syntax and resource limits](docs/SEARCH_AND_LAYOUT.md#regular-expression-search).
|
|
78
100
|
Graph-search navigation retains at most 10,000 results and clearly marks larger
|
|
79
101
|
result sets; refine the query to narrow them. Symbol/highlight caches are bounded.
|
|
102
|
+
Chart search's **Zoom to match** refocuses a selected result after panning or
|
|
103
|
+
zooming out, while keeping measured frame widths unchanged.
|
|
80
104
|
Use **Profile actions → Filter frames…** to include your code or exclude framework
|
|
81
105
|
frames by file path or name. It creates a separate aggregate profile and keeps the
|
|
82
106
|
original available. See [filter rules and weight semantics](docs/PROFILE_FILTERS.md).
|
|
@@ -84,6 +108,16 @@ Choose **Profile actions → Search all profiles…** to find functions across t
|
|
|
84
108
|
and open a result in its original profile. Sandwich's table and caller/callee
|
|
85
109
|
panes can now be resized with draggable or keyboard-operated dividers. See
|
|
86
110
|
[search and layout controls](docs/SEARCH_AND_LAYOUT.md).
|
|
111
|
+
Choose **Profile actions → Compare profiles…** to compare a baseline and candidate,
|
|
112
|
+
including a second local recording. The differential flamegraph and paged table
|
|
113
|
+
show signed total/self changes, with absolute or normalized weights. Both inputs
|
|
114
|
+
remain in memory while comparing; graph rendering and comparison preparation have
|
|
115
|
+
explicit limits. See [comparison semantics and limits](docs/PROFILE_COMPARISON.md).
|
|
116
|
+
Use **Profile actions → Link to selected function…** to share a function selection.
|
|
117
|
+
For local recordings, the recipient opens the link and imports the same file.
|
|
118
|
+
Same-tab links and browser Back/Forward update the function selection without
|
|
119
|
+
reimporting the recording. Click the thread/profile selector to keep its chooser
|
|
120
|
+
open while selecting; it supports keyboard navigation, filtering and paging.
|
|
87
121
|
Selected-stack scope names are clickable; deep stacks page through at most 100
|
|
88
122
|
ancestors at a time to keep details responsive.
|
|
89
123
|
Window titles identify the loaded file. Sandwich shows the selected function's
|
|
@@ -92,6 +126,9 @@ full name and source, and selected-stack details explain the statistics through
|
|
|
92
126
|
**Profile actions** also offers configurable source-code links for VS Code or web
|
|
93
127
|
repositories, and compact path labels in graphs. Full names remain searchable
|
|
94
128
|
and available in details. See [source links and graph labels](docs/SOURCE_AND_LABELS.md).
|
|
129
|
+
Choose **Profile actions → Load linked source map…** to load a generated HTTP(S)
|
|
130
|
+
script's source map, review the preview and apply its original names and locations.
|
|
131
|
+
Local `.map` files can still be opened with Import after loading a recording.
|
|
95
132
|
Duration traces stream plain/gzip input and discard unused events. Oversized
|
|
96
133
|
captures stop with a clear limit error; see [import limits and measurements](docs/LARGE_TRACE_PERFORMANCE.md#streaming-duration-traces).
|
|
97
134
|
|
|
@@ -159,6 +196,10 @@ The Sandwich view is a table view in which you can find a list of all functions
|
|
|
159
196
|
|
|
160
197
|
## Navigation
|
|
161
198
|
|
|
199
|
+
**Help** opens an overlay inside the app with view descriptions, keyboard
|
|
200
|
+
shortcuts, import guidance and large-file/offline tips. Close it with Escape
|
|
201
|
+
or **Close help**; it also works without a network connection.
|
|
202
|
+
|
|
162
203
|
Function selection follows you between Time Order, Left Heavy and Sandwich;
|
|
163
204
|
each view keeps its own call instance and zoom within the active profile.
|
|
164
205
|
|
|
@@ -147,6 +147,12 @@
|
|
|
147
147
|
"title": "col",
|
|
148
148
|
"type": "number"
|
|
149
149
|
},
|
|
150
|
+
"color": {
|
|
151
|
+
"description": "Producer-selected RGB color. Presentation may adapt it for text contrast.",
|
|
152
|
+
"pattern": "^#[0-9a-fA-F]{6}$",
|
|
153
|
+
"title": "color",
|
|
154
|
+
"type": "string"
|
|
155
|
+
},
|
|
150
156
|
"file": {
|
|
151
157
|
"title": "file",
|
|
152
158
|
"type": "string"
|
package/dist/release/index.html
CHANGED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2023 Oleksii Vasyliev
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/dist/release/release.txt
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
@node-projects/speedscope@2.
|
|
2
|
-
2026-11-
|
|
3
|
-
|
|
1
|
+
@node-projects/speedscope@2.2.0
|
|
2
|
+
2026-11-21T13:54:07.001Z
|
|
3
|
+
c32c183a2eab8625106b3252db7b3ea46cddbaba
|