Improving automated remote connection via Inspector Protcol
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 30/100
Research direction
Start by reviewing the Inspector API entry point and the existing node inspect workflow, then compare them with the proposed RemoteSession and shortcut-command approaches. The issue is ready for implementation only after the project chooses one concrete interface for non-interactive remote profiling that meets the listed enterprise constraints.
Written by the indexing model from the issue text.
Description
The Inspector Protocol allow us to use tools like V8 CPU Profiler and Heap Snapshots without relying on C++ binding. It also allows us to call those tools remotely, which is useful when running those tools in production via an automated workflow. We can connect to the Inspector Protocol remotely using the following methods:
node inspect host:portwill open a REPL for users to run inspector commandsChrome DevTools,ndb, etc. will provide a nice UI- Connecting via pure WebSockets (for example, via websocat or ws)
1 is not useful for automation, because it doesn't allow users to run scripts (it only works interactively). 2 has similar problems (since those are GUI), plus they also enable the Debugger domain by default, which is not desirable in production. 3 is the best option for automation, but it requires extra environment setup (installing websocat, ws. etc) which is not always possible during an outage, for example.
I would like to propose an alternative: in core, provide a simple way to interact with the inspector protocol on a remote process with automation scripts. Some implementation examples would be:
- Allow users to run scripts on
node inspectinstead of opening a REPL - Allow users to connect to a remote host via the Inspector API (either via a
connectToRemoteHostmethod or with a newRemoteSessionclass) - Via shortcut commands for the tools, which could be run against a remote process. For example:
node diagnostics --cpu-profile --pid $(pgrep node)
Personally, I think the 2 option would be the most flexible and useful for our users, but I want to hear what other members of the WG thing.
Overall, I'm trying to ensure we can trigger those tools given the following constraints (which are common in enterprise environment):
- No need to make changes to the application code (as changes can take days, weeks or months to propagate, depending on the company)
- No need to install extra dependencies on the fly (companies can have strict rules against mutating the server, or installing dependencies can be forbidden by security until those dependencies are cleared as safe)
- Trigger the tools on an already running process, without the need to stop it
- Trigger the tool non-interactively / without intervention from a human (users should be able to trigger it from a bash script, for example).
- Dominant language
- No language data
- Stars
- 550
- Forks
- 69
- PR merge metrics
- No merged PRs in 30d
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from nodejs/diagnostics
-
Difficulty 1/5 Under an hour Newbie friendliness 65/100
nodejs/diagnostics#648 · 3 comments ·
-
Difficulty 1/5 Under an hour Newbie friendliness 20/100
nodejs/diagnostics#690 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 20/100
nodejs/diagnostics#689 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 25/100
nodejs/diagnostics#688 ·
-
Difficulty 5/5 Over a week Newbie friendliness 25/100
nodejs/diagnostics#687 ·
All issues in nodejs/diagnostics
Similar issues
-
Difficulty 1/5 Under an hour Newbie friendliness 92/100
milvus-io/birdwatcher#545 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
area:tools bug good first issue help wanted priority:P2
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
TaewoooPark/Motifcode#14 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
newrelic-experimental/preflight#793 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
caddyserver/caddy#8046 ·