14.2 Conversion Dialog

Open the File menu and select Convert... to open the Conversion dialog. In this dialog you can define how to convert a log. This definition is called a conversion rule.

A conversion rule can be made persistent and can be reused later. You can store a conversion rule by entering a name in the Persistent record definitions list control and by clicking on the Store button. To use an existing conversion rule select it from the Persistent record definitions list control and click Load. Pressing the Delete button will remove the selected conversion rule.

The Columns list control displays all columns that are available in the currently loaded layout. If you want the information of a column to be part of the converted log you must add the column to the Record definition list. You can do this by selecting the column and by clicking Add to add it to the end of the Record definition or Insert to insert it before the column which is currently selected in the Record Definition list. Besides columns you can also add separators from the Separators list (spaces, tabs, etc.) in the same manner as for columns. Next to the Record definition list control you have buttons to manipulate the record definition. Clear removes all items from the Record definition list whereas Remove removes only he currently selected item from the Record Definition list. Arrow up and Arrow down move the currently selected item up respectively down in the Record definition list.

In the Options you can select the conversion/exporting method in the Encoding drop-down list:

  • ANSI, UTF8, UTF16

  • XML, HTML, HTMLREPORT

  • SENDMAIL, SYSLOG

In the File name edit control you must provide the destination of the log conversion. The destination can be a file but it can also be e.g. a syslog server or a database server. To use a server as the destination of the conversion you must provide a .ini file which must contain all required information to communicate with this server (e.g. IP address and port). You can click on the button on the right side of the File name edit control to open a file selection dialog.

You can also specify whether the converted log records shall be appended or whether the existing log records shall be overwritten (check box Append data).

In the Record filter edit control you can specify a filter so that only log records are converted that match this filter. Press the button with the dots (“...”) to start a dialog that supports you in creating a record filter. To read more on how to create record filters go to the section Analyze Functions. When you press the Apply Active Record Filter button Ascolog Insight creates a record filter for the conversion based on the active record filters of the Functions tree. The created record filter will be displayed in the Record filter edit control.

In order to execute a conversion/export press the Save button on the bottom of the dialog. When you press the Preview button you can see an excerpt of the input which is passed to the conversion/export. Please note that the preview DOES NOT show the result of the conversion/export, e.g. the content of the destination file. If you don't want to convert logs press the Cancel button. Be careful to store the conversion rule before pressing the Cancel button when you want to reuse it.