11.7. Reports

Administration menu → Reports

If you want to use advanced analytics, i.e. the groups, collaboration, page activity, and user activity reports, you need to have the following:

Reports can be run by site and institution administrators. Staff may also have access to certain reports.

11.7.1. Structure of a report

The structure of all reports is similar, and they can all be configured to show less or more information.

Structure of the reports

Structure of the reports

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Timeframe over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Table header shows the individual report items.

  6. Data in the report.

  7. Paginator to jump to additional results.

  8. Total number of results.

  9. Results per page: Change how many results you want to display per page.

  10. Click the Download icon to download the report as CSV file.

Note

Click any column heading and you can sort the table according to that column in ascending or descending order.

11.7.2. Report configuration

All reports can be configured via the Configure button on the Reports page.

Configuration screen for the reports

Configuration screen for the reports

  1. Institution: Select the institution for which you want to run the report.

    Note

    Site administrators see all institutions and the option “All institutions”, which is the site level. Institution administrators only see reports for the institutions in which they are an administrator.

  2. Report type: Select the report that you want to display. The categories are:

    • Content

    • Groups

    • Institutions

    • People

  3. This report includes: This section details what information the report includes.

  4. The date of the first event logged in the database that can be used for the report. If the report is run for prior dates, the data will be incomplete.

    Note

    Mahara only detects the first date, but not if event logging had been turned off for a period of time afterwards.

  5. From: Select the start date for your report by clicking into the field and selecting it via the calendar.

  6. To: Select the end date for your report by clicking into the field and selecting it via the calendar.

    Note

    You can only view reports for data that is still in the database on the site. If data was deleted or not yet collected for certain reports to show data, no data can be displayed.

    If you want to report over today in “To”, you need to choose tomorrow’s date as the date assumes the report is up to midnight of the previous day right before the start of today.

  7. Columns: Click the icon to show the columns that you can select or deselect to tailor the report for this session. The icon is displayed when the panel is open.

  8. Tick the checkbox next to an item that you want to display as additional column in your report.

  9. You can’t deselect certain columns as they display the minimum information for the selected report.

  10. Click the Submit button to display results for your report, or click Cancel to abort any changes to your report.

  11. You can also click the Close icon in the top left-hand corner of the modal window to cancel your action without saving any changes.

11.7.3. Content

11.7.3.1. Content report

The content report displays information about modifications to artefacts and blocks. The available columns are:

  • Title

  • Number of modifications

  • Total

  • Number of unique users who made the modifications

  • Number of unique users over the total

Content overview report

Content overview report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Name: Name of the artefact or blocktype.

    Note

    When you report over “All institutions”, you do not see blocktypes displayed. Currently, these are only available when you report over an institution.

  6. Modified: Number of creations or modifications of this content item during the selected time frame.

  7. Total: Number of total items of this content item during the selected time frame.

  8. Paginator to jump to additional results.

  9. Total number of results.

  10. Results per page: Change how many results you want to display per page.

  11. Click the Download icon to download the report as CSV file.

11.7.3.2. Objectionable content report

The objectionable content report shows all portfolios that currently have objectionable material reported. The available columns are:

  • Page title

  • Artefact title

  • Objectionable content reporter

  • Reporter’s name

  • Report description

  • Report date

  • Reviewer’s name

  • Review description

  • Review date

  • Report status

Objectionable content report

Objectionable content report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Page: The page that contains the objectionable material.

  6. Artefact: Name of the artefact if it is the objectionable material.

  7. Reporter: Person who reported the material.

  8. Report: Original complaint.

  9. Date: Date that the material was reported.

  10. Reviewer: The administrator who reviewed the material.

  11. Review: The message that the administrator sent to the portfolio author if any if the portfolio is still objectionable.

  12. Date: The date that the reviewer looked at the portfolio.

  13. Status: Next action item.

  14. Total number of results.

  15. Click the Download icon to download the report as CSV file.

11.7.4. Groups report

Note

This report is only available on the site level and can’t be selected by institution administrators.

The group report provides information about the groups that are on the site. For each group you can see:

  • ID

  • Name

  • Number of members

  • Number of pages

  • Number of shared pages

  • Number of comments on group pages and artefacts

  • Number of comments on pages and artefacts shared with the group

  • Number of forums

  • Number of forum posts

Note

This report requires event logging to be turned on for the entire site. Since events cannot be put into the database in retrospect, correct data is only collected from the time the full event logging has been turned on.

Groups overview report

