Integrate with Datto RMM

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:
Enabled
Disabled
Deleted
Quarantined
Guest

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