10.7. Reports

Administration → 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:

• Elasticsearch set up as search plugin

• Logging and reporting of events

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

10.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

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.

10.7.2. Report configuration

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

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:

   • Inhalt

   • Gruppen

   • Institutionen

   • 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.

10.7.3. 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

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.

10.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:

• KENNUNG

• 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

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.

10.7.5. Institution reports

There are three institution reports available:

• Institution comparison

• Logins

• Übersicht

10.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

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.

10.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

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.

10.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

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.

   • Nutzer: Anzahl

     • registrierte Nutzer, z.B. jeder mit Account

     • aktive Nutzer,; Nutzer, die sich zumindest einmal eingeloggt haben und etwas getan haben

   • 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.

10.7.6. People reports

There are numerous reports in this section:

• Collaboration

• Sessions

• Page activity

• People overview

• Portfolio access

• User activity

• User details

10.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

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.

10.7.6.2. Legal consent report

When the site requires people to accept the terms and conditions and privacy statement, this report tracks when people consented to these legal statements.

The report shows:

• Vorname

• Nachname

• Anzeigename

• E-Mail Adresse

• Benutzername

• Site privacy statement

• Site privacy consent reviewed

• Site terms and conditions

• Site terms and conditions consent reviewed

• Institution privacy statement

• Institution privacy consent reviewed

• Institution terms and conditions

• Institution terms and conditions consent reviewed

• Institution

Legal consent 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. Display name: If the user chose to set a display name, it is displayed here.

9. Email: Email address of the user.

10. Username: Username of the user.

11. Site privacy statement: Version number and link to the privacy statement that the user has a greed to.

12. Site privacy consent reviewed: Date when the user agreed to the site privacy statement.

13. Site terms and conditions: Version number and link to the terms and conditions that the user has a greed to.

14. Institution privacy statement: Version number and link to the institution privacy statement that the user has a greed to.

15. Institution terms and conditions: Version number and link to the institution terms and conditions that the user has agreed to.

16. Institution: Name of the institution in which the user is a member.

17. Total number of results.

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

Note

You can also display the dates when the site terms and conditions and the institution legal statements were consented to.

When you click on the version number of any of the legal statements, you are taken to a report for an individual’s consent history.

Legal consent report for an individual

1. Run the legal consent report and click a version number of any of the agreements that a the person consented to.

2. Title of the report.

3. Name of the person whose consent history you are viewing.

4. Click „Privacy statement“ to see all the privacy statements to which the user has agreed to at some point.

5. Click „Terms and conditions“ to see all the terms and conditions to which the user has agreed to at some point.

6. Institution: List of the institutions that have an agreement impacting the user. „Site“ always means the site agreements that everyone needs to review.

7. Date of consent / rejection: The date when consent was given or rejected.

8. Consented: „Yes“ or „No“ depending on the decision of the user.

9. Version: Version number of the agreement to which the user needed to respond.

10. Latest: „Yes“ or „No“ indicating which is the current applicable agreement.

11. Click the View button to see the text of the agreement that you want to review.

12. The agreement text is displayed.

10.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 → 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

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.

10.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

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.

10.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

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.

10.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 → 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

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

Obwohl alle Ansichten, Sammlungen und Gruppen verlinkt sind, haben Sie keinen direkten Zugriff wenn Sie nicht zugriffsberechtigt oder ein Mitglied der Gruppe selbst sind.

10.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)

• Letzter 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 → 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

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.

10.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:

• Benutzername

• E-Mail Adresse

• Vorname

• Nachname

• ID number

• Anzeigename

• Remote username

• Letzter 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 → 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

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.