A blueprint is a set of configurations applied to one or more devices. These configurations include apps, update frequencies, volume and brightness levels, and more.
In short, a blueprint creates a uniform experience for device users and a desired state for device administrators.
If a device strays from its desired state, it’s in drift. This could be because the settings on the device were altered, or you edited the blueprint to create a new desired state.
When you apply a blueprint to a device, you converge it.
In the best-case scenario, the converge succeeds, and the device is again in its desired state.
However, sometimes, a converge can fail. When it does, you can choose what happens next.
You can:
- Do nothing (default behavior). The blueprint is applied, but settings that failed won’t be applied.
- Enable a revert. The blueprint is not applied if even one setting fails and the device is reverted to its previous state.
In both cases, the Event Feed will log what errors occurred.
The default behavior will work for most users. However, you might like to enable revert behavior because your devices would be unusable if certain settings were not applied.
To enable a revert, contact Esper.
Default Event Feed Failures
By default, if a blueprint fails to converge, you can keep track of failures in the Event Feed.
| Failures | Event Feed |
| Fails to uninstall the app during an app sync. | |
| Fails to install any enterprise apps. | |
| Timeout occurs while installing Google Play apps. | |
| Fails to restore the local version of the file during a file sync. | |
| Fails to download any content files. | |
| Fails to set the system update policy. | |
| Fails to set the screen timeout on the device. |
This feature is logged for revert actions. A success message is expected. |
| Fails to add or connect to Wi-Fi access points during a Wi-Fi sync. |
Use the Event Feed to diagnose converge failures.
Enabling Revert
After you’ve reached out to Esper to enable revert behavior, your devices will revert to their previous states if a blueprint converge fails.
During a converge, reverts will trigger when:
- Esper Agent fails to uninstall the app during App Sync.
- Esper Agent fails to Install any Enterprise apps.
- Timeout occurred while waiting for the Google Play Apps to get installed within 1 hour timeout.
- Esper Agent fails to restore the local version of the file during File Sync.
- Esper Agent fails to download any content files.
- Esper Agent fails to set the system update policy.
- Esper Agent fails to set the screen timeout on the device.
- Esper Agent fails to add or connect to Wi-Fi access points during Wi-Fi Sync.
Supported revert settings
The following blueprint settings will revert in case of failure. Where noted, the revert will not revert back to its previous state.
| Blueprint Setting | Revert Supported? |
| Device Mode Settings | Yes |
| Launcher Settings | Yes |
| Local App Install Settings | Yes |
| App Uninstall Settings | Yes |
| App Permission Policy Settings | Yes |
| Launch On Start | Yes |
| Wi-Fi Settings | Yes |
| Bluetooth Settings | Yes |
| SMS Settings | Yes |
| NFC Settings | Yes |
| Incoming Numbers Settings | Yes |
| Outgoing Numbers Settings | Yes |
| Ethernet Settings | Yes |
| ADB Settings | Yes |
| Safe Boot Settings | Yes |
| Factory Reset Settings | Yes |
| Screen Timeout Settings | Yes |
| Lock Screen Settings | Yes |
| Brightness Settings | Yes |
| Screen Orientation Settings | Yes |
| Screenshot Settings | Yes |
| Notification Bar Settings | Yes |
| Wallpaper Settings | Yes |
| Esper Settings Apps Settings | Yes |
| Android Settings App Settings | Yes |
| Custom Device Level JSON Settings | No |
| Google Services Settings | No |
| Personal Accounts Settings | Yes |
| Play Store Settings | Yes |
| Google Assistant Settings | Yes |
| Factory Reset Protection Settings | Yes |
| External Device Settings | Yes |
| USB Tethering Settings | Yes |
| File Transfer Settings | Yes |
| Camera Settings | Yes |
| Location Settings | Yes |
| Sound Settings | Yes |
| Time Date Settings | Yes |
| Timezone Settings | Yes |
| Language Settings | Yes |
| System Updates Settings | Yes |
| Strict Wi-Fi Synchronization Settings | Yes |
| Apps | Partial. Restores Enterprise apps, but not Google Play apps |
| Files | Yes |
| Wi-Fi Networks | Yes |
| Saved Access Point Settings | Yes |
Revert Event Feed Failures
You can keep track of failures and reverts in the Event Feed.
| Failures | Event Feed |
| Fails to uninstall the app during an app sync. | |
| Fails to install any enterprise apps. | |
| Timeout occurs while installing Google Play apps. | |
| Fails to restore the local version of the file during a file sync. | |
| Fails to download any content files. | |
| Fails to set the system update policy. | |
| Fails to set the screen timeout on the device. | |
| Fails to add or connect to Wi-Fi access points during a Wi-Fi sync. |
Use the event feed to diagnose converge failures.
See the expected behavior for: