Status Page: Difference between revisions
No edit summary |
No edit summary |
||
(23 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{Pagelinks}} | |||
= Links = | = Links = | ||
{{mhttpdpages}} | |||
= Purpose = | = Purpose = | ||
The purpose of the [[mhttpd]] | The purpose of the [[mhttpd]] status page is to allow the user to control and monitor the experiment. | ||
= Access the status page = | = Access the status page = | ||
If the MIDAS web server [[mhttpd]] is running, the experiment can be accessed from the web (see [[mhttpd#Usage|usage]]). An example of the status page is shown in [[#Figure 1|Figure 1]]. By default, anyone can access the experiment via the web. | |||
Web access restrictions to the experiment can be set by the user (see [[Security]]). | |||
= Refresh = | = Status Page Refresh = | ||
It is important to note that the refresh of the Status Page is not "event driven" but is controlled by a timer whose rate is adjustable through the Config | It is important to note that the refresh of the Status Page is not "event driven" but is controlled by a timer whose rate is adjustable through the [[Config Page]]. | ||
This means the information at any given time may reflect the experiment state of up to n seconds in the past, where n is the timer setting of the refresh parameter. | |||
<div id="Figure 1"></div> | |||
= Features of the status page = | = Features of the status page = | ||
{| style="text-align: left; width: 100%; background-color: rgb(255, 255, 255);" border="0" cellpadding="2" cellspacing="2" | |||
|- | |||
| [[File:status_page.png|thumb|left|Figure 1: Example of status page]] <div style="clear: both"></div> Click image to enlarge | |||
| colspan="1" rowspan="1" style="vertical-align: top; background-color: white; font-weight: normal;"| | |||
The status page is divided into several parts | The status page is divided into several parts | ||
* Menu Buttons | * Menu Buttons | ||
Line 33: | Line 29: | ||
* Run Status information | * Run Status information | ||
** Optional display of status items | ** Optional display of status items | ||
** Last system message | ** Last system message | ||
* Equipment Information and Event rates | * Equipment Information and Event rates | ||
* Data Logging Information | * Data Logging Information | ||
* Active client list | * Active client list | ||
|} | |||
<div style="clear: both"></div> | |||
<div id="suppressed"></div> <div id="page-switch-buttons"></div> <!-- Anchor page-switch-buttons and suppressed--> | |||
== Menu Buttons == | |||
The top row of Menu buttons on the main status page [[#Figure 1|Figure 1]] include the '''run control buttons''' (Start/Stop/Pause/Resume depending on the run state) and the '''page switch buttons''' (e.g. ODB, Messages, Elog, Alarms, Programs, History, Sequencer, MSCB, Chat, Help). Clicking on a page switch button will replace the Status page with the requested page. The pages may contain a | |||
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | |||
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Status</span> button to return to the Status page (see [[#Select visible menu buttons|select visible menu buttons]], or the browser "Back" button can be used. | |||
= | For the <span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | ||
[[ | padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Config</span> button see [[#Page Refresh|page refresh]]. | ||
=== Select visible menu buttons === | |||
Not all the available buttons may be visible on the status and other pages. | |||
Keys in the [[/Experiment ODB tree]] control which menu buttons are visible. The user may customize these by '''hiding unneeded buttons'''. The [[/Experiment ODB tree#Menu Buttons|Menu Buttons]] key lists the buttons to appear on the page. By default, the Status button is not visible on subpages, but can be made so by adding "Status" to this key. | |||
Sometimes it is desirable to stop users from starting/stopping or pausing/resuming runs, and this can easily be done by hiding the | |||
The | appropriate buttons. | ||
The Start/Stop buttons and Pause/Resume buttons may be suppressed using the [[/Experiment ODB tree#Start-Stop Buttons|Start-Stop Buttons]] and [[/Experiment ODB tree#Pause-Resume Buttons|Pause-Resume Buttons]] keys respectively. | |||
Note that the | |||
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | |||
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">MSCB</span> button | |||
will only be visible if MSCB support has been built into Midas. | |||
= Optional Buttons = | == Optional Buttons == | ||
On the Status page ([[#Figure 1|Figure 1]]), below the Menu Buttons, there may be up to three rows of optional user-added buttons. These may include | |||
* [[/Script ODB tree#Script-button|script-buttons]] | * [[/Script ODB tree#Script-button|script-buttons]] | ||
* [[Frontend user code#Manual Trigger|manually-triggered event]] buttons | * [[Frontend user code#Manual Trigger|manually-triggered event]] buttons | ||
* [[alias-buttons]] and [[custom | * [[/Alias ODB tree#Alias-Button|alias-buttons]] and [[/Custom ODB tree#Custom-Button|custom-buttons]] | ||
In [[#Figure 1|Figure 1]], | |||
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | |||
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">test</span> is a script-button, | |||
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | |||
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">ppg-cycle</span> is a custom-button, the other buttons on the line are all alias-buttons. | |||
== Alarm Banner == | |||
[[File:status_page_alarm.png|thumb|left|Figure 2: Example of status page with alarm banner]] | |||
The alarms (see [[Alarm System]]) are configured using the [[Alarms Page]]. If an alarm is triggered, a banner appears on the status page as shown in Figure 2. | |||
The alarm may be reset with the | |||
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | <span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | ||
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;"> | padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Reset</span> button on the banner (or on the [[Alarms Page]]). However, unless the alarm condition is resolved, the alarm will be triggered again at an interval given by [[/Alarms ODB tree#Check interval|Check interval]], causing the alarm banner to reappear. To see which alarm(s) have triggered, check the [[Alarms Page]]. | ||
The alarm message and colour of the banner are configured in the ODB [[/Alarms ODB tree#<alarm-name> subtree|/Alarms/<alarm-name>]] and [[/Alarms ODB tree#<class-name> subtree|/Alarms/<class-name>]] subtrees respectively. | |||
<div style="clear: both"></div> | |||
== Run Status Information == | |||
The{{Spacer|blank=a}}{{Banner|name=Run Status}}{{Spacer|blank=a}} information on the status page ([[#Figure 1|Figure 1]]) displays important information, such as the run status, alarm system status and data directory. The run may also be started/stopped using the button provided. The colour or information changes depending whether the run is active or not (e.g. run elapsed time or run stop time). By default, the experiment name is also shown here. The user may choose to display other useful information in this area (see [[/Experiment ODB tree#Status items subtree|Status items]]. | |||
The last item in this area is a one-line display of the last Midas message. More messages can be viewed on the Message page by clicking | |||
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | <span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em; | ||
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;"> | padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Message</span>. | ||
== Equipment Information == | |||
<div style="clear: both"></div> | |||
The{{Spacer|blank=a}}{{Banner|name= Equipment}}{{Spacer|blank=a}} area on the status page ([[#Figure 1|Figure 1]]) shows the status (by colour) of any [[Frontend Operation#Equipments in Frontend|defined Equipments]] (unless [[/Equipment ODB tree#Hidden|hidden]]). If Hidden equipments are present, they may also be displayed by clicking on the "+" link above the equipment names. This area also displays the number of events sent, the event rate and the data rate. These values are found in the [[/Equipment ODB tree#Statistics|Statistics subtree]] for each Equipment. | |||
The names of each equipments is a link to the relevant [[Equipment page]], which displays any Variables related to that equipment. | |||
== Logging Channels == | |||
The{{Spacer|blank=a}}{{Banner|name=Logging Channels}}{{Spacer|blank=ab} section on the status page ([[#Figure 1|Figure 1]]) contains a display of the status of open [[Keys in the ODB /Logger/Channels subtree#Multiple Logging Channels|logging channels]], number of events logged, disk usage etc. | |||
== Clients == | |||
The {{Spacer|blank=a}}{{Banner|name= Clients }}{{Spacer|blank=b}} area on the status page ([[#Figure 1|Figure 1]]) displays | |||
the names of the clients that are currently running. | |||
[[Category:mhttpd Pages]] | |||
[[Category:alarms]] | |||
[[Category:ODB]] | |||
[[Category:Programs]] |
Latest revision as of 13:32, 11 October 2023
Links
Purpose
The purpose of the mhttpd status page is to allow the user to control and monitor the experiment.
Access the status page
If the MIDAS web server mhttpd is running, the experiment can be accessed from the web (see usage). An example of the status page is shown in Figure 1. By default, anyone can access the experiment via the web. Web access restrictions to the experiment can be set by the user (see Security).
Status Page Refresh
It is important to note that the refresh of the Status Page is not "event driven" but is controlled by a timer whose rate is adjustable through the Config Page. This means the information at any given time may reflect the experiment state of up to n seconds in the past, where n is the timer setting of the refresh parameter.
Features of the status page
Click image to enlarge |
The status page is divided into several parts
|
Menu Buttons
The top row of Menu buttons on the main status page Figure 1 include the run control buttons (Start/Stop/Pause/Resume depending on the run state) and the page switch buttons (e.g. ODB, Messages, Elog, Alarms, Programs, History, Sequencer, MSCB, Chat, Help). Clicking on a page switch button will replace the Status page with the requested page. The pages may contain a Status button to return to the Status page (see select visible menu buttons, or the browser "Back" button can be used.
For the Config button see page refresh.
Not all the available buttons may be visible on the status and other pages. Keys in the /Experiment ODB tree control which menu buttons are visible. The user may customize these by hiding unneeded buttons. The Menu Buttons key lists the buttons to appear on the page. By default, the Status button is not visible on subpages, but can be made so by adding "Status" to this key.
Sometimes it is desirable to stop users from starting/stopping or pausing/resuming runs, and this can easily be done by hiding the appropriate buttons. The Start/Stop buttons and Pause/Resume buttons may be suppressed using the Start-Stop Buttons and Pause-Resume Buttons keys respectively.
Note that the MSCB button will only be visible if MSCB support has been built into Midas.
Optional Buttons
On the Status page (Figure 1), below the Menu Buttons, there may be up to three rows of optional user-added buttons. These may include
In Figure 1, test is a script-button, ppg-cycle is a custom-button, the other buttons on the line are all alias-buttons.
Alarm Banner
The alarms (see Alarm System) are configured using the Alarms Page. If an alarm is triggered, a banner appears on the status page as shown in Figure 2.
The alarm may be reset with the Reset button on the banner (or on the Alarms Page). However, unless the alarm condition is resolved, the alarm will be triggered again at an interval given by Check interval, causing the alarm banner to reappear. To see which alarm(s) have triggered, check the Alarms Page.
The alarm message and colour of the banner are configured in the ODB /Alarms/<alarm-name> and /Alarms/<class-name> subtrees respectively.
Run Status Information
The a space Run Status space a information on the status page (Figure 1) displays important information, such as the run status, alarm system status and data directory. The run may also be started/stopped using the button provided. The colour or information changes depending whether the run is active or not (e.g. run elapsed time or run stop time). By default, the experiment name is also shown here. The user may choose to display other useful information in this area (see Status items.
The last item in this area is a one-line display of the last Midas message. More messages can be viewed on the Message page by clicking Message.
Equipment Information
The a space Equipment space a area on the status page (Figure 1) shows the status (by colour) of any defined Equipments (unless hidden). If Hidden equipments are present, they may also be displayed by clicking on the "+" link above the equipment names. This area also displays the number of events sent, the event rate and the data rate. These values are found in the Statistics subtree for each Equipment.
The names of each equipments is a link to the relevant Equipment page, which displays any Variables related to that equipment.
Logging Channels
The a space Logging Channels space {{Spacer|blank=ab} section on the status page (Figure 1) contains a display of the status of open logging channels, number of events logged, disk usage etc.
Clients
The a space Clients space b area on the status page (Figure 1) displays the names of the clients that are currently running.