Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes...
-
Upload
sherilyn-kennedy -
Category
Documents
-
view
215 -
download
0
Transcript of Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes...
![Page 1: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/1.jpg)
Dr. David Roldán MartínezUniversidad Politécnica de Valencia, Spain
&Nuno FernandesUniversidade Fernando Pessoa, Portugal
Site Stats, the power of event tracking at a single click in Sakai
![Page 2: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/2.jpg)
The begining of the project
Site usage statistics Audience:
Sakai administrators Site maintainers (instructors,…)
Available for Sakai 2.2+ Based on Sakai Event service
![Page 3: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/3.jpg)
The begining of the project
Active development team Current status available at
http://jira.sakaiproject.org/jira/browse/STAT/fixforversion/11273
![Page 4: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/4.jpg)
Site Stats 1.0 Features
Display summary information about site visits and tool activity Display visits and tool activity charts Generate reports based on site visits, tool activity and resources
actions
![Page 5: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/5.jpg)
Site Stats 2.0 main changes
Switched to Apache Wicket as rendering engine (instead of JSF) Improved service API Improved stability Added support for more Sakai tools Report definitions per site and predefined by admin Grouping results capabilities Redesigned Report editing page to accommodate new report
options Redesigned Overview page with a compact view to present
most requested information from Instructors directly from the first page.
![Page 6: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/6.jpg)
Site maintainer view
Information organized in 2 tabs: Overview
(summary information for site visits and activity) Reports
(site visit reports, tool and resource activity)
![Page 7: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/7.jpg)
Site maintainer view: Overview tab
Statistics (totals and averages) about site visits and activity: visits activity (sum of selected events) resources
![Page 8: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/8.jpg)
Site maintainer view: Overview tab
Snapshot of site visits
![Page 9: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/9.jpg)
Site maintainer view: Overview tab
Snapshot of site activity:
![Page 10: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/10.jpg)
Site maintainer view: Overview tab
Snapshot of site resources:
![Page 11: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/11.jpg)
Site maintainer view: Reports tab
Generate reports based on: site visits tool events Resources
Narrow search by: specific tools, events or resources pre-defined or custom time periods all/specific users, roles, groups or non-matching users
Excel or CSV file export
![Page 12: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/12.jpg)
![Page 13: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/13.jpg)
![Page 14: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/14.jpg)
![Page 15: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/15.jpg)
![Page 16: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/16.jpg)
Site maintainer view: Preferences tab
Select tools or events to be counted as activity on overview screen
![Page 17: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/17.jpg)
Site Stats administration
Two main phases Installation (off-line)
Site Stats deployment Tomcat configuration Event aggregation configuration Event storage configuration Tool events definition
Site configuration (on-line) Preferences tab
![Page 18: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/18.jpg)
Site Stats administration
Site Stats deployment Download source code:
svn co https://source.sakaiproject.org/contrib//ufp/sitestats/tags/a_sitestats_tag/ sitestats
Edit pom.xml file and change the version tag to reflect sakai version Run Maven to compile SiteStats:
For sakai <= 2.4.x, use Maven 1:• maven sakai
For sakai >= 2.5 or trunk, use Maven 2:• mvn clean install sakai:deploy
Make sure there are no multiple versions of sitestats jars in {tomcat_folder/shared/lib} (named sakai-sitestats-*.jar)
![Page 19: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/19.jpg)
Site Stats administration
Tomcat configuration Make sure -Djava.awt.headless=true is added to JAVA_OPTS
environment variable.
![Page 20: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/20.jpg)
Site Stats administration
Configuration Event aggregation configuration options Event storage configuration Tool/event support Performance considerations
![Page 21: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/21.jpg)
Site Stats administration
Event aggregation configuration http://bugs.sakaiproject.org/confluence/display/STAT/
Configuration+Options#ConfigurationOptions-2.2.Eventaggregationconfigurationoptions
On-line: Real-time, performance impact in heavy load conditions
Off-line through a quartz job Can be scheduled to be made on low load periods
![Page 22: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/22.jpg)
Site Stats administration
Event storage configuration http://bugs.sakaiproject.org/confluence/display/STAT/
Configuration+Options Same database
Easier management Different database
More complex management
![Page 23: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/23.jpg)
Site Stats administration
Tool event definitions loaded from: default file (xml) custom file in sakai.home (xml)
Tool event definitions matched with: available tools in the Sakai installation available tools in site (by default)
![Page 24: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/24.jpg)
Site Stats administration
<?xml version="1.0" encoding="UTF-8" ?><toolEventsDef> <!-- announcements --> <tool toolId="sakai.announcements" selected="true"> <event eventId="annc.new" selected="true"/> <event eventId="annc.revise.own" selected="true"/> <event eventId="annc.revise.any" selected="true"/> <event eventId="annc.delete.own" selected="true"/> <event eventId="annc.delete.any" selected="true"/> <eventParserTip for="contextId" separator="/" index="3"/> </tool><!-- (...) --></toolEventsDef>
toolId – Sakai tool idselected - Selected by default?
eventId – Logged event idselected - Selected by default?
For – ContextIdseparator – String separator (i.e. '/')index – index position
![Page 25: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/25.jpg)
Site Stats administration
Enabling tracking of site visits In Sakai 2.4.x / 2.5.x:
The list of users present in site must be enabled (Sakai Presence service). If SAK-8499 is not applied into your sakai installation, the following
configuration key is required in sakai.properties:• display.users.present = true
In Sakai trunk / 2.6+: The list of users present in site is not a requirement anymore The following configuration key is specified in sakai.properties:
• presence.events.log = true
Common:• [email protected]
![Page 26: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/26.jpg)
Site Stats administration
Other performance considerations Event filtering
Events can be collected only for those sites using the property:
collectEventsForSiteWithToolOnly@org.sakaiproject.sitestats.api.StatsUpdateManager = true (default)
Administrator generated events can also be discarded: collectAdminEvents@org.sakaiproject.sitestats.api.StatsUpdateManager =
false (default) Type of events to be aggregated can also be limited, if there is interest.
The default configuration file is toolEventsDef.xml.
![Page 27: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/27.jpg)
Site Stats administrator
Check for database table indexes There is a bug in Hibernate that prevents the correct creation of
table indexes when creating the SiteStats tables with auto.ddl= true.
Check that all the indexes have been created and match the ones on these files:
MySQL ddl Oracle ddl
![Page 28: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/28.jpg)
Site Stats developer
Not all Sakai tools provide events to Site Stats. http://bugs.sakaiproject.org/confluence/display/UDAT/
Log+Events+Descriptions+-+Sakai+2.5.x How it works
SiteStats consults the EntityProviderManager service to find which tools implement the Statisticable capability from EntityBroker.
Staticable interface provides the following information: Associated sakai tool id List of events to be supported in SiteStats Localized events description
![Page 29: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/29.jpg)
Site Stats developer
Adding the Statisticable capability to your class, will require you to implement 3 new methods:
public String getAssociatedToolId() public String[] getEventKeys() public Map<String, String> getEventNames(Locale locale)
Log events using the EventTrackingService
![Page 30: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/30.jpg)
Conclusions
Site Stats provide a simple way to get basic information about how your Sakai sites are used.
Multiple configurations are available. We are open to suggestions and contributions
![Page 31: Dr. David Roldán Martínez Universidad Politécnica de Valencia, Spain & Nuno Fernandes Universidade Fernando Pessoa, Portugal Site Stats, the power of event.](https://reader036.fdocuments.in/reader036/viewer/2022062500/5697bfe01a28abf838cb35b3/html5/thumbnails/31.jpg)
Any question?
Dr. David Roldán Martí[email protected] Politécnica de Valencia
Nuno [email protected] Fernando Pessoa