Webalizer Usage Reports
Please note. The legacy Webalizer Usage Reports depend on the open-source Webalizer tool, which parses logs generated by Apache or IIS. The Webalizer-based Usage Reports were disabled in CONTENTdm 6.9 and removed from CONTENTdm Administration in version 6.10. Please see the CONTENTdm-native Usage Summary and Item Pageviews reports, and (for more complex reporting) consider taking advantage of CONTENTdm's support for Google Analytics.
Webalizer Usage Reports use the following terminology:
Hit: Any logged request made to the server. The request can be for any type of file or script. A request does not have to be successful to be counted as a hit.
File: Successful requests served by the server are counted as files. A file can be an HTML page or a processed page, such as a PHP page, or an image. File total in the reports is a subset of hits total.
Page: The number of pages requested only (does not include elements in the page, such as images). PHP files and CGI scripts are counted as pages.
Item View: When a specific CONTENTdm item or object is requested.
Visit: Determined by a calculation of when a request was made to the server from an IP address (host) and the amount of time since a previous request by the same IP address.
- Using Usage Reports
- Configuring Reports
- Summary Reports
- Top URLs
- Error Summary
- Referring Sites
- IP Addresses
- Authenticated Users
You can view usage reports through the Web interface or you can access raw log files to use in your own reporting applications.
To access usage reports:
Open CONTENTdm Administration and click the Server tab.
Click Usage Reports. The Usage Reports page displays.
Choose from monthly summary reports or use the drop-down list to select other, specific reports for that month.
Click View Log Files to access the full list of server log files that you can then download and use in other applications.
Note: If you have a new instance of CONTENTdm and no log files exist or if the automatic update scripts still need to run for the time period you are interested in, you may find that data is temporarily not displayed or may not yet fully reflect recent usage.
You can optionally configure the data used and ignored for usage reporting. For example, you can enable filtering to ignore search engine bots, specific IP addresses, URLs, referrers and more.
By default, all data is included in the Usage Reports for locally installed users. (If you use the Hosted version of CONTENTdm, search engine bots are filtered by default).
To configure reports and enable data filtering, edit the configuration file (/conf/webalizer_user_options.conf). Instructions are included in the file. For more information, see also the server installation guides available in the User Support Center. (If you use the Hosted version of CONTENTdm, you can contact Technical Support for configuration assistance.)
Summary reports include the following:
Item View Summary enables you to review the number of items viewed per collection during the selected month. You also can access the total views per item from this report.
To view item view summary:
- From the Usage Reports page, click Item View for the month you want to analyze. The Item View Summary page displays. Click Export to download a .csv file of the item views per collection.
Click Total Views Per Item for the collection you are interested in. The Total Views Per Item page displays the top 200 items viewed in this collection during the selected month. Click Export All to download a .csv file of all views per item (not just the top 200).
Click an item title to view the item in the CONTENTdm collection.
Note: If your collection contains compound objects, views of individual pages of compound objects are compiled into total views for all pages of the object. (For objects with more than five pages, you can expand the compound object data to access the number of views per page.)
Top Searches enables you to review the top 100 search phrases used when searching in CONTENTdm during the selected month.
The data includes searches of all collections. Boolean operators (and, or, not) that may have been used to define searches are not displayed.
To view top searches:
From the Usage Reports page, click Top Searches for the month you want to analyze. The Top Searches page displays. Click Export All to download a .csv file of the report data.
The Monthly Summary report provides usage statistics for the selected month and year. The data in this report is cumulative and displays the compilation of data for the month through the time and date the last report was generated.
To view monthly summary:
From the Usage Reports page, click Monthly for the month you want to analyze. The Monthly Summary page displays.
The Daily Summary report provides usage statistics per day. The data in this report is cumulative and displays the compilation of data for the day through the time the last report was generated.
To view daily summary:
From the Usage Reports page, click Daily for the month you want to analyze. The Daily Summary page displays.
The Hourly Summary report provides usage statistics by hour for the selected month. The data in this report is cumulative and displays the compilation of data hourly through the day and time the last report was generated.
To view hourly summary:
From the Usage Reports page, click Hourly for the month you want to analyze. The Hourly Summary page displays.
You can use the Top URLs report to learn the popular URLs on your CONTENTdm Server and to learn about overall trends in where users enter and leave your collections.
Note: Entry page and exit page statistics are estimates because of limitations in the HTTP protocol and other factors.
To access the URLs report:
From the Usage Reports page, select URLs from the drop-down list for the month you want to analyze. The Top URLs page displays.
Click View All to access the full report. Click the URL to view that page on the server.
You can use the Error Summary report to learn which URLs caused the top 20 errors users encounter on your CONTENTdm Server.
To access the Error Summary report:
From the Usage Reports page, select Errors from the drop-down list for the month you want to analyze. The Error Summary page displays.
You can use the Referring Sites report to learn the top 30 URLs that linked users to a URL on your CONTENTdm Server.
To access the Referring Sites report:
From the Usage Reports page, select Referring Sites from the drop-down list for the month you want to analyze. The Referring Sites page displays.
You can use the IP Addresses report to learn the unique IP addresses that made requests to the server during the time period.
Note: IP addresses are not unique individual users who visited, however, it could be used as a rough estimate.
To access the IP Addresses report:
From the Usage Reports page, select IP Addresses from the drop-down list for the month you want to analyze. The IP Addresses page displays.
You can use the Authenticated Users report to learn about authenticated user activity on your server, including number of item views and visits by user name for the selected time period.
To access the Authenticated Users report:
From the Usage Reports page, select Authenticated Users from the drop-down list for the month you want to analyze. The Authenticated Users page displays.
You can use the Browsers/Platforms report to learn what browsers and platforms (user agents) are used to view your collections.
To access the Browsers/Platforms report:
From the Usage Reports page, select Browsers/Platforms from the drop-down list for the month you want to analyze. The Browsers/Platforms page displays.
You can use the Geographics report to learn which regions and types of users bring your collections the most traffic.
To access the Geographics report:
From the Usage Reports page, select Geographics from the drop-down list for the month you want to analyze. The Geographics page displays.
Geographics data is based on the identified domain name extensions of your users. Because the data is based on extension, you also will see information about other extensions, in addition to the country-specific extensions. For example, you may see nonprofit organizations (.org), US commercial (.com), and US government (.gov) listed as part of your traffic in this report.
Note: Because of how country totals are computed, the pie chart for some incremental reports will not be accurate. When monthly reports are complete for a given month, the geographic pie chart and data accurately depicts the regions where your traffic originates.