The application monitor Appmon is a graphical node and application viewer. The tool shows an overview of all applications on all known nodes, and it is possible to view the process tree for an application running on any of the nodes.
If the Appmon code is not available at a node, for example an embedded node, this node is ignored by Appmon and is not shown in the Appmon window.
Start Appmon by calling
The main window is equipped with a menubar from which it is possible to:
The application window shows the process tree for an application with each process displayed as a box. It is possible to view information about the processes, to send messages to them, and to trace and kill them.
The main window shows a load meter and all applications running at the displayed node. Select which node to display in the window by choosing the node name from the Nodes menu. It is also possible to run Appmon in a many-window mode where a new instance of the main window is opened for each node to be displayed.
The load meter shows load measured as processor time, or as the length of the ready queue.
Every application running at the node is shown as a button. Clicking the button will open the application window showing the process tree for the application.
The Nodes menu contains all currently and previously known nodes, where the Appmon code is available. Nodes where the Appmon code is not available, for example embedded nodes, are ignored by Appmon and are not shown.
Selecting a node from the Nodes menu will cause that node to be displayed in either the same window, or in a new window, depending on if Appmon is run in one-window or many-windows mode. If the connection to the node has been lost, this will be shown in the window.
The application window shows the process tree for an application. The window title contains the application name and the node name. The window also contains a menubar and a toolbar.
The application window can be opened from the main window by clicking on the button denoting the application, or from the listbox window by selecting the application and clicking on the Load button.
The application can be shown either as a strict supervision tree, or as a process view with all linked processes. In supervision mode, the tree-gathering and -building algorithm assumes conformance to the OTP design principles.
The toolbar consists of four buttons: Info, Send, Trace and Kill. First select one of these buttons and then select to which process the action should apply by clicking on a process in the process tree. By default Info is selected which means that clicking on a process, without selecting Send, Trace or Kill first, will open the
The listbox window lists all nodes and applications. This window can be more easy to use than the normal, graphical user interface when the system consists of a large number of nodes and/or applications.
The window contains three buttons:
The process information window shows information about different processes as given by
The web based version of Appmon is an alternative version of Appmon. The main difference between the web based version of Appmon and the original version of Appmon is that the web based version of Appmon can monitor nodes and applications on nodes where Appmon not is installed.
To start the web based user interface configure and start WebTool, see WebTool User's Guide. The web based version of Appmon is compatible with the browsers Netscape Navigator and Internet Explorer 4.0 and higher.
When WebTool is started, start the Web based version of Appmon via WebTool. If WebTool succeeded to start the web based version of Appmon a link named WebAppmon will appear in the topmost frame. Click on the link and the main frame of the browser will show two frames.The left frame will show a combo box for node selection and a list of all applications on the currently selected node.
In the left frame it is possible to:
The right frame shows the selected information, either the application specification or the process tree and process information.
In the top of the left frame there is a combo box with all known nodes. The name of the node that is monitored is the node whose name is visible in the combo box. At startup the node on which the web based version of Appmon is running on will be monitored.
To change node, select another node in the combo box, and the list of running applications will change to the applications that runs on the selected node.
To view the process tree of an application click on the application name in the list of applications. The process tree of the selected application will then appear in the right frame.
The processes in the process tree can have three different colors:
If the process name begins with Runs on another node: The monitored application runs on more than one node and this process is the first process on a branch that runs on another node.
After the application name in the list of applications there are a link named Spec, Click on this link and the application specification will appear in the right frame. The application specification is the data in the .app file of the selected application.
In the top of the page that shows the process tree, there are three radio buttons for selecting which processes that shall be included in the process tree. The default mode is that all processes that one process in the application tree has a relation to is included. It's possible to filter which of the processes in the process tree that will be included. To reduce the number of processes in the process tree select one of the radio buttons on the top of the page
To see more information about a specific process click on the process name and more information will be loaded under the application tree.
The Process information page shows information about a process as given
by the
If the link after the process name in the process tree is start trace the process is not traced. If the link is stop trace then the process id traced.
To toggle the trace flag for a process click on the link start trace or stop trace after the process name in the process tree.