Basic Concepts

To get the most out of its capabilities and features, you should be familiar with its concepts. Concepts describe the basic notions of the tool.

Monitor

A monitor contains context logging monitoring preferences. When created this will open in the Monitor Window and lets you start monitoring.

Context Logger

This determines the information we want to monitor in the Piraso enabled application. Example are SQL and log4j context loggers, which let you monitor SQL executions and log4j log entries respectively.

Profiles

Profiles are set of monitors. When created this will open all associated monitors in the Monitor Window.

Entry

This is a monitor entry. An entry corresponds to one row in the Monitor Window.

Request

This determines the entries scope in a monitor. Monitor entries are usually group per request.

Workspace

Below shows the Piraso client application workspace.

General Toolbar

	Click this to create new Profile or Monitor instances.
	Click this button to open a saved Monitor request entries.
	Click this button to save the currently selected Monitor instance.
	Click this button to reconnect the disconnected Monitor instance. Connected A monitor with icon on the tab means that the Monitor instance is connected.
	Click this button to disconnect the Monitor instance. Disconnected A monitor with icon on the tab means that the Monitor instance is disconnected.
	Click this button to manage Monitors.
	Click this button to manage Profiles.

Monitor Window

The window is tab-based. When you create a new monitor instance, it opens in its own tab. This displays the monitor entries in a table captured from the piraso enabled application.

Toolbar

	Click this button to clear the current monitor request entries.
	Click this button to initiate a new search. This toggles the display of the search pane. Match Case If this check box is selected, Piraso client will distinguish between upper and lowercase letters while searching.. Whole Words if this check box is selected, Piraso client will search for whole words only, that is, for character strings separated with spaces, tabs, punctuation, or special characters. Regular Expression If this check box is selected, the search string will be perceived as a regular expression.
	Click this button to toggle the auto-scrolling of received from the monitored application. When the auto-scroll is active you won't be able to switch requests. You need to explicitly disable to be jump from one request to the other.

Request Explorer

Displays all Monitor instance and all its requests on tree view.

Monitor Preferences

These are context logger preferences for the selected monitor. This is the preference you customize to configure the amount of information you want to receive during your monitoring.

General Monitor Preferences

These are your general monitoring preferences.

Enable stacktrace for the support entries

Select this if you want your request entries to support stack trace. Please do note that only those entries that support it will show the stack trace.

Enable hiding of external resources

Deselect this if you want that every request should be track including request for external or static resources.

Disable request context

Select this if you don't want the Monitor instance to separate per request. This will display request entries in a single table.

Log4j Monitor Preferences

This determines the log4j context logger monitor preferences. In here you can select which logger log entries and their corresponding log levels should appear for monitoring.

Go to Tools > Log4j Loggers to open the Log4j Logger dialog and manage your loggers.

SQL Monitor Preferences

This determines the SQL context logger monitor preferences.

Enable connection logs

Select if you want to monitor SQL Connection log entries.

Enable prepared statement logs

Select if you want to monitor SQL Prepared Statement log entries.

Enable result set logs

Select if you want to monitor SQL Result Set log entries.

Spring Monitor Preferences

This determines the Spring context logger monitor preferences. Right now only Spring Remoting is supported. This is needed when you want to cascade the monitor context from one server to the other when doing a remote call.

Request View

This displays the entry http request information.

Cookies

This displays all the Http Request cookies.

Headers

This displays all the Http Request headers.

Parameters

This displays all the Http Request parameters.

Log4j View

Click on a log4j entry from the Monitor Window to show this view.

Exception

Click this button to show the exception. This will only show when the selected log4j entry has an associated exception.

Stack trace

When stack trace logging is enabled this button shows the log4j entry stack trace.

	Click this button to show the table of the set query parameters.
	Click this button filter the stack trace from the Exception and Stack trace view.

XML

When a log4j entry has a XML message then this view will be available. This will pretify the XML message as displayed below.

URL

When a log4j entry has a URL message then this view will be available. This will pretify the URL as displayed below.

SQL View

When a SQL Prepared Statement entry is selected, this view will activate and shows the SQL statement.

Toolbar

	Click this button to show the table of the set query parameters.
	Click this button to replace all sql parameters into literal values.
	Click this button to format the SQL statement.
	Click this button to copy the SQL statement.

SQL Data View

When a SQL Result Set entry is selected, this view will activate and shows the retrieved records from the database.

Toolbar

	Click this button to show the table column meta data definitions.
	Click this button to copy the records as CSV.