Product overview

FIXEye is a multi-purpose FIX session surveillance and visibility platform.

FIXEye presents search results in an easy to work with form. It has an intuitive graphical user interface and uses many operational features familiar from MS Excel.

FIXEye can process multiple log files distributed on the network.

FIXEye features

The FIXEye platform includes the following features:

FIXEye main window

Components of FIXEye's main window are indicated in the screenshots below:

Starting FIXEye

Quick start

At the very beginning FIXEye displays a dialog form for opening log files. You can either browse for files by clicking the corresponding step or skip this step by clicking the Cancel button.

Open file

On the File menu, click Open Log Files or Open Log Folder.

You can also use the button on your toolbar.

Open multiple files with FIXEye

A user can use the "Send to" Windows function to opening files in FIXEye.

Multiple tabs

FIXEye allows creating multiple data windows (tabs). It is possible to specify different search text, filter, and view for each data window.


Search with FIXEye

Search methods

FIXEye has several ways to search messages in the files:

The search process can be stopped by clicking the Cancel button on the status bar.

Show all messages

FIXEye searches for all FIX messages in the specified files without any additional filtering.

Use pre-defined filters for searching

Pick a filter from the list and search for specific message types.

For details, refer to Pre-defined filters.

Search and filter messages by a tag-value pair

FIXEye can search for messages by a tag-value pair. Values, in this case, are treated as whole words. 

Search by tag-value pair is case sensitive.

FIXEye also accepts regular expressions for this search method, for example: "35=[A58]".

This type of search can be combined with using pre-defined filters, which makes it the fastest way for searching messages. Search by tag-value pair has priority over other types of search, so only tag-value expressions will be used for the search.

Text other than FIX messages is ignored by FIXEye.

The given search method requires the actual version of FIX dictionary. Otherwise, search by custom tags will not return any results!

The given search method doesn't work with repeating groups. Please search by context instead.

