gecko-dev/remote/doc/Debugging.md
Andreas Tolfsen c0c59383f9 bug 1544393: remote: ship remote agent in Firefox Nightly r=remote-protocol-reviewers,whimboo,maja_zf
Now that the security review in bug 1542229 and the follow-up work
that came out of it is complete, we should go ahead and flip the
remote.enabled preference.

This patch causes the remote agent to be available to users on the
Firefox Nightly release channel.  This meansusing --remote-debugger
will no longer cause a fatal error

Differential Revision: https://phabricator.services.mozilla.com/D55137

--HG--
extra : moz-landing-system : lando
2019-12-02 15:39:51 +00:00

1.4 KiB

Debugging

Increasing the logging verbosity

To increase the internal logging verbosity you can use the remote.log.level preference.

If you use mach to start Firefox:

./mach run --setpref "remote.log.level=Debug" --remote-debugger

Enabling logging of emitted events

To dump events produced by EventEmitter, including CDP events produced by the remote agent, you can use the toolkit.dump.emit preference:

./mach run --setpref "toolkit.dump.emit=true" --remote-debugger

Logging observer notifications

System observer notifications are used extensively throughout the code and it can sometimes be useful to log these to see what is available and when they are fired.

The MOZ_LOG environment variable controls the C++ logs and takes the name of the subsystem along with a verbosity setting. See prlog.h for more details.

MOZ_LOG=ObserverService:5

You can optionally redirect logs away from stdout to a file:

MOZ_LOG_FILE=service.log

This enables LogLevel::Debug level information and places all output in the file service.log in your current working directory.