Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Multiexcerpt include macro
macro_uuid785c6088-0e28-4857-9b71-fdd34d840424
nameSoftware Plan - Standard
templateDataeJyLjgUAARUAuQ==
pageCommCare Help Site Design Guidance
addpanelfalse

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:

Table of Contents

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. This report is very useful for ensuring 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:

  • Assigned Location(s) -Assigned locations for the user, with the primary location highlighted in bold.

  • 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 application home screen.

  • Application name and version (Released Version) - the application name and version as indicated by the the last successful heartbeat request (refer to the note below to understand more on heartbeat request) from user's mobile device.

  • CommCare Version - the CommCare version as indicated by the last successful heartbeat request from user's mobile device.

  • Number of unsent forms in user's phone - Number of unsent forms on the device at the time of the last successful heartbeat request.

Note: Heartbeat is a periodic http request that CommCare makes in order to exchange some key data points with the server. Mobile devices send heartbeat requests to update all of the above information. If a mobile worker has updated to a new application version but the device has not made a heartbeat request yet, then the old application version will be displayed in this report. The same can be the case with the number of unsent forms, if a user has just synced but the device has not been able to make a heartbeat request yet, then the old value of "number of unsent forms" will be displayed in the column for the selected duration.  For more technical information on heartbeat requests, please refer to 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.

  • Filtering Options

    • Users:Choose users to include in report results

    • Application : Select specific application to show aggregation statistics for. If none is chosen, data from all the applications in the project space is included.

    • Start Date : Select a start date up to 1 year ago. Report displays data from the selected date to today.

      image-20240327-122818.png

Raw Forms, Errors & Duplicates

Purpose: Provides the ability to 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 peculiar/unfamiliar is going on with submissions, or there is a need to inspect data at a finer granular level, this is one place to look for clues.

It should be noted that the forms with errors which are shown in the report are only those that were not successfully processed in CommCare HQ. Forms that have errors on the mobile device and were not successfully submitted will not show up in this report.

...

Please note that linked project spaces will not share form submissions, including duplicates or ones with errors. The form submissions that are shown in the report are only the ones from the project space itself. To learn more about linked project spaces, please refer to this page.

Device Log Details

Purpose:  With this report one 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 being looked for.

...