Exception Log

Overview

The TASS.web Exception Log records exceptions (or errors) that occur during program or system execution. It is designed to help software developers and administrators track and diagnose issues by providing detailed information about the nature and context of the exceptions that have occurred.

The log includes a timestamp of when the exception occurred, a description of the error, the stack trace sequence of function calls leading to the error, and additional data about the system's state when the error occurred.

For assistance with Exception Log diagnostics, please contact Software Support.

Click here for an Administrator Note.

Administrators of self-hosted schools can add the following lines to the [mail] section of the tassweb.ini file to receive Exemption Log notifications via email each time a new error occurs.

Function	Line Example
Sent To	Notify=custom@domain.com
Sent From	Exception=custom@domain.com

If you are unfamiliar with the tassweb.ini file and how it operates, do not make changes. Contact Technical Support for assistance.

Administrators of cloud-hosted schools must contact Technical Support for assistance.

Exception Log

The Exception Log screen is divided into the following three columns:

REF	An exception reference number. This may have appeared on the user's screen when the exception occurred.
DATE/TIME	A timestamp that indicates the date and time when the server logged the occurrence of the exception.
DIAGNOSTICS	A description of the error.

You can click on any data row to view more details. Refer to the Exception Details section below for additional information about the details displayed on this screen.

	Click the 'Refresh' icon to update the information on the Exception Log screen, including any errors that have occurred since the screen was first loaded. The date and time of the last screen refresh are displayed in green font at the top of the screen, next to the program name.
	Click the ‘Consolidate’ icon to combine the data displayed on the screen and group similar errors together. When you select this option, a ‘#’ column will appear, indicating how often each error has occurred. For example, ‘x3’ means that the same error occurred three times.
	After clicking the 'Consolidate' button, click the ‘Expand’ icon to return to the standard view.

Exception Details

This screen is accessed by clicking on a data row from the Exception Log screen.

The Exception Details screen provides additional information about the system's state at the time of the exception, including the stack trace, which details the series of function calls that led to the error.

The information shown on this screen varies based on the situation. Not all fields mentioned below may appear. If you have any questions, please contact Software Support.

Reference Number
Description	A description of the exception that occurred.
Detail	If available, specific details for the product area where the exception occurred will be provided.
Date/Time	A timestamp that indicates the date and time when the server logged the occurrence of the exception.
Product	Identifies the TASS Product or API function where the exception occurred, including the TASS software version number in brackets. The grey font at the end represents the TASS build number.
Template	The file path of the application file that is generating the exception.
Stack Trace
Stack Trace Details	The sequence of function calls leading to the exception.
Request
Domain	The domain name of the TASS instance in which the exception occurred.
Referrer	The HTTP Referrer header is an optional field containing the address of a user's previous web page. It is included in an HTTP request when a user clicks a link in their browser.
User Agent	A string that identifies the application, operating system, vendor, and version of the requesting user agent.
Action	The API or browser feature that triggered the exception.
Query	Specific details regarding the function where the exception occurred. Most likely, the API query that is making the request.
User
Company	The TASS.web Company Number in which the exception occurred.
User	The Entity Code or TASS.web User ID of the logged user.
Community Enabled	This legacy field was previously used for Community, but it is no longer in use.
IP Address	The content of this field varies based on how the exception was created. It may display either the IP address of the TASS server or the IP address of the users. For instance, if an end-user generates an error, the field will show the IP address of the individual who caused the exception.
Query
Query	The function details or log of the data attempted for processing in the database.