Log Data Source Script

In this article:

• Creating and Managing
• Embedded Log Data Source Script
• Scripting Basics
• Supported Source Options
• Languages
• See Also

This is a special type of log data source which allows you to use a script to provide raw log data. You can create multiple log data source scripts as custom log data sources. Please refer to How Does ULogViewer Read and Parse Logs for the role of log data source.

Creating and Managing

There are 3 ways to open dialog to manage log data source scripts:

Through Edit Log Profile Dialog

1. Open 'Edit log profile' dialog. There are 2 ways to open the dialog:
   • Click ( before 2026.0) on tool bar, find the log profile and click on the log profile.
   • Click drop-down arrow besides ( before 2026.0) on tool bar and click 'Edit '(log profile name)'…' in menu.
2. Find 'Data source' in 'Log Reading' section.
3. Click [Manage log data source scripts…].

Through Tools Menu

Windows/Linux Users

1. Click at right hand side of toolbar.
2. Click 'Tools > Manage log data source scripts…' in menu.

macOS Users

1. Click 'Tools > Manage log data source scripts…' in menu at top of screen.

Through Other Actions Menuv4.0+

Windows/Linux Users

1. Click at right hand side of toolbar.
2. Click 'Edit log data source script '(name)'' in menu.

macOS Users

1. Click 'ULogViewer > Edit log data source script '(name)'' in menu at top of screen.

Embedded Log Data Source Script

A log data source script can be embedded in a log profile and used by that log profile directly.

Creating and Modifying

There are 2 ways to create or modify embedded log data source script:

Through Edit Log Profile Dialog

1. Open 'Edit log profile' dialog. There are 2 ways to open the dialog:
   • Click ( before 2026.0) on tool bar, find the log profile and click on the log profile.
   • Click drop-down arrow besides ( before 2026.0) on tool bar and click 'Edit '(log profile name)'…' in menu.
2. Find 'Embedded log data source script' in 'Log Reading' section.
3. Click [Create…], [Edit…], [Import from file…], [Import existing] or [Remove].

Through Other Actions Menuv4.0+

Windows/Linux Users

1. Click at right hand side of toolbar.
2. Click 'Edit embedded log data source script' in menu.

macOS Users

1. Click 'ULogViewer > Edit embedded log data source script' in menu at top of screen.

Use Embedded Log Data Source Script

1. Open 'Edit log profile' dialog.
2. Find 'Data source' in 'Log Reading' section.
3. Click drop-down field and select 'Embedded log data source script'.

Scripting Basics

Please refer to Scripting in Application for the basics of scripting.

Supported Source Options

You can specify one or more supported data source options for each log data source script. The supported data source options will be listed in dialog 'Data source options' when editing log profile. ULogViewer makes sure that the value of option will be set before starting logs reading if the option is marked as 'Required'.

Languages

You can use the following languages to create Log Data Source Scripts:

• C# Script
• JavaScript (ECMAScript 5.1)
• Python 3.4

See Also

• How Does ULogViewer Read and Parse Logs