Groups overview report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Group: Title of the group.

  6. Members: Number of members in the group.

  7. Pages: Number of pages in the group.

  8. Group page comments: Number of comments on group pages and artefacts.

  9. Shared pages: Number of pages that have been shared with the group.

  10. Shared page comments: Number of comments on pages and artefacts shared with the group.

    Note

    This only takes into account comments that were made after the page was shared with the group as that event could not have been logged prior to that.

  11. Forums: Number of forums in the group.

  12. Posts: Number of forum posts in the group.

  13. Paginator to jump to additional results.

  14. Total number of results.

  15. Results per page: Change how many results you want to display per page.

  16. Click the Download icon to download the report as CSV file.

Note

“N/A” (not available) in any of the columns indicates that there is no data available yet. This is an indicator that the information was not yet recorded via the event logging.

11.7.5. Institution

There are three institution reports available:

  • Institution comparison

  • Logins

  • Overview

11.7.5.1. Institution comparison report

The institution comparison report provides an overview of all institutions on the site:

  • Institution

  • Number of members

  • Number of pages created by members and the institution

  • Number of blocks

  • Number of artefacts

  • Number of forum posts by institution members

Note

This report is only available on the site level when “All institutions” is chosen in the institution selector during the report configuration.

Institution comparison report

Institution comparison report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Institution: Title of the institution.

  6. Members: Number of members in the institution.

  7. Pages: Number of pages in the institution that were created by institution members and on the institution level itself.

  8. Blocks: Number of blocks used in pages in the institution.

  9. Artefacts: Number of artefacts in the institution.

  10. Posts: Number of forum posts by institution members.

  11. Paginator to jump to additional results.

  12. Total number of results.

  13. Results per page: Change how many results you want to display per page.

  14. Click the Download icon to download the report as CSV file.

Note

This report is currently only updated once a week at the end of the week.

11.7.5.2. Logins report

The logins report provides details for:

  • Institution

  • Number of logins no matter the user

  • Number of active users

Note

This report is only available on the site level when “All institutions” is chosen in the institution selector during the report configuration.

Logins report

Logins report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Institution: Title of the institution.

  6. Logins: Total number of logins to the site, no matter which institution member it was.

  7. Active users: Total number of distinct institution members who logged into the site during the given time frame.

  8. Paginator to jump to additional results.

  9. Total number of results.

  10. Results per page: Change how many results you want to display per page.

  11. Click the Download icon to download the report as CSV file.

11.7.5.3. Overview report

The institution report contains statistical information about each institution:

  • Creation date

  • Number of users

  • Number of pages

  • Disk space used

  • For “All institutions” only:

    • Number of groups

    • Database size

    • Mahara version

    • Information on the running of cron

Institution overview report

Institution overview report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Click the Configure button to change the report settings.

  4. Overview: Some information about the site or institution:

    • Site installed / Institution created: Installation date of your site. If you view this report for an institution, the institution creation date is shown, i.e. the first time a member was added to the institution.

    • Users: Number of

      • registered users, i.e. everybody who has an account

      • active users, i.e. users that have at least logged in once and have done something

    • Groups: Number of groups and average group membership of a user. This is only available for “All institutions”.

    • Pages: Number of pages and average pages per user with pages.

    • Database size: Size of your database on the server. This is only available for “All institutions”.

    • Disk usage: The amount of disk space your Mahara installation or institution uses.

    • Mahara version: Version number of Mahara and the latest stable release. This is only available for “All institutions”.

    • Cron: Information on whether cron is running or not. If it says “Cron is not running”, please check it. It may be running partially. This is only available for “All institutions”.

  5. Additional information and graphs are available for:

    • Average user in terms of friends, pages, group membership, and use of space.

    • Users by institution. This is only available for “All institutions”.

    • Pages overview: Most frequently used blocks and types of pages.

    • Groups overview: Number of groups by group type and access type. This is only available for “All institutions”.

    • Growth trend: Graphical representation of all users and pages over time.

11.7.6. People

There are numerous reports in this section:

  • Collaboration

  • Masquerading sessions

  • Page activity

  • People overview

  • Portfolio access

  • User activity

  • User details

11.7.6.1. Collaboration report

The collaboration report shows the level of engagement and collaboration that is happening on Mahara in regard to personal portfolio pages and collections:

  • Number of comments on pages and artefacts

  • Number of annotation feedback

  • Number of portfolios (pages or collections) shared with individual users

  • Number of portfolios shared with groups

  • Number of portfolios shared with an institution

  • Number of portfolios shared with all registered users

  • Number of portfolios shared publicly

  • Number of portfolios shared via secret URLs

  • Number of portfolios shared with friends

Note

This report requires event logging to be turned on for the entire site. Since events cannot be put into the database in retrospect, correct data is only collected from the time the full event logging has been turned on.

If you do not turn on event logging and have Elasticsearch running, you can’t see this report.

Collaboration report

