Overview

Usage Statistics is a module for collecting high-level statistics about usage of patient records by users in OpenMRS. It allows an administrator to view usage statistics based on location, user roles, date ranges, days of the week, and hours of the day. It also shows how users are finding patient records - searching by name, by ID etc.

Usage

When the module is installed it automatically begins recording views, updates, creations and voidings of patient records. You can view this data and configure the module by following the Usage Statistics link under the Maintenance heading on the OpenMRS Administration page.

Required privileges

Users who are not system developers will require the following explicit privileges:

The aggregator

Some of the pages (Time and day, Searches and Raw usage data) display information from the raw usage data, but the rest of the pages use aggregated data which is updated hourly by a scheduled task. This aggregation task can however, be run manually from the Configuration page at any time.

Configuration

The following options can be changed from the configuration page of the module:

Download

• https://addons.openmrs.org/#/show/org.openmrs.module.usagestatistics

Summarized release notes

1.2.2

• Changes
  • OpenMRS 1.6.0+ is now a requirement
• Fixes
  • Missing UUID for scheduled task in OpenMRS 1.6
  • Spring for tag library compatibility issue in OpenMRS 1.7

    1.2

• New features
  • Added displaying of encounter types entered based on most commonly occurring

    1.1.1

• New features
  • Added complete French translation
• Fixes
  • Fixed forms submitted using FormEntry module being attributed to the admin user
  • Fixed incorrect login redirects on some pages

    1.1

• New features
  • Added recording of encounter creation within a usage, and aggregation of encounter data
  • Added displaying of forms entered based on most commonly used forms
  • Added patient select widget to usages page
• Fixes
  • Changed usages tab on patient dashboard to be consistent with usages page
  • Fixed filtering by roles on users page not working
  • Fixed user select widget on usages page not working on some installations
• Known issues
  • Patient voids not always recorded

    1.0.1

• New features
  • Added update URL for automatic updating of module
  • Added partial French translation
• Fixes
  • Fixed roles filter being ignored on users page

    1.0

• Known issues
  • Conflicts with version 1.0 of ResearchEncounters module, so this must be upgraded to version 2.0