Page Comparison

...

The stats tool uses data from both the internal database and the external database. The external database is referenced via an oracle database link. The link used is called sakai_ext.

Functional requirements about the statistics below:

1. The hourly statistics should count the total sessions logged in for each hour. E.g., if user 1 logs in a 7am, this is a count of 1. If user 1 is still logged in at 8am (didn't log out yet since logging in a 7am), user 1 should be counted again for the 8am count. The idea here is concurrency -- how many people are logged in at the same time for each hour.

2. For the General Statistics display, move "Unique Users" label and statistics up to display right after "SmartSite Logins in the Past 24 Hours."

4. For the Breakdown of Users, Delete "Total Unique Users" since it already occurs in the General Statistics category of statistics.

5. For this documentation, please add the description for the Mothra Codes so we're sure what they mean. E.g., "mp.User_Type in ('U', 'R', 'P', 'C') . . ." Note that Instructor and staff include the code 'M' right? Then too staff and students both include 'R'. Without the descriptions spelled out here, it's hard to know at a glance what this means.

Stat Queries

General Statistics

Smartsite Logins to Date
- Query:
  No Format
  SELECT COUNT(*) FROM SAKAI_SESSION where SESSION_START!=SESSION_END
- Notes: This tracks sessions/users that are complete. Ie, a logout or timeout must have occurred for it to show up here.
Smartsite Logins in the Past 24 Hours
- Query:
  No Format
  SELECT COUNT(*) FROM SAKAI_SESSION where SESSION_START!=SESSION_END AND SESSION_START > (SYSDATE - 1)
- Notes: Same as the above with the caveat that the session must have started in the past 24 hours, and it does not matter when the session ended.

Course Sites

Query:

No Format
SELECT COUNT(DISTINCT TITLE) FROM SAKAI_SITE WHERE TYPE='course' AND SITE_ID NOT IN (SELECT SITE_ID FROM SAKAI_SITE_PROPERTY WHERE NAME IN ('UCDADMIN:Site', 'UCDADMIN:Template'))

Notes: This query takes into account and removes the sites that are training sites.

Project Sites

Query:

No Format
SELECT COUNT(*) from SAKAI_SITE WHERE TYPE='project' AND PUBLISHED=1

Notes: none

Training Sites

Query:

No Format
SELECT COUNT(*) FROM SAKAI_SITE WHERE (TYPE='training-course' OR TYPE='training-project') OR SITE_ID IN (SELECT SITE_ID FROM SAKAI_SITE_PROPERTY WHERE NAME='UCDADMIN:Site')

Notes: None

Unique Users
- Query:
  No Format
  SELECT COUNT(DISTINCT g.USER_ID) FROM SAKAI_REALM_RL_GR g WHERE NOT exists (SELECT 1 FROM SAKAI_USER where user_id = g.user_id)
- Notes: This query returns provided users that have a meaningful(ie, not automatic) role in a site. In some cases this is only the user's My Workspace site.

...

Instructor Users

Query:

No Format


select count(UNIQUE mp.kerberos_name) FROM SAKAI_REALM_RL_GR gr, SAKAI_USER_ID_MAP um, MOTHRA_PERSON@SAKAI_EXT mp 
WHERE NOT exists (SELECT 1 FROM SAKAI_USER where user_id = gr.user_id) and 
gr.USER_ID = um.USER_ID and um.EID = mp.MOTHRAID and mp.USER_TYPE IN ('F','M','P','C')

Notes: This query pulls users out of the realm table and joins them to specific USER_TYPE(s) in the mothra person table. The unique clause in the count is required as a single user may be in multiple site realms.

Staff Users

Query:

No Format


SELECT count(UNIQUE mp.kerberos_name) FROM SAKAI_REALM_RL_GR gr, SAKAI_USER_ID_MAP um, MOTHRA_PERSON@SAKAI_EXT mp

WHERE NOT exists (SELECT 1 FROM SAKAI_USER where user_id = gr.user_id) and

gr.USER_ID = um.USER_ID and um.EID = mp.MOTHRAID and mp.USER_TYPE IN ('S','M','R','C')

Notes: This query pulls users out of the realm table and joins them to specific USER_TYPE(s) relating to staff(Staff, Staff/Instructor, Staff/Student, and Staff/Student/Instructor) in the mothra person table. The unique clause in the count is required as a single user may be in multiple site realms.

Graduate Student Users

Query:

No Format


SELECT UNIQUE 
    mp.kerberos_name,
     case when bl.level_code = 'UG' then 'Undergrad' else 'Graduate' end AS STUDENT_TYPE
FROM
     mothra_person@sakai_ext mp, banner_level@sakai_ext bl,
     SAKAI_REALM_RL_GR gr, SAKAI_USER_ID_MAP um

WHERE
    NOT exists (SELECT 1 FROM SAKAI_USER where user_id = gr.user_id) and
     mp.banner_pidm = bl.pidm AND
     mp.mothraid = um.EID AND
     mp.USER_TYPE IN ('U','R','P','C') AND
     um.USER_ID = gr.USER_ID and
     bl.term_code=(select max(term_code) from BANNER_LEVEL@SAKAI_EXT where pidm=mp.banner_pidm)

Notes: This query requires post processing. It generates a list of kerberos names and a code(UG stands for undergraduates, all other codes are grad students) The post processing totals each type and assigns it to its particular bucket. It also joins in the USER_TYPE for students(and as you can see there is potential for overlap.)
Issue: Previous to this query, we had a scenario where a student was in the banner level code as both a undergrad and a grad. The above query has been corrected for this issue. One last thing remains, is to verify that the assumption that the double counting is truly an issue.

Undergraduate Student Users
- Notes: See Graduate Student Users above
Total Unique Users
- Notes: See Unique Users query in General Statistics section

...

Each individual time will use the below query. Please see Requirements for daily hourly usage statistic for info on the user interface.
- Query:
  No Format
  SELECT count(*) FROM SAKAI_SESSION WHERE SESSION_START!= SESSION_END AND SESSION_START > (SYSDATE - 1) AND TO_CHAR( NEW_TIME(SESSION_START,'GMT', 'PDT'), 'HH24') = ?
- Notes: This is just a variation of Logins in the Past 24 Hours from General Statistics. All it does in additional is extract the hour in 24 hour clock mode(after converting due to the time being in GMT and not PDT.) The code loops through this for each hour of the day and presents the table as shown.

...

Versions Compared

Old Version 19

New Version 20

Key

Stat Queries