Collaboration report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Date: Each row represents a week (w.c. - week commencing).

  6. Comments: Number of comments made on pages and artefacts.

  7. Users: Number of portfolios (pages and collections) shared with individual users.

  8. Groups: Number of portfolios (pages and collections) shared with groups.

  9. Institutions: Number of portfolios (pages and collections) shared with an institution.

  10. Registered: Number of portfolios (pages and collections) shared with registered users.

  11. Public: Number of portfolios (pages and collections) shared with the public.

  12. Secret URLs: Number of portfolios (pages and collections) shared via secret URLs.

  13. Friends: Number of portfolios (pages and collections) shared with friends.

  14. Paginator to jump to additional results.

  15. Total number of results.

  16. Results per page: Change how many results you want to display per page.

  17. Click the Download icon to download the report as CSV file.

11.7.6.3. Masquerading sessions report

When the site administrator turned on the logging of masquerading sessions, they are reported in this report. If full event logging is turned on, masquerading sessions are recorded as well.

The report shows:

  • Name and username

  • Reason for the masquerading session

  • Administrator who masqueraded

  • Start time of the masquerading session

You can display masquerading sessions for all people on the site or your chosen institution. Alternatively, you can select people on Administration menu → Users → User search and report only over them:

  1. On the User search page, select the people for whom you wish to see the masquerading sesions report and click the Get reports for selected users button. You are taken into the Reports section.

  2. Click the Configure report button.

  3. Report type: Select “Masquerading sessions”.

  4. From: Choose your start date.

  5. To: Choose your end date or leave it at today’s date.

  6. Columns: Select the columns that you wish to display in the report.

  7. Click the Submit button.

The report shows the information for the selected users.

Masquerading sessions report

Masquerading sessions report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Number of selected users for the report if it is not over an entire institution. Click the Remove filter button to report over all people in the chosen institution.

  5. Click the Configure button to change the report settings.

  6. User: Person who has been masqueraded as.

  7. Reason: Reason for the masquerading. This is only displayed if the administrator was required to provide one.

  8. Masquerading administrator: The administrator who initiated the masquerading session.

  9. Start of masquerading: Date and time when the administrator started to masquerade as the user.

  10. Paginator to jump to additional results.

  11. Total number of results.

  12. Results per page: Change how many results you want to display per page.

  13. Click the Download icon to download the report as CSV file.

11.7.6.4. Page activity report

The page activity report gathers data about a page itself and its content:

  • Page title

  • Title of the collection to which the page belongs (if any)

  • Page owner

  • Creation date

  • Last modification date

  • Date, when the page was last viewed

  • Number of blocks included in the page

  • Number of visits to the page

  • Number of comments on the page

Note

This report requires event logging to be turned on for the entire site. Since events cannot be put into the database in retrospect, correct data is only collected from the time the full event logging has been turned on.

If you do not turn on event logging and have Elasticsearch running, you can’t see this report.

Page activity report

Page activity report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Page: Title of the page.

  6. Collection: Title of the collection if the page is part of one.

  7. Owner: Name of the person who authored the page.

  8. Created: Date and time of the creation of the page.

  9. Last modified: Date and time when the page was last edited.

  10. Last visited: Date and time when the page was last viewed.

  11. Blocks: Number of blocks included in the page.

  12. Visits: Number of visits to the page.

  13. Comments: Number of comments on the page.

  14. Paginator to jump to additional results.

  15. Total number of results.

  16. Results per page: Change how many results you want to display per page.

  17. Click the Download icon to download the report as CSV file.

11.7.6.5. People overview report

The people overview report gives an overview of activty of people on the site for a given day:

  • Date

  • Number of people who logged in

  • Number of accounts created

  • Total number of people in the selected institution

People overview report

People overview report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Click the Configure button to change the report settings.

  5. Date: Date of the login.

  6. Logged in: Number of people who logged in on that day.

  7. Created: Number of user accounts created on that day.

  8. Total: Total number of people in the selected institution on that day.

  9. Paginator to jump to additional results.

  10. Total number of results.

  11. Results per page: Change how many results you want to display per page.

  12. Click the Download icon to download the report as CSV file.

11.7.6.6. Portfolio access report

You can view all the portfolios that have been created by people on the site or in a particular institution and with whom they have been shared. This facilitates troubleshooting when people cannot view pages of others and the administrator would otherwise have to log in to the user account to check page permissions.

The report displays:

  • Portfolio owner

  • Title of the portfolio

  • Number of pages in the portfolio

  • Access list, i.e. who has permission to view the portfolio

You can display the portfolio access for all people on the site or your chosen institution. Alternatively, you can select people on Administration menu → Users → User search and report only over them:

  1. On the User search page, select the people for whom you wish to see the portfolio access report and click the Get reports for selected users button. You are taken into the Reports section.

  2. Click the Configure report button.

  3. Report type: Select “Portfolio access”.

  4. From: Choose your start date.

  5. To: Choose your end date or leave it at today’s date.

  6. Click the Submit button.

