EOL
Effective 30 April 2017, Gissing ConteX reached end of life. This documentation is archived and will no longer be updated.
Gissing ConteX
Introduction Copied
The Geneos Gissing ConteX Plug-in monitors the Gissing ConteX system by reading the status information file written by the Gissing ConteX Status Output Feed (STATHand).
Views Copied
The Gissing ConteX PlugIn does not produce a fixed set of views, but dynamically displays views depending on the information it finds in the Gissing status information file at runtime.
The following section briefly describes the views that will generally be available. This is based on the information about the status file that is available at the time of wring this document. For the most up to date description of the status information that will be given out by STATHand, please read the latest version of Gissing ConteX Status Output Feed.pdf.
CONTEX HANDLER View Copied
This view shows basic handler status for each handler.
CONTEX INFO View Copied
This view shows the overall information of the Gissing modules, typically including Context and STATHand versions, fault tolerance status & last ping.
HANDLER-STATUS-PAGE View Type Copied
Shows each handler status page in a separate view. The contents of the Handler Status Pages are usually free text. If this free text is in a format that is known to the Plug-in, the Plug-In will extract and show the handler status information in a more meaningful manner. Otherwise, the text will be shown ‘as is’.
The name of each view will begin with “CONTEX STATUS”, followed by the name of the page.
CONTEX LOG View Copied
Show the most recent log events. The compressLogEvents sampler parameter can be used to combine similar logs in order to reduce the data shown in this view.
Plug-in Configuration Copied
Sample configuration (Mandatory):
tatusFile: \files\StatusDump.txt
SampleConfiguration (Optional):
excludeRecordSubstrings
excludeRecordSubstring: %CHAIN
excludeRecordSubstring: %RICSTATUS
dcsoHandlerNames
dcsoHandlerName: DCSO_DDS
mkloHandlerNames
mkloHandlerName: MKLO1
mkloHandlerName: MKLO2
tlkoHandlerNames
tlkoHandlerName: TLKO1
tlkoHandlerName: TLKO2
combinableHandlerTypes
combinableHandlerType: Triarch SSL Input Handler
compressLogPrefixes
compressLogPrefix: Failed to open item 0#FA
compressLogPrefix: Failed to open item 0#FLEET
compressLogPrefix: Failed to open item
compressLogPrefix: Failed to retrieve chain link
The following parameters can be configured for this plug-in:
statusFile Copied
The full path of the status information file (including file name)
Mandatory: Yes
fileTrigger Copied
The full path of the status information file (including file name) - This is generic variable that is used to trigger re-sampling when the given file is changed.
Mandatory: No
excludeRecordSubstrings Copied
Used to exclude records in the status information file from being displayed.
If any of the words in this list appears as a part of a record heading, then that record is ignored.
Mandatory: No
Default: %CHAIN, %RICSTATUS
dcsoHandlerNames Copied
Comma-separated list of handler names of the handler class ‘DCSO’. The handler names are configured by the ConteX user.
This is needed so that the plug-in can identify the handler status pages from the DCSO-class handler (s).
Mandatory: No
Default: DCSO
mkloHandlerNames Copied
Comma-separated list of handler names of the handler class ‘MKLO’. The handler names are configured by the ConteX user.
This is needed so that the plug-in can identify the handler status pages from the MKLO-class handler (s).
Mandatory: No
Default: MKLO
tlkoHandlerNames Copied
Comma-separated list of handler names of the handler class ‘TLKO’. The handler names are configured by the ConteX user.
This is needed so that the plug-in can identify the handler status pages from the TLKO -class handler (s).
Mandatory: No
Default: TLKO
btsgHandlerNames Copied
Comma-separated list of handler names of the handler class ‘BTSG’. The handler names are configured by the ConteX user.
This is needed so that the plug-in can identify the handler status pages from the BTSG -class handler (s).
Mandatory: No
Default: BTSG
combinableHandlerTypes Copied
Comma-seperated list of handler status page (HSP) types, where for each type, multiple handler status pages will be combined into single views.
The handler type, in this situation, is the full title that comes bounded by * characters in the HSP’s in the status output file.
E.g. if this list contains “A” and “B” then all HSP’s that have “* A *” as the title will be combined into one view, and the same will happen for all HSP’s that have “* B *” as the title.
Mandatory: No
compressLogPrefixes Copied
Number of prefixes to use to identify similar log events (Relates to the CONTEX LOG View
This feature is used to combine sets of similar
log events in to one row. For example if the text
“Error connecting to server” was configured as such a
prefix, all log events that start with this text will
be represented as a single row saying “Error
connecting to server…
Mandatory: No