System Monitor

 

The Inventua SystemMonitor Module for DotNetNuke monitors systems and applications, displaying the results in your DNN portal.

Installation and Compatibility
This module is installed as part of the Inventua DNN System Monitoring kit.   This module can perform basic monitoring on any server that responds to pings, but requires Microsoft Windows Server for advanced monitoring.  Some performance monitoring statistics that are available from Windows 2003 servers such as Processor Load and number of active threads may not be available for Windows 2000 servers due to security restrictions built into the operating system. Refer to Microsoft knowledge base article 226494 for more information.

Configuration Options
Once you create a SystemMonitor instance, select the Options menu item from the module settings menu to display the Options page.

Server The DNS name of the server.  If you want to refer to the DNN server, use the value "." (a single dot).
Username

The username to submit to WMI.  The user must have access rights to WMI namespaces on the selected server.  Use the wmimgmt.msc snap-in on the server to configure WMI access rights.  The username is not required and is not used when monitoring the same server that DNN in running on - it is only used when monitoring a seperate server. 

See http://support.microsoft.com/default.aspx?scid=kb;EN-US;325353 for more details.

Password The password to submit to WMI.
Domain The domain of the username to submit to WMI.
Layout
Standard CSS class Name of the CSS class to use when rendering system information.
Alert CSS class Name of the CSS class to use when rendering an alert.
Display errors and warnings only When selected, the module displays "minimal" status data from the monitored server, and only displays results from tests if they generate a warning condition.  When not selected, a comprehensive report of the server status is displayed.
More Info tab

If a "more info" tab is selected, the system information module can render a "More Info" hyperlink, or can render the server name as a hyperlink that links to the selected tab.  This feature is intended to allow users to create tabs using the Inventua System Info and/or Event Viewer modules and navigate to them easily from the System Monitor module but can be used to link to another tab of the user's choice if required.

Note:  Use the "Make the system name a hyperlink to the "more info" tab" checkbox to render the server name as a hyperlink to the more info tab.

System Info tab If a "System info" tab is selected, the system information module will render a "System Info" hyperlink that links to the selected tab.  This feature is intended to allow users to create tabs using the Inventua System Info module and navigate to them easily from the System Monitor module.
Event Viewer tab If a "Event Viewer" tab is selected, the system information module will render a "Event Viewer" hyperlink that links to the selected tab.  This feature is intended to allow users to create tabs using the Event Viewer modules and navigate to them easily from the System Monitor module.
Thresholds
Disk space Indicates the percent of disk space that must be used before a warning is generated.
CPU usage Indicates the percent of CPU utilization that must be in use before a warning is generated.  This option is not available if your DNN (web) server is Windows 2000.
Ping time Indicates the maximum acceptable ping response time in milliseconds (ms) before a warning is generated.
Memory Usage Indicates the percent of memory that must be in use before a warning is generated. 
Monitor Applications
Test FTP If set, tests an FTP server by connecting and disconnecting to port 21.
Test HTTP If set, tests a HTTP server by querying the default page.
Test SQL Server

When selected, tests an SQL server by connecting to it and executing a simple command.

SQL User:  The user name to log into the SQL server with.
SQL Password:  The password to log into the SQL server with. 
Monitor Services

Indicates windows services to monitor. 

If the service is not running when tested, a warning will be displayed.  Note:  When the module is first created and the "server" property is not set, the list of services is read from your DNN server.  If you are monitoring another server, you should configure the server name, username, domain and password, click save and re-select "Options" to return to the options page so that the list of services is read from the correct server.

For non-windows platforms (i.e. linux), service monitoring is not available.

Custom Queries

Advanced users can add custom WMI queries for display and evaluation (available in the versions for DNN 3 & 4 only).  To add a custom query, enter the following:

Caption:  The label to show next to the query result.

Condition:
  The system monitor can be configured to display a warning if the query result matches your criteria.  Select a condition type (see below) and enter a value to match.  The available condition types are:
None:  Do not evaluate the result.
Equals:  Sets a warning condition if the result value(s) exactly match the value you specify. 
Contains: Sets a warning condition if the result value(s) contain the condition value you specify.
Greater Than:  Sets a warning condition if the result value(s) is greater than the value you specify. 
Less Than:  Sets a warning condition if the result value(s) is less than the value you specify. 

The "equals", "greater than" and "less than" condition types are intended to be used with queries that return a single value only.  If multiple values are returned by your query, each value is compared to your condition, and if any of them raise a warning condition, a warning will be displayed.  The System Monitor checks the data type of each value returned by WMI and compares string values as case-insensitive strings (i.e. "AbCd" is the same as "abcd") and numeric values as numbers (i.e. "065" is the same as "65").

Query:  The WMI query to execute.  (Example, "SELECT NumberOfProcesses FROM Win32_OperatingSystem").  See http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmisdk/wmi/win32_classes.asp?frame=true  for more information on WMI queries.

When you have entered the Caption and Query, Click the "Add" button to add your custom query to the list.  You can remove custom queries by clicking the "delete" link in the list. 

* CPU Usage and thread count cannot be reported by Windows when your DNN/web server operating system is Windows 2000, even if the server being monitored is using Windows 2003.  If your DNN/web server is Windows 2003, CPU usage and thread count reporting will work, even if the server being reported is using Windows 2000.

Conditions of use
Permission is hereby granted, on a Try-before-you-buy basis, to any person obtaining a copy of the Inventua DNN System Monitoring Kit module(s) and associated documentation files (the "Software"), to use the Software without restriction, including the rights to use, copy or otherwise use the software for commerical or non-commercial use, but excluding any rights to reverse engineer or remove Inventua logos and licensing information. This permission does not imply or otherwise grant any rights to any other Inventua intellectual property including but not limited to logos, trademarks, documentation and software products.

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

This help file, the accompanying software and other materials supplied with the software are Copyright © Inventua, 2004-2008. All Rights Reserved.

About DotNetNuke
The Inventua DNN SystemMonitor Module is a DotNetNuke portal module. For more information on DotNetNuke, visit http://www.dotnetnuke.com.

About Inventua
Inventua provides software tools for information technology organisations that facilitate and maximise synergy and cohesion between development, support, marketing and management teams, improves software product quality and helps information technology organisations to provide great products and great support. Visit Inventua on the web at http://www.inventua.com

Sample Screenshot - System Monitor (simple)

This screenshot shows five instances of the system information module, configured to show only warnings and errors.

Sample Screenshot - System Monitor (show all)

This screenshot shows the system monitor module configured to show all information.