IntroductionIntroduction
  InstallingInstalling
  HandlingHandling
  Virtual serversVirtual servers
  ModulesModules
  FilesystemsFilesystems
  RXML tagsRXML tags
  GraphicsGraphics
  ProxyProxy
  Miscellaneous modulesMiscellaneous modules
  Security considerationsSecurity considerations
  ScriptingScripting
  DatabasesDatabases
  LDAPLDAP
  SiteBuilderSiteBuilder
  Access ControlAccess Control
  IntraSeekIntraSeek
  LogViewLogView
    <Installing>Installing<Installing>Installing
    <Configuration>Configuration<Configuration>Configuration
    <Event log>Event log<Event log>Event log
    <Configuration page>Configuration page<Configuration page>Configuration page
    <Troubleshooting>Troubleshooting<Troubleshooting>Troubleshooting
  FrontPageFrontPage
  UpgradingUpgrading
  Third party extensionsThird party extensions
  PortabilityPortability
  Reporting bugsReporting bugs
  AppendixAppendix
 
Configuration page

In this page, a number of aspects of LogView's behavior can be configured. All of these aspects have a section below.

Update
Here, the administrator can manually force an instant update of the statistics gathering, which otherwise takes place once an hour. This can be used for presenting really fresh statistics, or for testing purposes. Update status shows whether the update process is already running at the moment, and if so, its process number.

Logs
A wizard guides the administrator through the steps needed to configure the logs.

  1. Choose a log to configure By default, LogView is configured with one log, the log of the virtual server that LogView is installed on. This log has the same name as the server. More logs can be added using the option Import logs below.

  2. Configure Status and Log name

    Status
    States whether the information from this log should be updated or not. Internal logs are Active or Disabled, external are Imported or Disabled.

    Log Name
    The name used to refer to the log, for example when configuring statistics groups.

  3. Configure miscellaneous attributes Some of the attributes use Pike regular expressions, see Appendix C for the syntax.

    Download files
    Served files with names matching this regexp will be counted in the statistics over downloaded files.

    Page regexp
    Served files with names matching this regexp will be counted in the statistics over served pages.

    Query filter regexp
    This regexp is used for filtering the query part of a request in the popular pages with queries function. Only the query variables that matches the regexp will be displayed.

    Server alias
    This regexp is used for separating internal links from external when keeping track of the visitor's moves using the Pathways functions.

    Server domain name
    This value is used when importing Common log files, which does not always specify the domain of the server.

    Server URL
    This URL is used when creating links in tables, for example links to the pages in a table over popular pages.

Statistics groups
The statistics group are configured in another wizard.

  1. Select the group to configure A new group can be added by choosing that option and filling in the name.

  2. Specify the logs to include in this group These logs are divided into:

    • logs from the current virtual server, either the server's own log or imported logs

    • logs from "remote" virtual servers on which LogView is also installed
    In the list, check the logs that should be included.

  3. Choose the kind of statistics to collect Just select the function groups that are of interest.

  4. Fill in some parameters:

    Max table size
    This restricts the amount of data to be stored in the database for each of the functions enabled on this statistics group, to save disk space and computational time.

    Ignore hosts
    Here, a regular expression matching hosts that are to be ignored in the statistics can be specified.

    Ignore pages
    A regular expression matching pages that are to be ignored in the statistics. This is useful in intranets where statistics are wanted from all hosts excluding certain pages i.e. LogView's.

Example

The sites

http://rhino.ceros.com/
http://hippo.potamus.com/

are located at the sister companies Ceros and Potamus. The administrators of the sites only want statistics of hits from outside these two companies. This is done by setting Ignore hosts to the value

(ceros\.com$)|(potamus\.com$)

Import logs
Using this wizard, the administrator can specify existing logs in the Common log format to be imported into LogView.

  1. Common Log Format file name

    Specify the full path to the log file.

  2. Log name

    Specify a unique name for this log.

  3. Fill in values for a number of log attributes

    Follow the same procedure as in the Logs section above.

  4. Select a statistics group to contain the new log

    A new statistics group can be added by selecting that option and specifying the name.

  5. Configure the statistics group

    This is done as described in the section Statistics groups above.

Delete logs
After selecting the log that is to be deleted, the administrator has the choice of keeping or deleting the log configuration. Selecting to keep will only delete the contents of the log, and LogView will continue to extract statistics from the log in the future. Selecting to delete will make LogView forget about the log altogether, as well as delete the log file.

Rebuild/delete statistics group
After selecting the appropriate group, the administrator has the choice of only deleting the gathered data or the entire group, just as was the case with the logs in the previous section. Selecting Rebuild will only delete the data and then rebuild it from the logs. This could be used when a new log is added to the group, and the statistics for the past up to this point has to be recalculated. Selecting Delete will delete the group as well as the data.

Report maker
A report is a page containing LogView tags tailored by the LogView administrator. Here such pages can be created.

  1. Select the report to edit.

  2. Edit the RXML code and add LogView tags to create the desired kind of diagrams or tables.

    Here the Advanced page in the LogView interface can be of great help - first try out different parameters to get the right look of the diagram or table, and then press the Tag button and copy-and-paste the LogView tag into the report.

    If the report should also be delivered by email, select this in the Report by email box.

  3. If report by email is chosen, some additional information has to be specified. Fill in the email address and edit the From and Subject fields if necessary. Also select how often and, if once a week, on what week day the report should be sent, in the Frequency box.

  4. Confirm the values as usual, and also choose whether a test mail should be sent right away.

Delete report
In the Delete report wizard the administrator can select a report and delete it.