Too Much Data

The Joblist pane and the ServerList pane both allow filters to be defined which limit the amount of information returned from the monitor to the UI.

Custom filter definitions can be created and saved for personal use, and administrators can also create generally useful filters that can be placed in a shared area for use by everyone at the site (see below).

These filters can be important because the UI is an application running within the web browser in javascript. The amount of data that can be sent from the monitor to the UI must be limited to prevent the browser from crashing.

Normally the joblist or the bladelist will show a count of the number of entries in their pane. When the data limit has been reached and filtering is limiting the total amount of records, the count will be followed by + as shown in the picture above. This indicates that the current query has produced more data than can be displayed in the UI.

Because the Joblist pane subscribes to events and jobs are constantly being added or removed from the pane, the UI will take it's own precautions to prevent data overflow.

• The UI will implement a rolling window of the the list of jobs. As new jobs come into the joblist, they will bump older jobs off the list, keeping the displayed jobs at the maximum list size.
• If jobs are deleted and the list of jobs now falls below the threshold, then the UI will do an automatic request of the job data from the engine to assure that as many jobs as possible are always displayed

Editing Filters

Tractor uses filters to limit the amount of data that is sent from the monitor to the UI, to prevent data overrun. The Filter Lister dialog provides the user with a list of available filters, and buttons to edit the existing filters. The Filter Rule editor allows you to create or edit filters by building a list rules which are understood by the tractor monitor.

When the pull-down filter menu is selected, a Filter Lister dialog is displayed (as seen above). If there are currently defined filters of the correct type (joblist or bladelist), then they will be displayed.

There are several options in operating with the filters:

• New - opens the filter editor dialog to construct a new filter
• Edit - opens the filter editor dialog to edit the selected filter
• Copy - opens a copy of the selected filter in the filter manager
• Delete - deletes the selected filter from the UI, and tells the engine to remove the filter from the users filter directory.
• Apply - Sets the currently selected filter as the Active filter.
• None - Removes the currently selected filter.
• Cancel - Closes the dialog without action.

The Filter Editor dialog is opened whe selecting New, Edit or Copy. The Filter Editor allows you to dynamically construct a new filter, or edit an existing filter, using a set of defined filter rules, appropriate to the current pane (Jobs or Blades).

• Any/All Pulldown - When multiple rules are used in a single filter, this control defines whether ANY one of the rules need be met to allow the data to be included, or whether ALL of the rules need to be met.
• + Button - This button adds a new rule to the current filter.
• - Button - This button removes the associated rule from the filter.
• First Column Pulldown - contains the name of the rule. By changing this pulldown the remainder of the rule definition changes. Select the rule desired, and then set the appropriate values in the other entries. Note, some of the rule definitions require typing a value. For example, theSpool Time and Finish Time rules above both have a type-in value for duration (currently selected in minutes)
• Cancel - Aborts the current filter edit session, and returns to the main UI.
• Save - Saves the current ruleset as a filter using the name defined under Filter Name. If a name hasn't been specified, an alert will show, and the save will be cancelled.

Once you have defined any filters, they will be available in the pulldown on the job or server panes.

Site-wide Shared Filters

Administrators can copy useful common filters to a shared area in the tractor spool area where they will become available when people reload their Dashboard sessions. This copy is currently a manual operation. Here is an example of copying a filter named "NoDarkSide" created by the user "yoda" into the shared area. This example assumes that the tractor spool area is in the default /var/spool/tractor location, it may be somewhere else at your site.

• cd /var/spool/tractor/users
• mkdir -p _shared_/filters
• cp yoda/filters/NoDarkSide.joblist _shared_/filters/