Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

The Manage Deployment reports can be used by advanced users to monitor the status of their users and troubleshoot advanced technical problems. Each report is described below:

Application Status

Purpose: This report shows the last recorded activity of each user, and the last application name and version against which they submitted a form; very useful for making sure that all users are working from the same application version.

Use the filters at the top of the page to select a specific application or to view data across all applications. The generated report will list all mobile workers and show the following information about each one:

  • Last Submission - the time elapsed since the last form submission to CommCareHQ
  • Last Sync - the time elapsed since the mobile worker last got data back from the CommCareHQ server (for example: fixture updates, case sharing cases, groups, etc.). This could be an automatic sync or done manually by pressing the 'Sync with Server' button on CommCare for the Android home screen.
  • Application name and version (Released Version) - the application name and version as indicated by the metadata from the user's last form submission.
  • CommCare Version - the CommCare version as indicated by the metadata from the user's last form submission.
  • Number of unsent forms in user's phone - Number of unsent forms that are there in the phone when last time mobile made a successful heartbeat request.

Note: Devices send heartbeat requests to update the above details. If a mobile worker has updated to a new application version but device has not made a heartbeat request then the old application version will be displayed in this report.  Same case can be with Number of unsent forms, if user has just synced but the device has not made a heartbeat request then the old value of Number of unsent forms will be displayed for the duration.  For more technical information on heartbeat requests, please see this page.

Aggregate User Status

Purpose: Gives a high-level overview of each user's most recent interaction with each application in your project space. Data provided includes:

  • Last Submission
  • Last Sync
  • Application - Name of the application this data is reported from.
  • Application Version - Version of the Application from CommCare HQ currently loaded into CommCare  
  • CommCare Version - Version of the CommCare app from the Play Store downloaded onto the user's device
  • Number of unsent forms in user's phone - Total unsent forms that are there in user's device.

Raw Forms, Errors & Duplicates

Purpose: Lets you view all of the submissions to your project space, even if those submissions weren't successfully processed, were duplicates, or were forms we hide from the submission log (like user registrations and device reports). If something funny is going on with submissions, or you want to inspect data at a more fine grained level, this is one place to look for clues.

Use the filters to choose which kinds of forms to view - duplicates, errors, normal forms, overwritten forms, etc.

If you are importing existing data by sending in fake forms, this is a good place to check that CommCareHQ is receiving them as normal forms.

Additionally, you can also look for archived forms in this report by choosing the "archived" filter.

Device Log Details

Purpose:  With this report you can easily view all the device logs, by type and by logged in username, submitted over a selected period of time. This report serves as a more general troubleshooting tool when errors and warnings are not the only logs you are looking for.

  1. Once this report loads, you will see the following information from left to right:
    1. Date of when the warning or error occurred
    2. Log type
    3. Username
    4. Device ID
    5. Error message - *This message will assist the app builder or Dimagi field team to support you in resolving the issue.

Message types:

  • Displayed permissions message (orange): This means the application permission settings have been re-set on the phone.



  • No labels