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.

gissing2

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.

gissing3

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.

gissing4

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.

gissing5

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… events (s)” where n is the number of such events encountered.

Mandatory: No

["Geneos"] ["Geneos > Netprobe"] ["Technical Reference"] "1"

Was this topic helpful?