| Table of Contents |
|---|
Product Overview
FIXEye is a multi-purpose FIX session surveillance and visibility platform.
...
- Show all messages
- Use pre-defined filters for searching
- Search and filter messages by a tag-value pair
- Context search
- Search inside the message
| Info |
|---|
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.
...
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
...
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.
| Info |
|---|
The given search method requires the actual version of the FIX dictionary. Otherwise, searching 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 an integral word-group, the space character should be preceded with a backslash ('\') symbol, for example:
...
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.
...
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:
...
FIXEye provides a real-time session states monitoring tool which is Session Watch. Multiple sessions can be monitored at the same time.
| Info |
|---|
A comprehensive step-by-step video tutorial is available on YouTube. |
...
| Colour | State | Description |
|---|---|---|
| Running | The connection is established. The last message in the session log file is received or sent less than 2 heartbeat intervals ago and it is not the Logout message. |
| Disconnected | The connection is broken. The last message in the *.body file is Logout or the last message in the *.in and *.out log files is Logout. OR The last message in the session log file is received or sent more than 2 heartbeat intervals ago. |
FIX Events Viewer
FIXEye can notify and send emails on the following events:
- Connection status - FIX Session status has been changed
- Order acknowledgement time - The time between receiving the order and sending the acknowledgement is exceeded.
Follow the steps to enable notification:
- On the Tools menu, click the Events Viewer. You can also use the Events Viewer button on the toolbar.
- In the FIX Events Viewer dialogue, add files or agents you want to track.
- 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.
| Note |
|---|
| 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.
- Select the respective file checkbox to include the file content in the next search.
- Clear the respective file checkbox to exclude the file content from the next search.
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.
- To add a dictionary file, on the File menu, click Load Dictionaries. You can also click the
icon on the toolbar. The third option is to right-click anywhere on the Files pane, and then click Add Dictionary(ies).
- To remove a dictionary file, right-click the selected file, and click Remove Dictionary(ies).
...
Pre-Populating Real-Time Watches with Files and Agents.
This feature allows to sync files between the main window and the Real-Time Session Watches, Real-Time Watch, and Events Viewer features.
- Open Watch/Viewer window and find the "Sync" button. It's used to synchronize files and folders from the main window to the Watch/Viewer window.
- Click on the "Sync" button. All folders and files from the main window will be added to the Watch/Viewer window.
- If it is required to upload files into Watch/Viewer window manually, navigate to the Watch/Viewer window and select the option to upload files. Follow the prompts to select and upload your files.
| Note |
|---|
If it is required to delete any agent from the main window and then sync in the Watch/Viewer window, the deleted agent will still appear in the Watch/Viewer window. It is needed to manually delete the desired files from the Watch/Viewer window separately. |
Real Time Files Watch View Configuration
The Real Time Files Watch View feature in FIXEye allows to customize how messages are displayed. To configure it, it is required to:
- Open the application and navigate to the Real Time Files Watch View feature
- Choose how the information is to be represented. For example, if select the "Raw Data" option, the information will be displayed in rows:
- To create your own view types, navigate to the main menu. You'll find options to customize the view according to your preferences:
FIX Events Viewer
FIXEye can notify and send emails on the following events:
- Connection status - FIX Session status has been changed
- Order acknowledgement time - The time between receiving the order and sending the acknowledgement is exceeded.
Follow the steps to enable notification:
- On the Tools menu, click the Events Viewer. You can also use the Events Viewer button on the toolbar.
- In the FIX Events Viewer dialogue, add files or agents you want to track.
- 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.
| Note |
|---|
| 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:
Support of wildcards in paths
FIXEye provides the ability to use wildcards (*) in file paths. This feature allows easily upload a series of files in FIXEye.
1.Select upload icon to brows a fille
2. Navigate to the file list
3. Select a file from the list that must be uploaded
4. In the filename or file path, replace the relevant part of the filename or path with an asterisk (*)
5. The application will automatically populate the main window with all relevant files that match the filename or path with the wildcard:
For Windows and Linux Agents:Both Windows and Linux agents in FixEye support wildcards within file paths. To leverage this functionality, it is needed
to manually edit the FixEye Agent Config file and specify the path using wildcards:
Interface
File list
All opened log files are listed in the Files window.
- Select the respective file checkbox to include the file content in the next search.
- Clear the respective file checkbox to exclude the file content from the next search.
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.
- To add a dictionary file, on the File menu, click Load Dictionaries. You can also click the icon on the toolbar. The third option is to right-click anywhere on the Files pane, and then click Add Dictionary(ies).
- To remove a dictionary file, right-click the selected file, and click Remove Dictionary(ies).
Ability to add custom dictionary for folder
FIXEye provides opportunity to add a custom dictionary to log folders. For adding, follow these steps:
- Find and select the "Add custom dictionary" section in the "Browse for folder” form. Upon selection, the "Browse" button will become active.
- Click on the "Browse" button to open a dialog box that allows to upload a file. Navigate to the location of your custom dictionary file and select it.
- If the dictionary file is of the FIX50 version or above, or if you need to attach a transport level dictionary, ensure you select the "FIXT" section.
Once uploaded, your custom dictionary will appear in the list of files.
Note Only one dictionary can be uploaded per file. Attempting to add more than one dictionary to the same file will result in an error message.
If it is needed to change the attached dictionaries, it will require to delete the old dictionary files first before adding new ones.
Session's list
All sessions found in opened log files are listed in the Sessions window.
...