8
24
Fork
You've already forked nuMatrix
4
Page: Logger
Pages About "the page is still broken after I created all necessary rules" Behind the scene requests Changes from HTTP Switchboard Cloud storage Contributing ruleset recipes Cookies Default ruleset at installation Examples of useful rulesets FAQ Filter lists Home How to "allow all" in uMatrix How to access the popup panel when there is no toolbar How to block 1st party scripts everywhere by default How to create rules which apply everywhere, on all web sites How to get past "uMatrix has prevented the following page from loading" How to have root documents blocked by default everywhere How to work in hard 3rd party default deny by default How to work in hardcore "block almost everything" mode How to work only with global rules and all scripts blocked by default Individual URL rules Keyboard navigation Lingering domain entries in the matrix Logger Per scope switches Permissions Preset whitelisted and blacklisted domains Privacy friendly Chromium settings Privacy policy Privileged Pages Raw settings Rules syntax Ruleset recipes Scope selector Setting Domain Specific & Global Rules The extension icon The popup panel Tracking parameter removal Translation work contributors Very bare walkthrough for first time users
24 Logger
arek edited this page 2026年07月05日 08:05:14 +01:00

nuMatrix 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 nuMatrix/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.

Which filter list blocked a request

Added in nuMatrix (#526).

For a blocked request, click the entry to open its details pane. Among the details (URL, CNAME, original URL) there is now a "Hosts files" row listing the title(s) of the filter list(s) that contain the blocked hostname. This answers the common question "which of my subscribed lists is blocking this site?" — useful when deciding where to add an exception or which list to reconsider.

Filter expressions

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:

  • Enter foo to only show entries which have a string foo.
  • Enter |foo to only show entries which have a field starting with foo.
    • Tip: use |-- to show only entries which were blocked (-- may work for the most part, but there could be false positives).
  • Enter foo| to only show entries which have a field ending with foo.
  • Enter |foo| to only show entries which have exactly a field with foo.
  • Prefix any expression with ! to reverse the meaning of the expression.
    • !foo means display only entries which do not have the string foo in it.
    • !|-- 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: bts, or |bts for a stricter filtering (not in uBlock 0.9.7.0, will be added for next release).

Examples:

  • !|-- facebook: show only non-blocked entries with the string facebook in it.
  • |xhr google: show only entries of type XMLHttpRequest with the work google in it.
  • !|image !|css: show only entries which are not of type image, neither css.

nuMatrix: point-and-click matrix to filter net requests according to source, destination and type. A maintained fork of uMatrix. Source · Issues