The space character acts as the logical operator AND. For searching a tag-value pair in which the value is represented by integral word-group, the space character should be preceded with backslash  ('\') symbol, for example: 

"58=Unknown\ Reason".

Regular expressions should be used for the logical operator OR

Examples

Case 1. Search by a single tag-value pair

Query: 35=d

Explanation of search query: Only messages where condition 35=d is true will be displayed in the output

Case 2. Search by two or more tag-value pairs

Query: 35=d 34=6

Explanation of search query: Tag-value pairs are separated by the space character. Only messages where condition 35=d is true and 34=6 is true will be displayed in the output.

Case 3. Search by a single tag-value pair where the value is represented by integral word-group

Query: 58=Unknown\ Reason

Explanation of search query: For searing "Unknown Reason" in Text (58), the backslash symbol precedes the space symbol, not to interpret the space as a the logical operator AND.

Context search

Context search means that all input in the "search box" is considered to be plain text. It is divided into search queries according to the rules described below. These search queries are searched for in the input log file. First a text put in the “search box” is analyzed.

Text in quotes (" ") is considered as one search query and is taken as the integral text phrase for the search engine. The input text is divided into many queries when space characters are met. Each query is searched. Here, the space character means the OR logical operator. The plus character (+) at the beginning of a query is used to indicate the logical AND operation. That means that searching <query1> +<query2> will lead to success only if both query1 and query2 are found in the input stream.

If only +<query> is present in the search string, then no matches will be found even if <query> is contained in the input stream

Context search differs from the search by a tag-value pair. The entire input stream is analyzed, and the results are shown only at the end. Note, context searching may take a long time if the input file is big! You can click the Cancel button at the bottom of the page to stop the process. 

Searching for search queries in a FIX message is more complicated than the ordinary plain text search. First, the search engine looks for search queries in a raw FIX message. Then the FIX message is parsed and tag IDs are converted to names, (e.g. 35=A is turned to MsgType=A) and the search engine looks for search queries again. And for the third time, search tag values are converted to text equivalents, (e.g. 35=A is turned to MsgType=Logon). At the display step, all FIX messages satisfying search criteria are displayed. 

Context search is case insensitive.

Examples

Examples for the context search method can be found below.

Case 1. Search by a single one-word query

Query: heart

Explanation of search query:  Messages with the "heart" query have been found in 35 tag and 108 tag

Case 2. Search by several queries in a row delimited by spaces, no quotes used

Query: heart security

Explanation of search query:  All messages have been displayed where "heart" or "security" query have been found

Case 3. Search by a single multi-word query, enclosed in quotes

Query: "list of securities"

Explanation of search query:  All messages have been displayed where the integrated "list of securities" query has been found

Case 4. Search by several queries in a row delimited by " +" character, no quotes used

Query: security +gas

Explanation of search query:  All messages have been displayed where "security" and "gas" in a single word-group have been found

Data search + pre-defined filter 

It is sometimes useful to do some preliminary filtering and start searching within the filtered results. For more information on pre-defined filtering, refer to Pre-defined filters.  When the filter is set and text is entered in the search box, FIXEye will first apply the filter and then search the filter's output.

Search within message details

You can search for a specific context in a raw message.

FIXEye-Splunk integration

Some basic capabilities for searching in the Splunk system using FIXEye have been introduced (since 4.1 version). See How to use FIXEye-Splunk integration capabilities.


Agent

This section describes:

You can use an agent to browse log files on a remote computer if direct access to the machine is prevented due to security or other issues.

Add an agent

Please note that the agent should already be installed, configured and able to run on the remote computer.

To add an agent, perform the following steps:

  1. Right-click anywhere in the Files window, then click Add Agent in the right-click menu.


    You can also use the Add Agent button.


  2. In the Add Agent dialog, define your connection parameters, such as Name, Host, Port, Login and Password. If you need to connect the agent immediately, select the "Connect now" check box. Make sure the name you choose has not been used before. Otherwise, you will get the warning message:  "The agent with the entered name already exists." 
  3. Click Add to save your agent settings.


If "Connect now" is selected, the connection is available, and everything is set up properly, your agent will launch and its status will change to “Connected”.

Rename an agent

You can rename your agent at any time. To rename an agent, perform the following steps:

  1. Select the required agent and click Edit Agent in the right-click menu.
  2. Enter a new name in the Edit Agent dialog.
  3. Click Save to finish renaming. Your agent is renamed.

Another option to rename an agent is to select it and click it once to apply the 'in place' editing mode. Then you can change agent's name and press <Enter> to save your edits.

Remove an agent

To remove an agent, select the required agent and click Remove Agent in the right-click menu. 

Confirm deletion in the Remove Agent pop-up dialog by clicking Yes. Your agent is removed.

Messages

Message details

To view message details:

The Message Details window has the following view:

Paste a message

You can paste a FIX message or the sequence of FIX messages from the clipboard or type them manually in the new data window (tab) to process the message.

To paste a FIX message:

  1. Open the new data window.
  2. Paste the copied message (or some text with the part of the message, or sequence of messages) into it.
  3. Click OK to process the message.

You can type your own message manually in the new data window with observing proper FIX message syntax. Use the SOH button to insert the Start of Header separator.

The pasted messages are processed the same way as messages taken from the log file or from the agent.

If the entered string doesn't fit validation rules, then the warning message is shown according to the FIXEye error handling rules.

On hovering the warning icon, the error message is popped up. You can also find out an error explanation by selecting the Errors tab as shown below.

Compare messages

You can compare two messages tag by tag in a separate window.

Please note, that if you select more than two messages, FIXEye will compare only the first and the last one.

You can exclude separate tags from the comparison.

= values are identical
<> values are different
<= tag is present only in the left message
=> tag is present only in the right message

Compare files

You can compare two log files message by message using our new Files Compare tool.

“<>” indicates that messages are different

Sort messages

You can sort messages by the chosen tag in ascending or descending order.

Message auto filter

You can use different filters to show or hide specific messages.


Additional tools

Watch

FIXEye provides a powerful real-time monitoring tool which is Watch. You can create multiple processes with various filters and search parameters to follow updates in selected files.

You can stop or pause the process in the Realtime Files Watch window using the corresponding buttons on the Watches toolbar.

You can add an agent to monitor the files on a remote computer.

FIX Events Viewer

FIXEye can notify and send emails on the following events:

Follow the steps to enable notification:

  1. On the Tools menu, click the Events Viewer. You can also use the Events Viewer button on the toolbar.
  2. In the FIX Events Viewer dialog, add files or agents you want to track.
  3. Create a subscription.

Click the button on the FIX Events toolbar and select your subscription type.

Connection status

Specify the expected FIX connection status for notification.

Order acknowledge time

FIXEye can compare the time from SendingTime (52) tag between order and the first acknowledgment on it. This check can be used if one needs to monitor delays in message processing.

The precision between order and acknowledgment can be different (e.g. Milliseconds vs microseconds) which leads to unexpected/wrong results. Use this option only in case of the same accuracy.

Configuring Email notifications

To receive an email notification on Select the E-mail Notifications checkbox and click on the Configure to set up an outgoing mail server.


Interface

File list

All opened log files are listed in the Files window.

Dictionaries list

FIXEye covers standard FIX-features by default, but you can work with non-standard FIX-dialects after loading special files (XML-format) that contain the necessary descriptions.

Sessions list

All sessions found in opened log files are listed in the Sessions window.

Customizing interface

You can adjust the viewing depending on how you arrange the windows in the FIXEye. The following options are just some of the ways that windows can be arranged:

Tool windows can be docked to one side of a frame in the FIXEye:

Tool windows such as Files and Sessions support a feature named Auto-Hide. When a window is auto-hidden, its name and icon are displayed on a tab at the edge of the FIXEye.
To turn on Auto-Hide:

To Turn off Auto-Hide:

Tool windows can be undocked from the FIXEye and moved anywhere on the desktop.

Pre-defined filters

You can use different filters to show specific messages only.

Do one of the following:

When you are creating a new filter, you may indicate one or more conditions.

You can save a back copy of the current filter by clicking button in the Filter window.

You can address a field tag, which is a part of a repeating group while creating a new filter.

Custom view

You can customize a message view (a set of displayed columns) in the table.

Do one of the following:

The “Compact” preset view allows showing messages in a compact form, i.e. numbers for tags and values without description.
The “Detailed” preset view allows showing maximum information about messages. All tag names except service fields are displayed and all field values are described.
The “Raw Data” preset view allows displaying messages in their raw view, i.e. as a row of symbols.

The “Colored” preset view allows displaying messages in different colors, i.e. a particular color is assigned to every message type, to facilitate visual perception of table data.

When you are creating a new view, you may indicate one or more conditions. Use to add fields and formatting rules and to delete them.


Validation

Message validation

You can validate messages in the table against FIX rules.

There are 3 levels of validation:

Invalid messages are marked in the table with icon.
Related error descriptions are placed into the Errors tab of this data window.

Order backtrace

This feature shows a trade process as a chart of its states defined by related FIX-messages.

Click on a message or a state shape to see the related object details.

Session backtrace

This feature shows a session process as a chart consisting of its states defined by related Logon and Logout messages and Test Requests.

Click on a message or a state shape to see the related object details.

Click on a message or a state shape to see the related object details.

Order / Session backtrace customizing

You can customize text displayed in shapes.

It is possible to create a dedicated string for each message and state type. It is also possible to put a field value into the string.

Order Blotter

You can check the recent status of orders from the loaded files using Order Blotter.


Export

Export backtrace data

You can export data from Order and Session Backtrace diagrams as an image or a plain text.

Export table data

You can export table data to a separate text file (.csv or .fix)