# Web Server Logs
This package monitors users sessions on a website using a ServicePilot Agent.
This package uses the ServicePilot Agent to parse web logs and provide web server usage statistics over time. Statistics include:
- Session count
- Pages viewed
- HTTP Queries
- Client and Server errors
- Bytes sent and received
Note that documents ending in .jpg, .jpeg, .gif, .js, .css, .swf, .ico, .png and .svg are all omitted from the pages viewed statistics collected.
The **ServicePilot Agent** must be installed directly on the target web server.
Network Flows - It is is necessary to ensure network connectivity between ServicePilot and the monitored device. In case of a network infrastructure using a firewall, the port below must be opened:
- ServicePilot Manager Web server access (by default TCP/80 when using HTTP or TCP/443 when using HTTPS although this port is configurable): Between ServicePilot Agent and ServicePilot Manager
- ServicePilot Manager minimum version: 8.5- ServicePilot Agent minimum version: 8.5 installed and configured
Before adding a resource to monitor, make certain that all pre-requisites are in place and if a ServicePilot Agent is required, that it is communicating correctly with the ServicePilot Manager.
Add resource using Views Configuration web interface
- As an administrative user of ServicePilot, open the ServicePilot web interface.
- Navigate to Administration. The Configuration > Views web page will open.
- Click on the view in which to place the new resource in the Views hierarchy on the left of the interface. The View editor section will show the existing view contents.
- From the Packages list on the right of the interface, click and drag the log-webserver package into the View editor and let go.
- The Resource properties dialog box will open to allow resource configuration.
- Click OK to close the Resource properties dialog box. Note that the dialog box will not close if required parameters are not set.
- Click Save to apply the new resource to ServicePilot configuration.
Key field notes
In the Monitoring Policies tab, specify the policy or policies to apply to the resource
Basic Parameters tab:
- Log Format: Format used by the log file (IIS or W3C)
Log File Folder: Full path to the folder containing the web logs
Example: C:\Program Files (x86)\ServicePilot\ServicePilot ISM Enterprise\SERVICEPILOT TECHNOLOGIES\WebLog
Log Parameters tab:
- Log Date format: Date format used in the log file (IIS Log Format only)
- File Prefix: Prefix used used in the log file name. By default 'ex' for W3C and 'in' for IIS.
- Use Local Time: Tick to use local time instead of that of the log file (W3C Log Format only)
- Log Time Period: Duration of time for which the log file is used. This specifies the file name along with the File Prefix parameter. For example a W3C log every minute might be exyymmddhhmm.log or every month would be exyymm.log.
To get monthly W3C web logs for the ServicePilot Manager, enable the this option in the
servicepilot.conf configuration file by adding the following to the
# Write a W3C formatted log for ServicePilot web server activitylogHTTPActivity: True
The log files will be written into a WebLog sub-directory of the configuration