Clone this wiki locally
uMatrix version 0.9.0.0 comes with a completely new logger.
This new logger is forward-looking, i.e. it will log events only when it is actually opened.
This is a more efficient approach than logging everything even when the user does not care about inspecting the network events -- which used to be the case. So now the memory/CPU overhead of logging is incurred if and only if the logger is being used (opened).
Also, the logger is now unified:
- All events of interest are being logged, not just network traffic.
- All events from everywhere are logged in one place, no need to select which tab to inspect.
- This is particularly useful to relate together behind-the-scene events to ongoing network traffic.
Advantages of a unified logger
No events lost: all events from all origins are logged in one place, so they all get logged. Previously you had to select the tab which to inspect, which means all events from other tabs -- including from behind-the-scene origin -- were lost.
Since no events is lost, one can now easily spot what add-ons are doing behind-the-scene. If an add-on constantly phone home while you surf the net, you will be able to see this easily.
This also allows to easily relate events from different origins. For example, when surfing GitHub, I can see behind-the-scene network requests being made while surfing GitHub. Though uMatrix/uBlock can't tell the behind-the-scene events are related to GitHub, a user can tell.
This allows to see fully chains of redirects. The network requests for root document will just appear one after another in the logger. Useful to figure how to fix logging in when many redirects are involved.
This allows to easily see the URL of popup windows, and from there one can create custom filters using the information in the logged entries.
Special status indicators
The eye-slash indicator means the entry is a behind-the-scene network request.
The x indicator means the entry belongs to a tab which has been closed. You may cleanup such entries from the logger using the x icon in the toolbar.
It is possible to click on the status indicator area to open the matrix for the associated tab (if any). The matrix will open in sticky mode, i.e. you can keep it opened permanently. The opened matrix will reflect the state of a specific tab in the browser, so log entries which are not related to that tab will be dimmed.
You can filter entries in the logger using filter expressions. Log entries which do not match all filter expressions will be hidden from view. Syntax for a filter expression:
footo only show entries which have a string
|footo only show entries which have a field starting with
- Tip: use
|--to show only entries which were blocked (
--may work for the most part, but there could be false positives).
- Tip: use
foo|to only show entries which have a field ending with
|foo|to only show entries which have exactly a field with
- Prefix any expression with
!to reverse the meaning of the expression.
!foomeans display only entries which do not have the string
!|--means display only entries which were not blocked.
- When more than one filter expression appear, a logical and between the expressions is implied.
- A special keyword can be used to filter behind-the-scene requests:
|btsfor a stricter filtering (not in uBlock 0.9.7.0, will be added for next release).
|xhr google: show only entries of type
XMLHttpRequestwith the work
!|image !|css: show only entries which are not of type