Devices reference
Overview
Devices displays information about all endpoints with installed Code42 agents. Use the Devices screen to view a list of devices, review device details and settings, and perform actions on a device.
Devices
The first time the Code42 agent installed on an endpoint connects to the Code42 cloud, that device is automatically added to Code42 and the device details are visible on the Devices screen.
To access Devices, select Administration > Environment > Devices.
Item | Description | |
---|---|---|
a | Device report |
Opens the Device Status report, which shows more details about the devices listed. Backup agent and legacy agent only |
b | Export ![]() |
Exports the current list of devices to a CSV file and downloads it to your local device. For information on the fields included in the export, see Device CSV export fields. |
c | Filter ![]() |
Filters the list of devices by the criteria you select. By default, the table is filtered to show all active devices.
A device must match all specified filters to be included in the results. |
d | Filtered by | Identifies the filters applied to the devices list. Click the X to remove a filter. |
e | Name |
The name assigned to the device by Code42. By default, Device Name uses the Hostname reported by the device's operating system.
For the backup agent and legacy agent, users and administrators can change the Device Name in the Code42 agent, and in the Code42 console via Actions > Edit device backup details > General. |
f | Hostname | |
g | Operating system | Operating system for this device. |
h | Status | The device's status: Active, Deactivated, or Blocked. For more details, see Block, deauthorize, and deactivate. |
i | Agent type |
Indicates the Code42 agent type installed on the device.
Available agent types vary based on your product plan. |
j | Version |
Version number of the Code42 agent installed on the device. Insider risk agent version number details
|
k | Last backup activity (UTC) |
The last time any backup activity occurred on this device. Backup agent and legacy agent only |
l | Backup alerts |
Indicates backup activity status, based on the warning and critical thresholds defined in Organization Details:
If a device is backing up to multiple destinations, the most severe alert is listed. To view the backup status for each destination, select the device to open the device details. Backup agent and legacy agent only |
m | Last check-in (UTC) | The last time the device connected to the Code42 cloud. |
n | View device details ![]() |
Click to open the device's details to view more information about that device. |
A single device is displayed multiple times if the Code42 agent is installed per user for multiple user accounts. (Only applies to the backup agent and legacy agent.)
Device details
Click any row in the Devices table to view more details about that device. You can also access device details by selecting a device in the User Detail View.
Item | Description | |
---|---|---|
a | Hostname | |
b | Status | The device's status: Active, Deactivated, or Blocked. For more details, see Block, deauthorize, and deactivate. |
c | Username | The username signed in to the Code42 agent on this device. Click the link to view the user's profile. |
d | Actions |
Lists actions to perform on the device:
Insider risk agent
Backup agent and legacy agent
|
e | Device name |
Backup agent and legacy agent only The name assigned to the device by Code42. By default, Device Name uses the Hostname reported by the device's operating system.
Users and administrators can change the Device Name in the Code42 agent, and in the Code42 console via Actions > Edit device backup details > General. |
f | Operating system |
The device's operating system: Windows, Mac, or Linux. |
g | IP address | The IP address the Code42 agent last reported to the Code42 cloud (as reported by the device's operating system). |
h | GUID | Globally Unique Identifier for this device. |
i | Agent type |
Indicates the Code42 agent type installed on the device.
|
j | Agent version |
Version number of the Code42 agent installed on the device. Insider risk agent version number details
|
k | Authority connection |
Indicates the device's connection status:
Backup agent and legacy agent only |
l | Restores |
The number of restores initiated for files backed up from this device. Click the number to view the device's Restore history. Backup agent and legacy agent only |
-- |
Last check-in (not pictured) |
Date and time the device last connected to the Code42 cloud. Insider risk agent only |
m | Date created | Date the device was initially added to Code42. |
-- |
Profile Backup (not pictured) |
The most recent date that the USMT ScanState command ran successfully and created a MIG file. A green checkmark indicates the last ScanState command succeeded. A red exclamation point indicates the last ScanState command failed.
Only appears for:
|
-- |
Reference (not pictured) |
Notes about the device for reference. For more information, see Add reference information to devices, users, and organizations.
Insider risk agent only. Reference information for the backup agent and legacy agent appears in the settings tabs. |
Backup agent and legacy agent
Devices with the backup agent or legacy agent include additional details about backup status and device settings.
Item | Description | |
---|---|---|
a | Destination | Name of the backup destination. The icon next to the destination name indicates whether the destination is a cloud destination (cloud icon) or a local destination (hard drive icon). |
b | Selected | Amount of data on this device selected for backup. |
c | Backup Status |
Progress bar representing the amount of data backed up and the amount remaining. The amount displayed is refreshed at least once every 15 minutes.
Progress bar colors represent alert state:
Warning and critical states are determined by reporting settings.
If there are multiple backup sets backing up to the same destination, indicates the combined status of all backup sets. (Code42 agent version 10.x and earlier indicates the status of the backup set with the most recent activity.) |
d | Last Activity | The time since this device sent any backup data to the specified destination. |
e | Completed |
The time since this device last completed a backup to the specified destination.
If there are multiple backup sets backing up to the same destination, indicates the time since all backup sets completed. (Code42 agent version 10.x and earlier indicates the time since the most recent backup set completed.) |
f | Used storage | Total amount of data stored in this device's backup archive at the specified destination. |
g | Restore |
Displays the Web Restore window, from which you can select files to restore from this destination. View tutorial for additional information. |
h | Archive options |
The archive action menu provides options to:
|
i | Settings |
Read-only display of settings for this device. Go to Actions > Edit device backup defaults to change settings.
For more details about each tab, see: |
Restore history
Backup agent and legacy agent only
View the Devices: Backup Restore History screen by clicking the number of restores from the Device details.
Item | Description | |
---|---|---|
a | Device name |
The name assigned to the device by Code42. By default, Device Name uses the Hostname reported by the device's operating system.
Users and administrators can change the Device Name in the Code42 agent, and in the Code42 console via Actions > Edit device backup details > General. |
b | Operating System | Displays the operating system of the device that received the restored data. |
c | User | User whose data was restored. An info icon ![]() |
d | Restore to | Device that received the restored data. Click to view the Device details. |
e | # Files | Number of files restored. |
f | Size | Total size of the restored files. |
g | Transfer rate | Speed in Mbps of the file restoration. |
h | Restore date | Date and time the files were restored. |
i | Duration | Total time to restore the files. |
j | Export | Click to export the restore history details to a CSV file and download it to your local device. See Restore history CSV export fields below for descriptions of all included fields. |
Restore history CSV export fields
Export the restore history table to a CSV file by selecting Export . The following attributes are exported to the CSV file.
Field | Description |
user | User whose backup data was restored. |
deviceName | Name of device that received the restored data. This is the name assigned to the device by Code42. Users and administrators can change this name. |
numFiles | Number of files that were restored. |
numBytes | Total size of the files restored. |
transferRateBytesPerSecond | Speed in Mbps of restore job. |
startDate | Date the restore started. |
endDate | Date the restore finished. |
acceptingDeviceId | ID of the device that received the restored data. |
acceptingDeviceName | The name of device that received the restored data. This is the name assigned to the device by Code42. Users and administrators can change this name. |
acceptingDeviceOsHostname | The name of the device that received the restored data, as reported by the device's operating system. The osHostname is a device property that is not managed by Code42, but if an authorized user changes the hostname of the device, the new hostname may take up to 24 hours to update in the CSV export and Code42 console. |
acceptingDeviceOsName | Operating system of the device that received the restored data. |
acceptingDeviceOsVersion | Version of the operating system of the device that received the restored data. |
acceptingType | Type of device. |
acceptingUserFirstName | First name of the user whose device accepted the restored data. |
acceptingUserId | ID of the user whose device accepted the restored data. |
acceptingUserLastName | Last name of the user whose device accepted the restored data. |
acceptingUsername | User name of the user whose device accepted the restored data. |
completedDate | The date the restore finished. |
rateByesPerSecond | Speed in Mbps of restore job. |
requestingUserId | ID of the user who requested the restore. |
restoreBytes | Total bytes restored. |
restoreFiles | Number of files restored. |
restoreId | ID of the restore job. |
sourceOrgId | ID of the organization where the restored files originated. |
sourceUserId | ID of the user whose files were restored. |
startDate | Date the restore began. |
Device CSV export fields
Export the current list of devices to a CSV file by selecting Export . The following attributes are exported to the CSV file.
Field | Description |
computerId | Identification number for the device. |
name | The name assigned to the device by Code42. By default, name uses the osHostname reported by the device's operating system, but users and administrators can change the name in the Code42 agent and/or Code42 console. |
osHostname |
The name of the device as reported by the device's operating system. The osHostname is a device property that is not managed by Code42, but if an authorized user changes the hostname of the device, the new hostname may take up to 24 hours to update in the Code42 console and CSV export. |
guid | Globally Unique Identifier for the device. |
status | Active, deauthorized, deactivated, or blocked |
active | TRUE: Device is active FALSE: Device is deactivated |
blocked | TRUE: Device is blocked FALSE: Device is not blocked |
alertState | Backup alert state of this device. |
userId | Identification number of the device's user. |
orgId | Identification number of the device's organization. |
lastConnected | Time when the device last connected to the Code42 cloud. |
osName | Operating system of the device. |
osVersion | Version of the operating system of the device. |
osArch | Architecture of the device. |
address | IP address that the Code42 agent last reported to the Code42 cloud. |
remoteAddress |
Device's IP address. |
javaVersion | Version of Java that the Code42 agent uses on this device. |
timeZone | Time zone the device last reported to the Code42 cloud. |
displayVersion | Version number for the device's installation of the Code42 agent. |
service | Indicates which service the device is using. |
targetComputerId | Identification number of the device used for computer-to-computer backup. |
targetComputerGuid | Globally Unique Identifier for the device used for computer-to-computer backup. |
targetComputerName | Name of the backup destination of the device used for computer-to-computer backup. |
targetComputerOsName | Operating system for the device used for computer-to-computer backup. |
targetComputerType | Type of device used for computer-to-computer backup. This is either a SERVER or DEVICE. |
selectedFiles | Total number of files selected for backup from this device. |
selectedBytes | |
todoFiles | |
todoBytes | |
archiveBytes | |
billableBytes | Amount of data that is billable. |
lastActivity | Time since the device sent any backup data to the specified destination. |
lastCompletedBackup | Time since the device last completed a backup to the specified destination. |
lastConnected | Time when this device last connected to a storage destination. This field differs from the first instance of lastConnected returned in the CSV export, which indicates the time when the device last connected to the Code42 cloud. |
using |
TRUE: An archive for the device exists in the Code42 environment. FALSE: No archive exists for the device in the Code42 environment. |
targetAlertState | Deprecated. No longer in use. |
percentComplete | Percentage of backup that is complete. |
userUid | Unique identifier of the user. |
computerExtRef | Customer-provided reference for the device. |
modelInfo |
Device's hardware model information. |
creationDate |
Date the device was first registered. |
modificationDate |
Time when the device's database record was last updated. |
loginDate |
Time when the device last connected to the Code42 cloud. |
upgradeAvailable |
Whether a new version of the Code42 agent is available for the device. Values are true or false. |