Lightstreamer - Monitor Console Demo - HTML Client
The Monitor Console Demo is a monitor console application based on Lightstreamer for its real-time communication needs.
This project includes a simple HTML client front-end example for a monitor console application.
As an example of Lightstreamer Adapters Needed by This Client, you may refer to the internal monitoring Data Adapter provided by Lightstreamer Server.
This application shows a real-time monitor console. Several metrics are reported as they change on the server.
Refer to the 4.2.1 section of the General Concept.pdf document for a dictionary of the fields made available by the "MONITOR" Adapter.
The demo includes the following client-side functionalities:
- Three Subscriptions containing the items for the statistics, subscribed to in MERGE mode feeding three StaticGrids. Fields from a single item are associated to cells scattered in the page.
- Three Subscriptions containing the items for the server logging, subscribed to in DISTINCT mode feeding three DynaGrids.
Dig the Code
The Adapter Set Configuration
This demo is a very special case because does not need any specific adapters, but through the special "MONITOR" name, the internal monitoring Data Adapter provided by Lightstreamer Server is loaded. The factory configuration of Lightstreamer server already provides this adapter deployed.
The Metadata Adapter functionalities are absolved by the
LiteralBasedProvider in Lightstreamer - Reusable Metadata Adapters - Java Adapter, a simple full implementation of a Metadata Adapter, already provided by Lightstreamer server.
To run the demo you just need to have a folder, let's call it
MonitorDemo, inside the
<LS_HOME>/adapters folder of your Lightstreamer Server installation and inside it an
adapters.xml configuration file like this:
<?xml version="1.0"?> <!-- Mandatory. Define an Adapter Set and sets its unique ID. --> <adapters_conf id="MONITORDEMO"> <!-- Mandatory. Define the Metadata Adapter. --> <metadata_provider> <!-- Mandatory. Java class name of the adapter. --> <adapter_class>com.lightstreamer.adapters.metadata.LiteralBasedProvider</adapter_class> <!-- Optional. See LiteralBasedProvider javadoc. --> <!-- <param name="max_bandwidth">40</param> <param name="max_frequency">3</param> <param name="buffer_size">30</param> <param name="distinct_snapshot_length">10</param> <param name="prefilter_frequency">5</param> <param name="allowed_users">user123,user456</param> --> <!-- Optional. See LiteralBasedProvider javadoc. --> <param name="item_family_1">monitor_log_.*</param> <param name="modes_for_item_family_1">DISTINCT</param> <param name="item_family_2">monitor_.*</param> <param name="modes_for_item_family_2">MERGE</param> </metadata_provider> <!-- Mandatory. Define the Data Adapter. --> <data_provider name="MONITOR"> <!-- Mandatory. Java class name of the adapter. Through the special "MONITOR" name, the internal monitoring Data Adapter provided by Lightstreamer Server is loaded. --> <adapter_class>MONITOR</adapter_class> </data_provider> </adapters_conf>
If you want to install a version of this demo pointing to your local Lightstreamer Server, follow these steps:
- As prerequisite, a Lightstreamer Server has to be deployed. Download Lightstreamer Server (Lightstreamer Server comes with a free non-expiring demo license for 20 connected users) from Lightstreamer Download page, and install it, as explained in the
GETTING_STARTED.TXTfile in the installation home directory.
- Get the
deploy.zipfile of the latest release, unzip it, and copy the just unzipped
MonitorDemofolder into the
adaptersfolder of your Lightstreamer Server installation.
- Download this project.
- Launch Lightstreamer Server.
- Get the
lightstreamer.jsfile from the latest Lightstreamer distribution and put it in the
src/jsfolder. Alternatively, you can build a
lightstreamer.jsfile from the online generator. In that case, be sure to include the LightstreamerClient, Subscription, DynaGrid, ConnectionSharing, and StatusWidget modules and to use the "Use AMD" version.
- Get the
require.jsfile form requirejs.org and put it in the
- Get the zip file from script.aculo.us and put the
slider.jsfiles in the
src/js/scriptaculousfolder of the demo.
- Deploy this demo on the Lightstreamer Server (used as Web server) or in any external Web Server. If you choose the former, please note that in the
<LS_HOME>/pages/demos/folder, there may be already a
MonitorDemofolder. If this is not your case, please create the folders
<LS_HOME>/pages/MonitorDemoand copy here the contents of the
/srcfolder of this project. The client demo configuration assumes that Lightstreamer Server, Lightstreamer Adapters, and this client are launched on the same machine. If you need to target a different Lightstreamer server, please search in
var lsClient = new LightstreamerClient(protocolToUse+"//localhost:"+portToUse,"MONITORDEMO");
and change it accordingly.
- Open your browser and point it to: http://localhost:8080/MonitorDemo/
Lightstreamer Adapters Needed by This Client
- MONITOR. Through the special "MONITOR" name, the internal monitoring Data Adapter provided by Lightstreamer Server is loaded.
- Lightstreamer - Stock-List Demos - HTML Clients
- Lightstreamer - Chat Demo - HTML Client
- Lightstreamer - Portfolio Demos - HTML Clients
Lightstreamer Compatibility Notes