This section describes:
- how to add an agent
- how to rename an agent
- how to remove an agent
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:
- Right-click anywhere in the Files window, then click Add Agent in the right-click menu.
You can also use the Add Agent button.
- 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."
- 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”.
- You can see which files you can browse and what dictionaries the agent uses in the corresponding sub-lists.
- You can only browse static files. No changes in logs will be reflected.
- If you want browse logs in real-time, please see the Watch section.
Rename an agent
You can rename your agent at any time. To rename an agent, perform the following steps:
- Select the required agent and click Edit Agent in the right-click menu.
- Enter a new name in the Edit Agent dialog.
- 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.
To view message details:
- Right-click the selected FIX message, and then click Show Message Details, or use the F3 key. You can also double-click the selected FIX message.
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:
- Open the new data window.
- Paste the copied message (or some text with the part of the message, or sequence of messages) into it.
- 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.
You can compare two messages tag by tag in a separate window.
- Select a message, and then hold down Ctrl key while you click other message you want to select.
- Right-click the selected message and click Compare Messages.
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.
- In the Message Compare dialog, in the Exclusive tags, type the tags with any delimiter, and then click the Compare button to refresh the list.
= values are identical
<> values are different
<= tag is present only in the left message
=> tag is present only in the right message
You can compare two log files message by message using our new Files Compare tool.
- On the Tools menu, click Files Compare.
- Click the Browse at the end of each line to select the files you want to compare.
- Click the Compare.
“<>” indicates that messages are different
- Click the <> to compare 2 messages in a new window.
You can sort messages by the chosen tag in ascending or descending order.
- Click the appropriate table column header to sort messages.
- The direction of the arrow next to the header name indicates the direction of the sort.
- You can reset current sorting by pressing <Esc>.
Message auto filter
You can use different filters to show or hide specific messages.
- Click the arrow next to header name, and then select a required value to apply auto filter.
- To reset filtering, select (All).
- Click the arrow next to header name, and then select (Custom).
- Set up a condition operator and a criterion <value> to compare the current FIX field with some value(-s).
- The filter criteria can either be selected from the drop-down list or entered by the user.