Site Stats
From CLEW Wiki
Included in 2.7.X upgrade - The Site Stats tool allows authorized users (e.g. Instructors, TA-graders) to view site usage statistics.
Contents |
Site Stats: Overview
The Site Stats tool allows authorized users to view site usage statistics. Statistics can be accessed by clicking Site Stats in the Site Management section of the left menu on the CLEW course or project site, and then clicking Overview. This presents a quick overview of the site's usage statistics (for Visits, Activity, and Resources). Detailed reports can be customized and generated from the "Reports" page.Key Concepts
- Visit: The act of entering (visiting) a site.
- Activity: Events generated by tool actions (e.g., new chat message, resource opened, etc). The list of tools/events that count as activity can be configured by clicking on the Site Stats link in the CLEW site's left menu, and then clicking on Preferences.
- Resource: Any Resource file/folder item related activity (new, open, edit or delete).
Things to Consider
To complete the procedures in this article, you must be assigned a role having the necessary permissions. This often excludes Students and TAs by default. To determine your role and accompanying permissions, follow the directions in Permissions and Roles.
- On the same login session, if a user enters/exits the same site multiple times only one visit will be recorded.
- On the Overview page, statistics for Resources refer to file/folder-related activity from the Resources tool only.
- Site Stats is a tool for CLEW course sites and does not appear in the left menu of ‘My Workspace’. It is not available to all participants, and does not appear in the left menu for students (click Student View to see the tools listed in the left menu of the course site for student participants).
- To use Site Stats to collect participation data for a course site, you must ensure that the tool is activated for your site using Site Editor (see Adding or Removing Tools); the Site Stats link will appear in the left menu of the course site when activated. Be sure to check that teaching assistants have been assigned a role with the appropriate permissions (e.g. TA-Grader) if they need to use Site Stats.
- Statistics may not be updated instantly, but may be updated on a regular time interval (e.g., once per day). Contact CLEW support for details.
Site Stats: Overview - Summary Statistics
Overview: Summary of Site Visits
The following information is displayed for "Visits" on the Site Stats Overview page:
- Visits: Total number of site visits (Note: on the same login session, if a user enters/exits the same site multiple times only one visit will be recorded.)
- Users who have visited site: Total number of distinct users that visited the site.
- Site members: Total number of users that are member of the current site.
- Members who have visited site: Total number and percentage of users that are site members and have visited the site. This number may differ from the number of unique 'Visits' if there are visits from users that are no longer members of the site.
- Members who have not visited site: Total number and percentage of users that are site members and have not visited the site.
- A more detailed report can be obtained by clicking on one of the above items: (e.g., Clicking on Members who have not visited site will display a report of all site users that never visited the site).
- Click Export to choose the format to export this data
- Click the appropriate format (i.e. Click Export xls, Export csv, or Export pdf).
- A 'File Download' window will open; choose whether to Open or Save the exported file.
- Clicking on the Show more link will present a chart and table view for a quick view of visits statistics.
Some considerations:
- Clicking on By date or By user will group statistics by date or user, respectively.
- Selecting Since site creation, Last 365 days, Last 30 days or Last 7 days will filter statistics accordingly.
- Clicking on the chart image will produce a maximized version of the image.
- Clicking on View complete report below the table will display the full data for the current displayed statistics.
- Click Export to choose the format to export this data;
- Choose the appropriate format (i.e. Click Export xls, Export csv, or Export pdf).
- A 'File Download' window will open; choose whether to Open or Save the exported file.
- Click Back to return to the "Overview" window.
Overview: Summary of Site Activity
The following information is displayed for "Activity" on the Site Stats Overview page:
- Events: Total number of site activity events (from the list specified on the Site Stats "Preferences" page).
- Most active tool: The tool that generated the most events (from the list specified on the "Preferences" page). Hovering the mouse over the value will display the full tool title.
- Most active user: The user that generated the most events (from the list specified on the "Preferences" page). Hovering the mouse over the User ID will display the full user name.
- A more detailed report can be obtained by clicking on the items above (e.g., clicking on Most active user will display a report with total activity per user, sorted by total activity). This information can be exported by:
- Click on Export
- Click on the appropriate format for the exported file (i.e., Export XLS, Export CSV, or Export PDF)
- Click on Open or Save
- Click on Back to return to the "Overview" page
- A more detailed report can be obtained by clicking on the items above (e.g., clicking on Most active user will display a report with total activity per user, sorted by total activity). This information can be exported by:
Clicking on the Show more link will present a chart and table for a quick view of activity statistics. Some considerations:
- Click on the By date, By user or By tool tab to group statistics by date, user or tool, respectively.
- Select Since site creation, Last 365 days, Last 30 days or Last 7 days to filter statistics accordingly.
- Clicking on the chart image will produce a maximized version of the image.
- Clicking on the View complete report below the table will display the full data for the current displayed statistics. This information can be exported by:
- Click on Export
- Click on the appropriate format for the exported file (i.e., Export XLS, Export CSV, or Export PDF)
- Click on Open or Save
- Click on Back to return to the "Overview" page
Overview: Summary of Resource Activity
The following information is displayed for "Resources" on the Site Stats Overview page:
- Files: Total number of existing site files (folders excluded) in the Resources tool.
- Files opened: Total number and percentage of site files (folders excluded) in "Resources" that have been opened for reading.
- Most opened file: The site file (in "Resources") that was opened most often for reading. Hovering the mouse over the truncated File name of the resource will display the full resource file name.
- User who has opened the most files: The user that opened the most site files (in "Resources") for reading. Hovering the mouse over the User ID will display the full user name.
- A more detailed report can be obtained by clicking on the items above (e.g., clicking on Files opened will display a report of all opened files with the number of times each was opened). This information can be exported.
- Click on Export
- Click on the appropriate format for the exported file (i.e., Export XLS, Export CSV, or Export PDF)
- Click on Open or Save
- Click on Back to return to the "Overview" page
- A more detailed report can be obtained by clicking on the items above (e.g., clicking on Files opened will display a report of all opened files with the number of times each was opened). This information can be exported.
Clicking on the Show more link will present a chart and table for a quick view of resource activity statistics. Some considerations:
- Click on By date, By user or By resource to group statistics by date, user or file, respectively.
- Select Since site creation, Last 365 days, Last 30 days or Last 7 days to filter statistics accordingly.
- Clicking on the chart image will produce a maximized version of the image.
- Clicking on View complete report below the table will display the full set of data for the current displayed statistics. This information can be exported.
- Click on Export
- Click on the appropriate format for the exported file (i.e., Export XLS, Export CSV, or Export PDF)
- Click on Open or Save
- Click on Back to return to the "Overview" page
Site Stats: Reports
View Site Stats Reports
Detailed "Site Stats Reports" can be accessed in several ways after clicking on Site Stats in the left menu:
- From the "Overview" page:
- Click on Show More for "Visits", "Activity", or "Resources".
- Click on View complete report.
- Select Tab (e.g., "By Date", "By User", "By Tool") to filter the statistics in the report
- For reports about the specific details listed on the "Overview" page, click on the text below the numbers shown in the "Overview" summary (e.g., click on Members who have visited site).
- Click on Show More for "Visits", "Activity", or "Resources".
- From the "Reports" page:
- Click on the Reports link in "Site Stats"
- From the "Reports" page, click on the title of the report (e.g., click on Most accessed files).
Adding/Editing a Site Stats Report
Included in 2.7.X upgrade -More options available in Site Stats for configuring a site usage report
- Click on the Reports link.
- Click Add under "My Reports" to create a new report (or Edit below a report's title) to edit an existing report's characteristics).
- The report editing page will be presented. Configure the report to match your needs. A description of the options available follows:
- Report: This option is collapsed by default. If you wish to save or edit the report you need to click the Show link to enter a "Title" and "Description":
- Title: Enter the report's Title.
- Description: Enter the report's Description.
- What? This option allows the user to select the type of activity to report.
- Select the type of activity to include in the report; use the dropdown menu to select Visits, Events, or Resources.
- Further options become available if "Events" or "Resources" are chosen. Complete these selections to match your needs.
- Visits: Site visit activity.
- Events: Events activity can be selected by tool or by event.
- Choose Select by event or Select by tool from the dropdown menu.
- Use the Selection dropdown menu to choose the "tool" or "event" to include in the report; the "Selections" menu differs for the "tools" and "events" filters.
- Resources: Resource (file/folder) activity. Resource activity can be filtered by the type of action or the type of resource.
- In order to report specific actions, check the Selection: box Limit to action:
- Select New, Read, Revise, or Delete from the adjacent dropdown menu. [New (file uploaded/folder created); Read (file opened for reading); Revise (file details or contents changed); or Delete (file/folder deleted)].
- In order to restrict the report to specific resources (i.e., selected files/folders or to files under selected folders), check the Selection box Limit to resources:
- Check the boxes next to the names of the files/folders to include in the report (e.g., Resources, Attachment, and/or Dropbox).
- When? This option allows the user to select the time period to report.
- Select the Period: of time to include in the report; use the dropdown menu to select All, Last 7 days. Last 30 days, Last 365 days, or Custom.
- All: All of the selected activity since site creation.
- Last 7 days: Activity over the last 7 days.
- Last 30 days: Activity over the last 30 days.
- Last 365 days: Activity over the last 365 days.
- Custom: Activity from a user-specified date and time interval.
- To set a custom date range, select Custom from the Period: dropdown menu
- Use the From and To fields to set the appropriate date and time range
- Dates can be entered directly into the "From:" and "To:" boxes using the format DD/MM/YY or by clicking on the Calendar icon.
- Times can be entered directly into the "Hour" and "Minute" boxes (12-hour clock format); select AM or PM from the dropdown menu.
- Who? This option allows the user to select which site members to include in the report.
- Select the Users: to include using the dropdown menu; all site users can be selected or a subset of site users can be selected. Click on All, Role, Group, Custom, or None.
- All: All site users.
- Role: Site users with a specified role.
- Select and click Role from the Users: dropdown menu; this will open another dropdown menu containing a list of "Roles" (e.g., Co-Instructor, Departmental Support, Guest, Instructor, Lead Teaching Assistant, Student, TA-Grader, Teaching Assistant, Tech Support (role is being phased out of sites)). See Site Editor and Permissions and Roles for information about adding and authorizing site participants.
- Select and click on the appropriate "role" from the Role: drop down menu (e.g., Click on Student).
- Group: Site users from a specified group. This option does not appear in the "Users" dropdown menu if no groups have been set up for the site. See Manage Groups using Site Editor for further information about establishing groups in a CLEW site.
- Select and click Group from the Users: dropdown menu; this will open another dropdown menu containing a list of all of the groups for the CLEW site.
- Select and click the name of the group to include in the report from the list of group names in the Group: dropdown menu. Only one group can be selected.
- Custom: Site users selected from the list of active site participants. Multiple users can be selected.
- Select and click Custom from the Users: dropdown menu; this will open another dropdown menu containing a list of all active site members (includes "Name" followed by "UWin ID" in brackets).
- Select and click the name(s) of the site users to include in the report.
- Multiple names can be selected by pressing the CTRL key while clicking on names in the list (for disjoint selection) or by holding down the ALT key while clicking and holding down the mouse button and selecting a range of names from the list.
- None: Site members that do not match all of the specified report conditions (e.g., selecting Activity type: Visits + Time period: All + Users: None will report site members that never visited the site).
- How? This option allows the user to configure how the report will be presented.
- The report can summarize all of the data or the data in the report can be grouped by "User", "Event", and/or "Date".
- The number of results in the report can be limited.
- The data in the report can be presented as a "Table" and/or a "Chart".
- The type of chart can be specified [Bar, Pie, Timeseries (line), or Timeseries (bar)].
- The source of the chart data can be specified; in the case of bar charts, the source data can also be grouped by "User", "Event", or "Date".
- Define how data in the report will be grouped; if the report will present grouped data, select grouping variables from the Totals by: menu (eg., selecting User + Date will present a report grouped by user and date).
- Click the appropriate grouping variable(s); in CLEW, data can be grouped by clicking User, Event, and/or Date. (Active options are shown in black font; contact CLEW support for information about the use of other options.)
- Multiple fields can be selected by pressing the CTRL key while clicking with the mouse (for disjoint selection) or by holding down the mouse button while selecting multiple variables (for range selection).
- In order to limit the number of results included in the report, check the box next to Number of results: and enter a numeric value.
- Choose the type of presentation from the dropdown menu Presentation:; click on Table, Chart, or Table & Chart.
- If the report will be presented as a "Table", click Generate report or Save report. Click Back to return to the "Reports" page.
- If the report will include a chart, further options will be displayed (e.g., "Chart type").
- For reports that include a chart, choose the Chart type: From the dropdown menu; click on Bar, Pie, Time series (line), or Time series (bar).
- Choose the source of the chart data from the Chart series source dropdown menu; click on the field name that contains the source data for the chart.
- The fields available depend on the type of chart selected and the previous selection of grouping variables ("Totals by:" selections).
- For bar charts, choose the Chart series source data and also click on the grouping variable from the Grouped by: dropdown menu. Choose None if you do not want to group the source data.
- Click Generate report or Save report. Click Back to return to the "Reports" page.
Duplicating a Site Stats Report
Any report listed on the "Reports" page can be duplicated (i.e., private reports defined by the user listed under "My Reports" and the predefined reports listed under "Reports"):
- Private Reports: "My Reports" lists customized reports defined by the Site User and available only to the User's site.
- Predefined Reports: "Reports" lists predefined reports with configurations that are available to all CLEW sites.
- From "Site Stats", click on Reports; this page lists private and predefined reports.
- Click Duplicate below the title of the report that you want to duplicate; a copy of the report will be created in the section "My Reports" with the title "Copy of [report title]".
- Click the Title of the report to view the report
- Click Edit under the title of the duplicated report to adjust the settings for the report (e.g., "Title", "What?", "When?", "Who?", and "How?". See "Adding/Editing a report" in Site Stats for information about configuring a Site Stats report).
Deleting a Site Stats Report
- From "Site Stats", click on Reports; this page lists all private and predefined reports.
- Click Delete below a report's title.
- Click Ok on the dialogue box to confirm deletion of the report. The report will be deleted and the title removed from the "Reports" page.
Printing a Site Stats Report
After accessing an existing report from the lists on the "Reports" page, the report can be printed or exported to file. (See "View Site Stats Reports" in Site Stats for instruction on how to access reports.)
- Click Printable version at the top of the report; a print-ready version of the report will be presented in a new window.
- Click Send to printer to print the report. (Your computer's printer dialogue window will open; select printer, page range, number of copies, etc. before printing).
Exporting a Site Stats Report to a File
After accessing an existing report from the lists on the "Reports" page, the report can be printed or exported to file. (See "View Site Stats Reports" in Site Stats for instruction on how to access reports.)
- Click Export-> at the bottom of the report; three additional buttons will appear ("Export XLS", "Export CSV", and "Export PDF"). Clicking on:
- "Export XLS" will export the report as a Microsoft Excel file.
- "Export CSV" will export the report as a Comma Separated Values file.
- "Export PDF" will export the report as a Portable Document Format file.
- Click on the appropriate Export [file format] button (e.g. Export XLS).
- A "File Download" dialogue box will open; click Open to open the file with the appropriate application (e.g. Microsoft Excel for an "XLS" file).
- Click Save to save the file on your computer. A "Save as" dialogue box will open. Choose a location and file name for your exported report.
- Click Cancel to cancel the file export.
- Click Back to return to the Site Stats "Reports" page.
Edit Preferences for Site Stats
Preferences for the "Site Stats" tool can be customized by clicking on Site Stats in the left menu of the CLEW site and clicking on Preferences in the top menu. Options that can be customized include "General options", "Chart presentation options", and "Activity definition" (tools/events included as 'activity').
General Options
- General options: Only list tools available in this site. This option will automatically filter the list of tools presented on the "Reports" editing page with the tools available in the site. (See "What?" in "Adding/Editing a Site Stats Report" in Site Stats for information about configuring the type of "Events" activity to include in the report).
Chart presentation options
- Display item labels on bar charts: This option will display labels with total values on bar charts. (Bar charts do not automatically require labels to be shown, whereas pie charts always require values to be displayed).
- Charts alpha-transparency: This option allows the user to specify a transparency level for charts in "Site Stats".
Activity definition
This option allows the user to select the tools and events that will count as "Activity" on the Site Stats "Overview" page. Some considerations:
- Clicking on All tools will always use all existing CLEW tools and related events in reports of site activity. Since tools can be added/removed from a CLEW site or made available/unavailable by CLEW administrators during CLEW configuration and upgrades, this option ensures that all CLEW tools are always included in site usage reports ("Overview").
- If "All tools" is unselected, a dropdown menu listing CLEW tools will appear. Each CLEW tool can be expanded to show related events (e.g. The "Resources" tool can be expanded to show related "Resource" events ["Content new", "Content opened", "Content revise", and "Content deleted"]. Specific tools and events can be selected or unselected from this list. Only selected tools and events are counted as 'Activity' on the "Overview" page.
Editing Preferences
- Check/uncheck the box Only list tools available in this site under general options to filter the tools presented when configuring a report.
- Adjust chart presentation. Check/uncheck the box Display item labels on bar charts and select a transparency level from 10% to 100% using the dropdown menu for Charts alpha-transparency.
- Adjust the definition of 'activity' by selecting tools and tool-related events to be counted as activity. Check/Uncheck the box All tools.
- If only activity related to specific tools or events is to be assessed, then make sure that the box All tools is unselected by clicking the box to remove the checkmark.
- A dropdown menu listing all of the CLEW tools will appear below "All tools". Each CLEW tool can be expanded; click on the + box next to the tool's name to show events related to use of that tool.
- Select/unselect tools and tool-related events by clicking the boxes next to the tool's name and the appropriate related events (e.g. click the tool Assignments and the related event Assignment submission; make sure that other "Assignment"-related events are unselected if they should not be counted as 'Activity').
- Click Update at the bottom of the "Preferences" page to save these options or click Cancel if you do not want to make changes.
Related Articles
This article is based on the equivalent Sakai help article created by Indiana University found at: http://kb.iu.edu/data/arcr.html.
Additional sources of content include Brock University's Sakai / Isaak Wiki and the University of Florida Sakai / e-Learning Documentation with thanks and appreciation for the collaboration.
All respective sources used are under a free-for-reuse license and additional permission has been obtained.
Other articles about Sakai tools and how instructors can use them:
Core Tools: Announcements | Assignments | Email Instructor | Forums | Gradebook | Quizzes & Tests | Resources | Site Editor | Syllabus
More Tools: Polls | Chat | Drop Box | Home | Discussions | News | Feedback | Sections | Lessons | Site Stats | Web Content | Wiki
Related articles: How to add tools to CLEW | Using the Text Editor | Manage Groups | Permissions and Roles | Contact the CTL for help
We are constantly trying to improve the information in this Wiki.
If you notice any errors or omissions with this material, please advise the CLEW Team.