Monitoring webpage help

From GlueXWiki
Revision as of 10:30, 28 October 2016 by Tbritton (Talk | contribs)

Jump to: navigation, search

The purpose of the various monitoring web-pages is to allow users to quickly and easily access the graphs produced from the launches. These graphs can be viewed by plot (the same plot from all of the different runs in a user selected range), by run (all of the plots from a user selected run), by version (all of a given plot from each version of a given run), and by time (extracted quantities graphed over time). Below are the monitoring web-pages with a quick guide on how to use them:


Plot Browser Plot Browser


After the page loads the user is prompter for the Run Period and Reconstruction Version. When a Run Period is selected from the drop-down the Version drop-down will auto-update to display only the valid versions for the chosen run period. The default run numbers for the given run period will also auto-complete. Next, the user picks the plot to be displayed. This drop-down menu contains a list of all possible plots (Note: just because a plot is in this list does not mean such a plot was produced for the given Run Period, Reconstruction Version, and/or range of run numbers). The range of run numbers to look at can be specified by typing in the starting and ending run number inclusively. It is important to note that, at present, these entries are not error protected. Thus supplying any non-numeric character or giving the range from high to low will result in the page crashing. Should this occur the session will need to be restarted and options reselected. The final two text fields are the MYSQL query, where users can enter additional querying statements demanded of the returned runs, and the additional RCDB query requirements, which have been defaulted to "@is_production and @status_approved" but can be modified at the users discretion.

After all options have been entered hit the "Display" button. The page will appear to refresh and the relevant plots will be displayed in a table on the bottom half of the page. The user can click on the "Run xxxxx" hyperlink and will be taken to the runBrowser page for the given run. Currently this link does not load the plots from the run and the user should consult the section on the run Browser for more information.

There are three possible states for the plots to be in:

1) A broken image link appears. This means the selected plot was not produced for the run.

2) A white image. This plot was supposed to be produced but something went wrong in the saving of the image file

3) The plot. The plot was found for the given options.



Run Browser Run Browser


The runBrowser has a few more nuances than some of the other Browsers. It contains, on the left panel, the familiar options of Run Period and Reconstruction Version. When selecting the RunPeriod the the list of possible versions will auto update. If you know the run number you are interested in and know that it IS a part of the Run Period and Version then select all three options and hit display. If you aren't sure then follow the commented steps below.

1) Choose a Run Period

2) Choose a valid version number from the second drop-down

3) Click display. The page will refresh and will list only those runs that belong to the given Run Period and Version.

4) Find the date with the run you would like to view and click the "+" which should flare out a list of runs.

5) Select the radio button next to the run number. The accompanying "ROOT" button will spawn a new browser tab/window where the root file associated with the run can be viewed. The "RCDB" button will open the Run Conditions DataBase entry of the associated run. Note: While selecting the various options the path the site will pull from will be updated in real time so that the user can see where the plots are coming from, this should help both with accuracy and in potential debugging situations.

6) Click display. This will refresh the page and load on the right pane a table of plots that can be viewed. If this table is not present you may see an error alerting the user that the selected run number is not a valid member of the Run Period/Version selected.

First, select a system by clicking on the associated header. You can then view a histogram by mousing over it in the table of plots. To freeze/unfreeze click the entry in the plots table. At any point the user may select a different run (by selecting the associated radio button on the left pane). This will automatically update the plots given by the table of plots. It, however, will NOT update the table of plots itself unless "Display" is clicked. This holds true for changes in the version and Run Period but again the list of run dates and the table of plots are currently fixed and can only be updated by refreshing the page or clicking "Display". Once again the plots can be in one of three states: broken, white, or visible.




Version Browser Version Browser


The version Browser is perhaps the simplest to use. Simply select a run period from the first drop-down, select a plot from the second drop-down and type in a run number (this entry MUST be a number). Finally, click "Display". This will show a table of the selected plot across the various versions of the run period and run number. Clicking the version hyperlink will take the user to the runBrowser for the given run period, run number, and selected version. The run browser options will already be entered and the user can begin browsing. The plots can be in one of three states: broken, white, or visible.