Introduction
This document accompanies the Message Tracker Plug-in documentation with configuration details for the internal REGEX adaptor. This document is should only be used by people who are familiar with the contents of the Message Tracker Plug-in documentation.
Overview
This adapter allows the Message Tracker plug-in to obtain data from various log files. The adapter takes a set of named regular expressions and applies each one to the message read from the log file. These are then presented to the normalization section as a set of tag values, where the name of the regular expression is the tag name and the value extracted from the message by the regular expression is the tag value. The Adapter also provides a set of meta tags listed below;
- Day: This is the day the message was seen. The format is yyyy-mm-dd
Plug-in Configuration
The following sampling parameters can be set up in the Sampler Descriptor for the Message Tracker FIX Adapters. All other parameters needed to configure the Message Tracker Plugin can be found in the Message Tracker Plug-in documentation, this includes the generic settings that are shared across all Adapters.
tags > tag
This defines the tags to be passed to the normalisation section of the adapter. There came be multiple tags defined for a single log file. The name of each tag should be unique within the adapter.
Mandatory: No
tags > tag > name
This is the name of the tag that will be presented to the normalisation section of the adapter if the regular expression defined in tags > tag > regex returns data.
Mandatory: Yes
tags > tag > regex
This is the regular expression that is applied to the message to extract the tag value. The first group in the regular expression is the value that is returned.
For example; the if the regular expression ID=([^,]*) is applied to the message
Day=12/03/2006, Time=12:22:87.234, ID=34565, Type=New Order, Client=ITRSThe regular expression will match ID=34565 and the first group will comprise of 34565 and be returned as the value of the tag.
Mandatory: Yes
Verify regex tags
To verify the configured regex tags, enable the
adapter debug setting regexFormatType in GSE:
- Open the Message Tracker sampler.
- Under Debug, click Add new in the Adapter debug field.
- In the Setting drop-down menu, tick the check box for
regexFormatType.
When enabled, the Netprobe log displays the raw incoming message text and the tag values which were extracted from this message. More specific debug can be enabled by providing an adapter name, which will then only output parsing details for the given adapter.
For more information, see the following documentation: