Sonar User Guide

Configuration Parameters

Input Form

Sonar screenshot 

URLs

With each click of the Send Marker button, Sonar will send a marker to each of the targets specified in the input box.  Even though each target is specified as an HTTP or HTTPS URL, it's possible to send markers to any TCP service.  The target is specified as:

  http://target:optional_port_number/unique_string or https://target:optional_port_number/unique_string

where

target is the DNS name or IP address of the device that the marker will be sent to

optional_port_number can be used to override the standard HTTP and HTTPS e.g. 445 for SMB or 1433 for Microsoft SQL default port

unique_string is any string of characters provided that it forms a valid URL

A list of URL targets can be specified, in which case each click of the Send Marker button sends markers to all targets simultaneously.  For example, the URL string;

  http://web01/pc2315, http://fileserver:445/pc2315, http://database:1433/pc2315

would send markers to a web server, a file server and a database server each time the Send Marker button was clicked.

Username

Prior to sending a marker the user can enter their name in this field. This is useful if the marker is to be sent by a group of users experiencing a particular problem.

Seed

Seed specifies the starting number for the markers.  For example, if the Seed value is set to 100 the first marker with have a suffix ?m=100, the next ?m=101 and so on.

Timeout

Timeout allows you to specify the length of time to wait for a response from the destination server before timing out. This value is declared in milliseconds and can be used when the server doesn't respond quickly. Remember the purpose of the marker tool is to insert request data into network traces or server logs and so receiving the response from the server is not essential.