The Tractor Dashboard toolbar spans the top of the browser window and contains the following regions.
There are seven icons which are used to switch to different pages in the dashboard. From left to right they are "About Tractor", "Job List", "Blade List", "Metrics", "Administration", and "Documentation".
Reloading Job or Blade List
The job and blade lists are automatically refreshed at an interval defined in the user's preferences; by default this interval is 60 seconds. Additionally, the job list data is updated in real-time through messages that are sent to the Dashboard from the Engine. If a user wishes to get the most up-to-date information, the job list and blade list icons can be reselected to force a new refresh of their respective lists. Given the real-tlme nature of job updates from the engine, a manual refresh is more likely to be useful for updating the blade list; however, a congested network or an Engine under heavy load may result in some updates not reaching the Dashboard, and as such a manual refresh can be useful.
Messages of general importance like "Dispatching Paused" will be displayed in the area in the middle of the toolbar.
The Filter Pulldown
You can define filters that limit or filter the amount of information that is shown in the job or blade lists. More information on filters can be found in the Filter Editor reference.
The pattern matcher is a type-in field that is used as a selector to filter which items are visible in the job or blade lists. The pattern match field will be compared against the owner and title attributes in the job list, and the host and profile attributesin the blade list. Note, unlike filters this operation is performed in the browser and simply limits the number of items displayed. Filters are applied by the Engine, and limit the number of jobs or blades sent to the Dashboard from the Engine.
The name of the currently logged in user is shown on the far right. Clicking on the user name will present a drop down menu to navigate to user preferences or to log out.
Each pane has specific UI functionality, which is detailed on the pages linked to above. The main Dashboard window provides the following functionality:
The main display panes can be resized by dragging the pane dividers.
A pane can be closed or opened by clicking on the light midsection of a pane divider. When the task graph pane has been closed, data to render the graph will not be requested from the engine since the the graph would not be visible anyway. This can be helpful to keep the dashboard responsive when selecting very large jobs.
If you resize the entire browser window, the panes will resize to fit in the new window with the same orientation/aspect-ratio.
Clicking on any of the headers in a list view will cause the items to be sorted by the associated attribute. Clicking a second time on the same header will reverse the sort.
When a new sort column has been selected, the prior sort column is used for secondary sorting. For example, selecting the "Owner" header and then the "Priority" header in the Job List pane will cause the jobs to be ordered by priority, and jobs of the same priority will be ordered by owner.
Column Resizing and Reordering
The columns in list views can be resized by dragging the separator between the column headers. The can also be reordered by dragging the column header to the side of another column.
Z to Scroll Selected Item into View
Pressing the 'Z' key in any view will cause the selected item to be scrolled into view. This is useful when a user has been browsing through large lists or job graphs and may otherwise have difficulty finding the selected item.