Knowledge module

In TrueSight Operations Management and

, a set of files, knowledge modules (KM) from which a PATROL Agent receives information about resources running on a monitored computer. A KM file can contain the actual instructions for monitoring objects or simply a list of KMs to load. KMs are loaded by a PATROL Agent and a PATROL Console. KMs provide information for the way monitored computers are represented in the BMC PATROL interface, for the discovery of application instances and the way they are represented, for parameters that are run under those applications, and for the options available on object pop-up menus. A PATROL Console in developer mode can change KM knowledge for its current session, save knowledge for all of its future sessions, and commit KM changes to specified PATROL Agent computers. A KM file contains the source code for a BMC PATROL application. 

This knowledge module can be loaded or imported in the following consoles:

• BMC PATROL Consoles
• BMC ProactiveNet Central Monitoring Administration Console
• BMC TrueSight console

• Error rendering macro 'Include+'

  The 'Include+' macro can only be used in spaces managed by Scroll Versions / Scroll Translations.

  All 'Include+' and 'Excerpt Include+' macros must be converted to normal 'Include Page' and 'Excerpt Include' macros in such spaces.

  Please use the macro conversion tool to detect and fix similar issues in this space or ask a space administrator to do so.

This section provides information about terminologies used in the BMC PATROL for Citrix XenApp and XenDesktop.

Applications 

An application in PATROL is any resource used or running on a computer. BMC PATROL for Citrix XenApp has a basic set of applications that monitor events such as monitoring log files. Each running copy of an application discovered by PATROL is called an instance of the particular application class.

Application discovery 

PATROL discovers applications using instructions provided by the Knowledge Module for Citrix XenApp (KM). The instructions provided by the KM include application discovery rules that you have defined. When PATROL discovers an application, it represents the application with an icon either in the icon window for the monitored computer on which it runs or in an application window specified for all application instances of that class. You can add a new application class to PATROL so that it will find all future instances of that application running on monitored computers. PATROL periodically runs application discovery to discover new applications and to verify that previously discovered applications and files are still there. If an application or file previously discovered is not found, PATROL triggers an alert, either audible or visual, for the missing resource. Application discovery rules are defined using either

• Simple discovery: uses simple pattern-matching to find instances of the application running on the monitored computer
• PSL discovery: uses scripts written in PATROL Script Language to find the application instances

Infoboxes 

InfoBoxes are tables of attributes accessed from parameters and application class icons. The PATROL consoles and PATROL Agent populate all of the attributes that appear in the parameter InfoBoxes and some of the attributes, such as icon type or status, that appear in the application InfoBoxes.

Application classes or Monitor types 

Application classes are the object classes to which an application instances belong; also, the representation of the class as a container in UNIX or folder in Windows on the PATROL Console. It is a logical grouping of individual applications, while an application group is a logical grouping of application instances. You can use the developer functionality of a PATROL Console to add or change application classes. Within PATROL, you use application classes to define the attributes of all instances within an application class (global settings), or the attributes of a single application instance that has been customized (local settings). In BMC ProactiveNet, TrueSight Operations Management, and 

, monitor types are similar to application classes. Monitor types are a way of classifying the data that is to be collected. 

Parameters or attributes 

Parameters are the monitoring elements of a KM. Parameters are run by the PATROL Agent, they periodically use data collection commands to obtain data on a system resource and then parse, process, and store the data on the computer that is running the PATROL Agent.  Parameters can display data in various formats, such as numeric, text, stoplight, and Boolean. Parameters have thresholds and can trigger warnings and alarms. In BMC ProactiveNet, TrueSight Operations Management, and

, attributes are similar to parameters. Attributes classify monitor types into types of data. 

The BMC PATROL for Citrix XenApp KM product has the following types of parameters:

• Collector parameters - A PATROL collector parameter executes commands and gathers data for a consumer parameter to display, often collecting many values. It does not display any values itself. As such, it does not have alarms or run any recovery actions. Collector parameters are defined in the collector's application class rather than in the applications for which they collect data. This avoids the situation in which a separate collector would execute for each application instance and negate the efficiency of the collector or consumer parameter. 
• Consumer parameters - A consumer parameter only displays a value that is collected by a collector parameter. A consumer parameter never issues commands; it is not scheduled for execution, but it has alarms and can run recovery actions. A consumer parameter cannot be updated directly by selecting an option on its display. To update a consumer parameter, you must execute the collector that gathers its data.
• Standard parameters - Standard parameters issue commands to collect data and display the data collected. They contain alarm definitions and can run alarm and warning actions.

Menu commands 

In PATROL console, menu commands, also known as KM commands are a menu of commands for a monitored object. You can configure the knowledge module, discover hosts, add objects, and set thresholds of parameters using menu commands. Right-click an object to access its menu commands. 

Monitoring solutions 

A monitoring solution is a pre-defined set of metrics that monitor the health and performance of a specific device or service. BMC monitoring solutions are composed of monitor types and attributes.

Monitoring profiles 

In BMC ProactiveNet, TrueSight Operations Management, 

, monitoring profiles are profiles to which the monitor types you want to enable are associated. Each solution contains multiple monitoring profiles and help to reduce unnecessary monitoring. Each monitoring profile is associated with a group of monitor types. The monitor types that belong to a profile are pre-determined. You cannot add or remove monitor types from a profile.

Attribute or parameter properties 

The following table describes the default attribute (parameter) properties available in BMC PATROL, BMC ProactiveNet, TrueSight Operations Management, and 

.

Default parameter properties