The Preferences>Logging panel allows you to specify what server activities should be recorded for possible later analysis. Normally the logged activities are saved in text files for later review, but you can also request that this activity be displayed in a terminal window. This illustration shows this panel set with all logging enabled.

Note: Logging can affect the performance of the server, so you probably don’t want to leave all logging options enabled for routine operation.

Log Files

Panorama X can generate four different daily log files:

These files are kept inside the Application Support folder on the server. Panorama Server creates new log files each day.

The Sharing Activity log will contain a record of activities that occur as databases are shared, including users logging on and off the server, opening and closing databases, and modifying data.

The Sharing Errors log will keep a record of any errors that occur while databases are shared. Hopefully there won’t be any errors and this log will always be empty, but if you do run into problems, the contents of this log may help with diagnosis.

The Web Activity log keeps a record of every URL that is submitted to Panorama Server from a browser. Only the end of the URL is kept, since the domain name and cgi prefix will be the same for every request. If any form items are submitted with the URL, the data in those items will also be logged.

The Web Errors log keeps a record of any errors that occur when handling web requests from browsers.

Viewing and Manipulating Logs

In the Preferences>Logging panel, each of the four logs has an icon next to it. If the log contains anything, this icon will be colored. If the log is empty, the icon will be gray.

When you click on a log icon a popup menu appears.

For a quick view of the most recent log entries, choose the Display option. This will display the most recent 100 entries in a dialog sheet, with the most recent entries at the top.

To access the log folder, choose Reveal in Finder. This will open a new Finder window with the specified log file selected for you. You can open it in the text editor of your choice, delete it, whatever you want. You can also access older logs in the folder (from within Panorama you can only directly access the most recent log).

If you have a copy of the BBEdit text editor installed, you can open the log directly in BBEdit from the popup menu. In BBEdit, the entire log for the day will be displayed, not just the most recent 100 items. Also, in BBEdit the most recent entries will appear at the bottom of the log, not the top.

Logged Activities

You may be interested in some activities but not others. The Preferences>Logging panel allows you a limited degree of customization as to what activities are logged. Keep in mind that recording more detail can adversely affect the performance of the server. For best performance, we recommend not logging Data Modification (the last two sharing options).

You can change which activities are logged at any time. If the server is already running, the changes will take effect immediately.

Writing Custom Log Entries

You can create your own custom log entries in a web procedure. Simply use the serverlog statement to write anything you want into the web activity log.

html serverlog "Starting my web procedure" cgiHTML = "..." serverlog "Finished my web procedure, "+ info("selected")+" records selected"

Whenever the procedure runs, your text will be output to the log (but only if Web Activity and GET requests are enabled).

Live Logging to Terminal.app

In addition to (or instead of) recording entries in log files, activity entries can also be output to the console if you are running Panorama Server using Terminal.app. This allows you to see the activity entries immediately, in real time (including your own custom log entries, if you’ve coded them). To learn how to do this, see Launch using Terminal.app in Advanced Server Settings.


See Also


History

VersionStatusNotes
10.2NewNew in this version.