| |||||||
| Note: presents interesting pieces of information related to the surrounding discussion. | ||||||
| Tip: a tip offers advice or teaches an easier way to do something. | ||||||
| Warning: advises you about potential problems and helps you steer clear of disaster. | ||||||
To make it easier for you to spot the examples we have put them in light-grey boxes; | |||||||
| Do not create a symbolic link to make it seem as if a LogView directory somewhere else is inside the server's directory tree -- this may confuse LogView when it analyses the site structure. | ||||||
The installation should now be complete. Configuring LogViewTo configure LogView, start a WWW browser and go to the LogView access page for the server in question. The URL will typically be:
http://server name:server port number/logview/admin/although the "/logview/" part could be different if the administrator of the main server selected a different mount point. The virtual server's module configuration page for LogView has a link pointing to the appropriate page. When attempting going to the LogView access page, the server will ask for a user name and password. Enter the LogView administrator name and password (as entered in the installation above). The administration interface will have the same access pages available as the viewer interface, plus two separate administration pages: Event log and Configure. Event logPressing the Event log button near the top of the page will lead to a page which will offer a choice between two different logs, the Admin log, and the Summary log.The Admin log gives you an overview of the server's performance. The Admin log will display a list of events that took place in the administration interface, such as the administrator logging in, and changes being made in the administration. The list also displays errors like when it failed to compile anything or any occurred errors. The informational messages are preceded by an information icon, while the warning and errors messages are preceded by the warning and error icon respectively:
The Summary log is much more detailed and will give a summary of automatic LogView activities, such as importing logs, updating the local server, updating statistics databases, etc. This log is mainly useful in tracking errors and other problems. ConfigurePressing the Configure button near the top of any administration page will lead to the general configuration page. On this page, there are several options:
Viewing LogView statisticsTo view statistics for a server, go to the LogView access page, and log in as either administrator or viewer. (The only major difference is the obvious one: that administration functions are not available to viewer users.) The URL for the viewer pages is:
http://server name:server port number/logview/although the "/logview/" part could be different if the administrator selected a different mount point. There are four different viewer pages: Statistics, Report, Advanced and Manual (which latter leading to a version of this manual). The Statistics page is the normal way of viewing various statistics, while the Report page provides a quick-and-easy way of getting a summary of recent activities in a statistics group. The Advanced page provides essentially the same functinality as the Statistics page, but with more control over details. StatisticsIf there are several statistics group, the Statistics page will offer a choice of group at the top of the page. If there is only one group, the selector will be absent. Next on the page will be a box labeled 'Period of time', which offers a choice of year or month, with the current year selected by default. When a month is selected, a calendar of individual days and weeks will appear, providing finer granularity in selecting which time period to examine. Select the desired period. Below the 'Period of time' box follows a menu of various categories of statistics to display, including 'Most active domains', 'Popular pages', 'Popular directories', 'Most common browser'. Select which one to view. Once selected, a summary will appear below the menu boxes, together with a menu allowing the user to choose the format of the summary. The following formats are available:
ReportThe Report page provied a quick-and-easy means of obtaining summarized reports of the recent activities of the available statistics groups (as defined in the configuration). The ordinary user is given a choice between a number of report styles (typically one per statistics group, but this depends on the local configuration). The administrator can remove old report styles, and create new ones. Report styles are specified as headerless RXML documents which uses the <logview> tag to generate individual tables and diagrams in the report. AdvancedThe Advanced page allows interactive access to the same functinality as is provided by the <logview> tag (see below), which gives the user individual control of the various report format parameters. This feature is provided for mainly two kinds of users:
The page is a simple fill-in form, where users fill in what statistcs group, report type, time periods etc that they are interested in. Once the information is selected, one of the "Display" buttons below the form is pressed to select the presentation style, and to generate the corresponding diagram. There is a special display mode, 'Tag', which produces the <logview> tag which would generate the selected report if inserted into a RXML document. The <logview> tagThe LogView module provides a special RXML tag, <logview>, which provides an easy way for inserting simple statistics reports in ordinary RXML documents. The usage is simple:
<logview options>where the options are some of the following:
The first thing to do in case of problems is to check
LogViews error log files, and failing that, the main
Roxen server's error log files. Both LogView and Roxen
try to generate comprehensible reports of errors that
occur.
Specific problems:
|