Table of Contents

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%

Acuit Pinpoint Server

Acuit Pinpoint Server application events are saved to text log files in the CommonApplicationData\Acuit Pinpoint\Acuit.Pinpoint.Server folder.

Initially, log entries are written to the Log.txt file. Once that file grows to 100 MB, logging will roll over to the next log file, named Log_001.txt, and then Log_002.txt, and so on. The past 20 log files are retained, so the maximum total size of log files is 2 GB.

A settings.json file in the CommonApplicationData\Acuit Pinpoint\Workstation folder can be used to customize logging behavior. See the appsettings.json file in the Acuit Pinpoint Server installation directory for details.

Most error details are not exposed to the client of these services for security reasons. To obtain details about these errors, examine the log files, which 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 log file).

Acuit Pinpoint Web Application

Acuit Pinpoint web application events are saved to the Log.txt text 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

Acuit Pinpoint Workstation application events are saved to text log files 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.

Initially, log entries are written to the Log.txt file. Once that file grows to 100 MB, logging will roll over to the next log file, named Log_001.txt, and then Log_002.txt, and so on. The past 20 log files are retained, so the maximum total size of log files is 2 GB.

A settings.json file in the CommonApplicationData\Acuit Pinpoint\Workstation folder can be used to customize logging behavior. See the appsettings.json file in the Acuit Pinpoint Workstation installation directory for details.

Fatal errors that prevent the application from starting will 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 before logging has been initialized (when no error details are recorded to a log file as described above).