SECURITY Full Access provileges in Workplace Manager. For RMM security information, refer to this topic in the Datto RMM Online Help.
NAVIGATION Refer to this topic in the Datto RMM Online Help.
NOTE For information about monitoring Workplace with other RMMs, please refer to Can I monitor Workplace devices with a remote monitoring and management (RMM) tool? in our FAQs. To install using a different endpoint management tool, please refer to Silent installation.
The Datto Workplace/Datto RMM Integration offers the following major benefits:
- Seamless, silent deployment and removal of Workplace using Datto RMM. The Workplace team key allows you to install or uninstall Workplace Desktop without end user interaction.
- Alerting on key problems of Workplace, like devices failing to sync. Tickets can also be created from the alerts in Autotask PSA if the ticket integration is enabled in the DattoRMM/Autotask PSA Integration.
- Visibility on Workplace status in Datto RMM. Any managed device will display the Workplace status, as well as related sync information. You can use this information in reports or filters in Datto RMM. Moreover, if you use the Autotask PSA Integration in Datto RMM, and the user-defined field (UDF) synchronization is enabled, the Workplace information will be synced to your Autotask PSA configuration items.
Remote Deployment and Monitoring via Datto RMM
The integration workflow video below demonstrates how to remotely deploy and monitor Workplace with Datto RMM. For detailed information about how to configure the Datto Workplace/Datto RMM Integration, please refer to this topic in the Datto RMM Online Help.
Workplace Desktop 7.0 and later includes an .xml file that Datto RMM can utilize for monitoring purposes. For more information on managing monitors in Datto RMM, please refer to the Monitors topic in the Datto RMM Online Help.
NOTE For further information about the contents of the .xml file that you can use to build a custom monitor in Datto RMM, please refer to Can I monitor Workplace devices with a remote monitoring and management (RMM) tool? in our FAQs.
XML Header Fields
| Name | Platform | Format | Description |
|---|---|---|---|
| now | win,mac | time_t | unix timestamp, "when this file was written" |
| platform | win,mac | string | "win" or "mac" |
| rcid | win,mac | string | agent id |
| product | win | string | Name of this product |
XML Body Fields
| Tag | Name | Platform | Format | Description |
|---|---|---|---|---|
| value | AD | win | boolean | Indicates whether the device is acting as an Active Directory integration agent. |
| value | agent-account-name | win,mac | integer | Returns the UserID (numeric value) |
| value | agent-bw-inbound | win,mac | integer | Bytes per second inbound network usage |
| value | agent-bw-outbound | win,mac | integer | Bytes per second outbound network usage |
| value | agent-connect-counter | win,mac | integer | Number of times Workplace app has reconnected since startup |
| value | agent-connection-host | win,mac | string | Host name for current Workplace app connection |
| value | agent-connection-port | win,mac | integer | Port number for current Workplace app connection |
| value | agent-hw-approved | win,mac | boolean | Status of hardware approval |
| value | agent-idle | win,mac | boolean | Indicates whether Workplace app is idle? |
| value | agent-logon-time | win,mac | time_t | Last login (Unix time stamp) |
| value | agent-online | win,mac | enum | Displays Workplace app status: Disconnected Connecting Authenticating Online Retry Low-disk-space |
| value | agent-policy-configuration-locked | win,mac | boolean | Indicates whether Workplace app configuration is locked by policy (user cannot alter configuration) |
| value | agent-run-mode | win | enum | Displays if Workplace app is running in service mode ("service") or standard mode ( "unified") |
| value | agent-start | win,mac | time_t | Displays last Workplace app start time (Unix time stamp) |
| value | agent-subscription-status | win,mac | enum |
Displays Workplace app user status: |
| value | agent-version | win,mac | string | Displays version of Workplace app version installed on the device |
| value | backup-active | win,mac | boolean | Indicates whether Workplace app is currently backing up |
| value | backup-bytes-remaining | win,mac | integer | Displays the number of bytes remaining to backup |
| list | backup-configuration | win,mac | list of strings | Lists the root folders that are being backed up |
| value | backup-files-remaining | win,mac | integer | Displays the number of files pending backup |
| value | backup-last-complete | win,mac | time_t | Displays the last time Workplace app completed a backup (Unix time stamp - shows "Now" if backup is completed) |
| value | backup-numbytes | win,mac | integer | Displays the number of bytes configured to backup |
| value | backup-numfiles | win,mac | integer | Displays the number of files configured to backup |
| value | backup-percent-complete | win, mac | 0..100 | Displays backup configuration progress as a percentage |
| value | backup-policy | win,mac | boolean | Displays whether the backup configuration is controlled by policies |
| value | backup-setting | win,mac | enum | Displays backup status, as impacted by network settings: Enable - Backup/sync enabled on the network connection Suspended - Backup disabled on the network connection Don’t-use - Sync and backup disabled on the network connection |
| value | backup-timeleft | win,mac | integer | Displays number of seconds left to complete backup |
| value | backup-stopped-quota | mac,win | boolean | Indicates that backup is suspended due to lack of storage quota |
| value | restore-active | win,mac | boolean | Displays whether the device is actively restoring |
| value | restore-bytes | win,mac | integer | Displays number of bytes in current restore set |
| value | restore-status | win,mac | 0..100 | Displays percentage complete of restore |
| value | restore-time | win,mac | integer | Displays the number of seconds left in current restore |
| value | setup-active | win,mac | boolean | Indicates whether Workplace app setup is currently running? |
| value | setup-deployment-info | win,mac | string | Displays error messages regarding Workplace app setup issues |
| value | setup-deployment-key | win,mac | string | Displays the TeamKey being used for remote deployment |
| value | setup-deployment-status | win,mac | enum | Displays the current deployment status: Init Complete Wait-email Wait-admin Wait-user Finished Failed |
| value | sync-active | win,mac | boolean | Indicates whether Workplace app is currently syncing |
| value | sync-complete | boolean | Indicates whether Workplace app is fully synced | |
| value | sync-incoming-bytes | win,mac | int | Displays the total number of bytes currently incoming |
| value | sync-incoming-files | win,mac | int | Displays the total number of files currently incoming |
| value | sync-incoming-timeleft | win,mac | int | Displays the number of seconds remaining to complete incoming sync |
| value | sync-mpf-location | win,mac | string | Displays path to users Workplace folder |
| value | sync-mpf-status | mac,win | int | Displays an error code. Please refer to Sync Errors |
| value | sync-outgoing-bytes | win,mac | int | Displays the total number of bytes currently outgoing |
| value | sync-outgoing-files | win.mac | int | Displays the total number of files currently outgoing |
| value | sync-outgoing-timeleft | win,mac | int | Displays the number of seconds remaining to complete outgoing sync |
| value | sync-policy-active | win,mac | boolean | Indicates whether the projects syncing to the device are controlled by policy |
| list | sync-projectlist | win,mac | list of records | Displays a list of synced projects, showing the FileID, Project name, Bytes synced, Files synced, Project path, Error status. Please refer to Sync Errors |
| value | sync-violations | win,mac | int | Displays the number of sync violations |
Sync Errors
| Code | Error | Description |
|---|---|---|
| 0 or 2 | engine_ok | Indicates Workplace app is functioning as expected |
| 3 | root_removed | Root Removed |
| 5 | root_missing | Project folder missing |
| 6 | invalid_root_path | Project folder is on path where watcher doesn't operate |
| 7 | cannot_create_root | Project folder cannot be created. |
| 8 | root_not_owned | Project folder is owned by someone else |
| 9 | new_root_not_empty | Project folder is new and not empty folder. |
| 10 | invalid_watcher | File watcher not operating correctly |
| 11 | create_project_failed | Unable to create project |
| 12 | out_of_diskspace | Project folder is out of disk space |
| 13 | cannot_place_file | Cannot place file into project folder |
| 14 | cannot_upload_file | Cannot upload file from project folder |
| 15 | cannot_create_folder | Cannot create folder |
| 17 | invalid_key | Cannot generate valid secret key (VFS). |
| 19 | db_rebuild | Requested sync db rebuild |
| 20 | repeated_rebuild_db | Repeated sync db rebuilds within 1h - contact support |
