Application Log Files

Various application events and errors are recorded in application log files for each application in the Acuit Pinpoint system. These application log files can be used for diagnosing problems or for auditing purposes.

Acuit Pinpoint log files are saved in folders inside the CommonApplicationData\Acuit Pinpoint folder. The CommonApplicationData folder is the directory that serves as a common repository for all application-specific data that is used by all users. The directory is usually C:\ProgramData, but the specific location can vary, depending on the operating system. To view the folder location, type the following command from the Command Prompt:

echo %ALLUSERSPROFILE%

Apache log4net is used for logging by each Acuit Pinpoint program. Each program's application configuration file can be used to customize the logging behavior (e.g., to cause errors to be emailed).

By default, each Acuit Pinpoint application creates log files in its own folder (as detailed below), logging events to the Log.txt file. Once the Log.txt file grows to 10MB, it is archived to rolling archive files named Log.txt.1, Log.txt.2, etc., deleting the oldest so that a maximum of ten archives are kept at once.

Acuit Pinpoint Server

When unexpected errors occur within Acuit Pinpoint Server, details are logged to the Log.txt file in the CommonApplicationData\Acuit Pinpoint\Acuit.Pinpoint.Server folder. Unexpected errors are also logged to the "Application" Windows event log.

Most error details are not exposed to the client of these services for security reasons. To obtain details about these errors, examine the Log.txt file or the event log entries using the Windows Event Viewer. They will contain error messages and stack traces that can be used to help diagnose the specific problem.

Fatal errors that cause the service to terminate will also be recorded in the Windows Application event log, in events from the ".NET Runtime" event source. These events can be examined to obtain error details when a fatal error occurs as the service is starting, before logging has been initialized (when no error details are recorded to the above Log.txt file).

Acuit Pinpoint Web Application

When unexpected errors occur within the Acuit Pinpoint web application, details are logged to the Log.txt file in the CommonApplicationData\Acuit Pinpoint\Acuit.Pinpoint.Web folder.

Error details are not exposed to web clients for security reasons. To obtain details about these errors, examine the Log.txt file. They will contain error messages and stack traces that can be used to help diagnose the specific problem.

Fatal errors that cause the service to terminate will also be recorded in the Windows Application event log, in events from the ".NET Runtime" event source. These events can be examined to obtain error details when a fatal error occurs as the service is starting, before logging has been initialized (when no error details are recorded to the above Log.txt file). For example, this could happen because the configuration settings have a syntax error that prevents them from being loaded, since configuration settings are used to configure logging.

Acuit Pinpoint Workstation

When unexpected errors occur within Acuit Pinpoint Workstation, details are logged to the Log.txt file in the CommonApplicationData\Acuit Pinpoint\Workstation folder. The "Open Application Data Folder" command from the Help menu can be used to easily open this folder.

Fatal errors that cause the service to terminate will also be recorded in the Windows Application event log, in events from the ".NET Runtime" event source. These events can be examined to obtain error details when a fatal error occurs as the service is starting, before logging has been initialized (when no error details are recorded to the above Log.txt file).