The report shows the information for the selected users.

Portfolio access report

Portfolio access report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

    Note

    The time frame here refers to pages or collections created within the start and end dates.

  4. Number of selected users for the report if it is not over an entire institution. Click the Remove filter button to report over all people in the chosen institution.

  5. Click the Configure button to change the report settings.

  6. Owner: Person who is the owner of the portfolio.

  7. Page / collection: Title of the portfolio.

  8. Pages: Number of pages within a collection.

  9. Access list: Listed are who has access to the portfolio.

  10. If a portfolio has been shared with only a certain role within a group, that is stated.

  11. Number of secret URLs created for the portfolio.

  12. Paginator to jump to additional results.

  13. Total number of results.

  14. Results per page: Change how many results you want to display per page.

  15. Click the Download icon to download the report as CSV file.

Note

Though all pages, collections and groups are linked, you may not have direct access to them if you are not on the access list or a member of the group yourself.

11.7.6.7. User activity report

This report displays information about a user and their level of activity on the site during the selected time frame:

  • User information

  • Number of artefacts created or modified

  • Number of pages created

  • Number of collections created

  • Number of groups created

  • Number of logins

  • Number of actions (create and modify an artefact, forum post, personal pages and collection, group pages and collections, comments, page views)

  • Last login

  • Last activity

Note

This report requires event logging to be turned on for the entire site. Since events cannot be put into the database in retrospect, correct data is only collected from the time the full event logging has been turned on.

You can display the user activity for all people on the site or your chosen institution. Alternatively, you can select people on Administration menu → Users → User search and report only over them:

  1. On the User search page, select the people for whom you wish to see the user activity report and click the Get reports for selected users button. You are taken into the Reports section.

  2. Click the Configure report button.

  3. Report type: Select “User activity”.

  4. From: Choose your start date.

  5. To: Choose your end date or leave it at today’s date.

  6. Click the Submit button.

The report shows the information for the selected users.

User activity report

User activity report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

    Note

    Activity is shown for people who were logged in during this time frame.

  4. Number of selected users for the report if it is not over an entire institution. Click the Remove filter button to report over all people in the chosen institution.

  5. Click the Configure button to change the report settings.

  6. First name: First name of the user.

  7. Last name: Last name of the user.

  8. Display name: If the user chose to set a display name, it is displayed here.

  9. Username: Username of the user.

  10. Artefacts: Number of artefacts created or updated.

  11. Pages: Number of pages created during the time frame.

  12. Collections: Number of collections created during the time frame.

  13. Groups: Number of groups created during the time frame.

  14. Logins: Number of total logins on the site.

  15. Actions: Number of actions the user has taken on the site, i.e. created and modified an artefact, wrote a forum post, created and modified personal pages and collection, created and modified group pages and collections, wrote comments, viwed pages.

  16. Last login: Date and time when the user was in their account last.

  17. Last activity: Last activity in the user’s account.

    Note

    Masquerading sessions are listed as activity. They do not count as a last login though.

  18. Total number of results.

  19. Click the Download icon to download the report as CSV file.

11.7.6.8. User details report

The user details report provides basic account information about a person and is well suited for exports if you want to update accounts via a CSV file:

  • Username

  • Email address

  • First name

  • Last name

  • ID number

  • Display name

  • Remote username

  • new in Mahara 19.04 Quota used

  • Last login

  • Number of probation points

You can display the user details for all people on the site or your chosen institution. Alternatively, you can select people on Administration menu → Users → User search and report only over them:

  1. On the User search page, select the people for whom you wish to see account details and click the Get reports for selected users button. You are taken into the Reports section.

  2. Click the Configure report button.

  3. Report type: Select “User details”.

  4. From: Choose your start date.

  5. To: Choose your end date or leave it at today’s date.

  6. Columns: Select additional columns to display more information if you wish.

  7. Click the Submit button.

The report shows the information for the selected users.

User details report

User details report

  1. Title of the report.

  2. Institution that was selected for the report. If it says “All institutions”, then the report is over the entire site.

  3. Time frame over which is being reported.

  4. Number of selected users for the report if it is not over an entire institution. Click the Remove filter button to report over all people in the chosen institution.

  5. Click the Configure button to change the report settings.

  6. First name: First name of the user.

  7. Last name: Last name of the user.

  8. Email: Email address of the user.

  9. ID number: ID number of the user if one was given.

  10. Display name: If the user chose to set a display name, it is displayed here.

  11. Username: Username of the user.

  12. Remote username: If the user has an authentication method that requires a remote username, it is listed here.

  13. Last login: Date and time when the user was in their account last.

  14. Total number of results.

  15. Click the Download icon to download the report as CSV file.

Note

If the site has spam probation points enabled, these can be displayed in the table as well.