How to use the Threshold Filter Control

The Filter Log Threshold Control is the primary means by which you can control the level of reporting details shown in the console.  Whenever you change this setting, the log is redrawn using the new setting.  This allows reviewing both past and present log events with more or less detail.  This control is located above the console log and also in the menu tree.

FilterMenu-Thresshold

Other filter controls which are located adjacent to the threshold control allow filtering by the type of content in the log which is shown, or filtering by the specific data streams that are shown. These controls operate in conjunction with the threshold control.  Other articles discuss these controls in more depth.

As a practical example, here is the startup text sequence used by SNIP displayed with the three different filter settings:

Major:

SNIP, the Simple NTRIP Caster
Copyright 2010~2016 By SubCarrier Systems Corp. (SCSC), Patents Pending.
Build:   0.8.8    of May 16 2016 at 15:00:00

Moderate:

SNIP, the Simple NTRIP Caster
Part of the DGPS tools collection, available at:   www.Use-SNIP.com
Copyright 2010~2016 By SubCarrier Systems Corp. (SCSC), Patents Pending.
Build:   0.8.8    of May 16 2016 at 15:00:00

Minor:

SNIP, the Simple NTRIP Caster
A Caster tool to connect DGPS Reference Stations to NTRIP Clients with multiple modes
Simple NTRIP supports gathering RTCM data streams in serial, tcp/ip, and relay connection modes
And then transmitting these corrections streams to multiple end users (the NTRIP Clients)
– – –
Part of the DGPS tools collection, available at:   www.Use-SNIP.com
Copyright 2010~2016 By SubCarrier Systems Corp. (SCSC), Patents Pending.
Build:   0.8.8    of May 16 2016 at 15:00:00
Forked from the ‘Row Jimmy‘ development code base.

 


A summary of the three settings is as follows.

  • As a broad rule, the Moderate setting serves as a balanced general setting. It provides a summary of events concerning Client connections and the various types of data streams.  But details and repetitive log entries are generally not shown. Errors are generally shown, but details are not.
  • The  Major setting, (as a rule), presents only application level events such as the general state of the caster system and more critical error events.  In this setting, errors occurring with individual caster data streams, or with individual end users, are generally suppressed and not shown. The thinking here is that from a server perspective, data source and user level connection errors are all routine normal events that resolve themselves. [It might be aggravating to the client trying to connect, but there is nothing wrong with the server itself.]
  • The Minor setting presents every single entry for all the current displayed types.  As such it represents the most detailed display and is often only used for debugging purposes in conjunction with setting a filter to show only the types of data of interest. [Hint: It is often a useful debugging method to set the filters to show only the type of stream of interest, then set the threshold level to minor in order to see a detailed sequence of events on one topic.]

When run for the very first time, SNIP defaults to the detailed setting.  Thereafter, your last setting is reused. Other filter values are all reset (to show all data) every time you start the tool.  Overall control of the filters is discussed further in this article.

Related Articles