Skip to main content
Contact Support
Code42 Support

View device backup status with the Reporting web app

  1. Last updated
    10:27, 14 Sep 2017
  2. Save as PDF

Available in:

StandardPremiumEnterprise
Small Business
Applies to:

Overview

The Code42 Reporting web app provides visibility into devices, users, destinations and organizations. This article gives an overview of the device status report, to help you address common problems and answer common questions. Sample use cases below demonstrate the powerful reporting available through the Reporting web app.

Device status report

The device status report displays information about the backup status of devices in your Code42 environment.

The Code42 API DeviceBackupReport resource powers the device status report. If you need a more customized report, you can create your own customized solution with the Code42 API DeviceBackupReport.

Run a device status report

  1. Sign in to the administration console.
  2. Navigate to the Reporting web app.
    • (Version 6.5.x and later) Choose Reporting in the left menu.
    • (Version 6.0.x and earlier) From the application selector in the upper right, choose Reporting.
  3. Select the Device Status report.
  4. Enter your search parameters, such as user, device status, and OS.
  5. Click Run Report.Device status report
  6. (Optional) Click Export All As CSV to generate and download the report as a CSV file.
  7. (Optional) Click the table configuration options icon Gear_icon.png to show or hide columns.

Example use cases of the device status report

Use case 1: Backup status

Using the device status report, you can easily identify which devices have not backed up for a long period of time.

Run the report

To find the active devices that have not backed up for a period of time:

  1. From User Status, select Active.
  2. (Optional) Under Restrict to UID, refine your search by Organization, User, Device, or Destination as necessary.
  3. Click Run Report.

View results

Option A: Sort by last connected date

This method requires you to page through the results if there are more than 50 rows.

In the search results, click the Last Activity column heading to sort your results in descending order (most recent connections listed first).

Option B: Export to CSV

This method allows you to access all of the results at once, even if there are more than 50 rows.

  1. Click Export All As CSV.
    The CSV file is generated and downloads.
  2. Open the CSV file in a spreadsheet application such as Microsoft Excel.
  3. Sort the results by the lastConnectedDate output value.

Use case 2: Plan device migration

The device status report can identify devices running a particular operating system in an organization and how many devices will need to be migrated to replacements.

Run the report

To identify devices running a particular operating system within an organization:

  1. Submit a search query with the following parameters selected:
    • Organization: Specify the organization you are planning to migrate.
    • OS: Select the operating system of the devices to be migrated.
  2. Show OS version for each device:
    1. Click the table configuration options icon (Gear_icon.png).
    2. Select OS Version.
    3. Click OK.

View results

Export to CSV

This method allows you to sort by OS Version and access all of the results at once, even if there are more than 50 rows.

  1. Click Export All As CSV.
    The CSV file is generated and downloads.
  2. Open the CSV file in the spreadsheet application such as Microsoft Excel.
  3. Sort the results by the osVersion output value.

Use case 3: Purge cold storage to free space

To locate archives that can be purged from cold storage, the device status report shows all devices with archives in cold storage, along with the date on which the devices last connected.

Purge archives
This is an example only. Before purging any archives from cold storage, confirm that the archives are no longer needed. Depending on your company's data retention policy, archives may need to be kept for a defined period of time.

Run the report

  1. Submit a search query with all of the search parameters left blank in order to search all of the archives in your Code42 platform.
  2. Show the cold storage for each device:
    1. Click the table configuration options icon (Gear_icon.png).
    2. Select Cold storage.
    3. Click OK.

View results: Export to CSV

The best way to utilize the results of this query is to export the results to a CSV file because you are receiving a list of all of the devices and archives in your Code42 environment. Viewing the results within the Reporting web app would likely require you to page through the results.

  1. Click Export All As CSV.
    The CSV file is generated and downloads.
  2. Open the CSV file in a spreadsheet application such as Microsoft Excel.
  3. Filter the results to show only the devices that have coldStorage output values set to true.
    • True indicates that a device's archive is in cold storage.
    • False indicates that a device's archive is not in cold storage.
  4. Sort the filtered list by lastConnectedDate to identify the archives that are no longer needed.
  5. Purge the archives to free up space.

Use case 4: Search with custom metadata fields

The device status report also searches reference fields, which are used to store descriptive information for users (userExtRef), devices (computerExtRef) and organizations (orgExtRef).

Run the report

  1. Search for devices with one or more of the custom metadata fields:
  • User External Reference: Enter User ID or other reference information in the User field.
  • Device External Reference: Enter device ID or reference information in the Device field.
  • Organization External Reference: Enter organization ID or reference information on the Organization field.
  1. Click the table configuration options icon (Gear_icon.png).
  2. Select Device External Reference, Organization External Reference, or User External Reference
  3. Click OK.

View results

  1. Click Export All As CSV.
    The CSV file is generated and downloads.
  2. Open the CSV file in the spreadsheet application such as Microsoft Excel.
  3. Sort the results by userExtRef, computerExtRef,orgExtRefoutput value.

Use case 5: Identify Code42 app upgrade problems

The device status report enables you to identify Code42 app devices that did not upgrade successfully. Once you identify devices that did not upgrade, take the necessary steps to troubleshoot the device configuration. In most cases, manually uninstalling and reinstalling the Code42 app corrects the issue.

Run the report

  1. From Device Status, select Active.
  2. (Optional) Add other filter criteria as appropriate to narrow the search. For example:
    • Use the OS filter to limit results to only Windows devices.
    • Use the Restrict to UID filter to limit results to a specific organization.
  3. Click Run Report.

View results

Option A: View results in the Reporting web app

This method requires you to page through the results if there are more than 50 devices.

  1. Add the last connection date and Code42 app version for each device:
    1. Click the table configuration options icon (Gear_icon.png).
    2. Select Last Connected Date and Version.
    3. Click OK.
  2. In the search results, click the Last Connected Date column heading to sort the results in ascending order (oldest connections listed first).
  3. Check for devices displaying an old version number that also have not connected since the date you upgraded your devices.
    The last three digits of the version number denote the Code42 app version. For example, a device listing the version number 1446267600512 means the device is running Code42 app version 5.1.2.
Option B: Export results to CSV

This method allows you to access all of the results at once, even if there are more than 50 devices.

  1. Click Export All As CSV.
    The CSV file is generated and downloads.
  2. Open the CSV file in a spreadsheet application such as Microsoft Excel.
  3. Sort the results by the lastConnectedDate column.
  4. Check for devices displaying an old version number that also have not connected since the date you upgraded your devices.
    The last three digits of the version number denote the Code42 app version. For example, a device listing the version number 1446267600512 means the device is running Code42 app version 5.1.2.