Back to ITRS Internal Only FAQ

Internal documentation only

This page has been marked as draft.

IX-MA Read a text file

Adapters: This where we declare the source and the filename of the txt file on the server.

Geneos - IX-MA Read a text file.

Turn on the rewind and set the delimiter to " : " you can change this according to your needs.

rewind The Rewind parameter controls how the file is read. See If this is set to true, then the reading of the file will begin from the start of the file, otherwise, the file will be read from the end (i.e. only new data added to the file is read and processed).

fieldDelimiter

The fieldDelimiter parameter specifies how to parse a message into fields. If this is empty (and is by default), then the message is not tokenized, otherwise, the message is split into fields around the delimiter.

Geneos - IX-MA Read a text file.

Trackers: Trackers are the main component of the plug-in, they perform configurable analysis based on the messages passing through the tracker. These values are then used when producing the view.

trackers > fieldValue > name Specifies the field name for the tracker which uniquely identifies the tracker. Tracker names should consist only of alphanumeric characters (i.e. Digits and letters in both upper and lower case) and the underscore and dash characters (_ or -). This name is then used to reference the tracker value in filters (see below) and in the table template (see next section).

trackers > fieldValue > filter Define a filter for the tracker. See Defining filters for Trackers for further information.

trackers > fieldValue > fieldName Specifies the message field the tracker takes its value from.

Geneos - IX-MA Read a text file.

tableColumnLabels List of column headers for the table. It is recommended that items in the list not contain spaces, to aid in the specification of rules in the Geneos Rule Manager at a later date. If this is required however, or to include commas in a header, the label can be enclosed in double quote characters ( " ) as required. A minimum of two labels must be specified, and the table section overall must contain either a valid headline or columnLabels declaration to be valid.

Geneos - IX-MA Read a text file.

tableRows Specifies the rows to be added to the table. These rows are added in the order that they appear.

value The values in a table row, referenced by the tracker name prefixed by a $ character. (e.g. $myTracker).

Geneos - IX-MA Read a text file.

Example Text file on the server.

Geneos - IX-MA Read a text file.

Output on the IX-MA Sampler:

Geneos - IX-MA Read a text file.

The value inside the text file is a single line of string, it was divided by using the delimiter “:” and split the output and the 1982 value and used them in the column.

["Geneos"] ["FAQ"]

Was this topic helpful?