Troubleshooting Electric Desktop and MDM Reporting Issues

Introduction

When Electric Desktop or MDM stops reporting as expected, it can feel like the lights suddenly went out on your device visibility. The good news? Most issues have a clear cause and a straightforward fix. This guide walks you through a structured troubleshooting process so you can restore full visibility and get your fleet humming again.

If you work through these steps and the issue persists, reach out to the team at support@electric.ai.

Common Causes

Before diving into fixes, it helps to know what typically trips the circuit. Issues usually fall into one of these categories:

Network and Connectivity

• Device is offline, powered off, or in transit

• Firewall blocking required outbound traffic

MDM Agent Issues

• Agent stopped after an OS update or unexpected crash

• Enrollment profile was removed or modified

Certificate Expiration

• An organization-level certificate has expired, disrupting fleet authentication

User Changes

• The enrolled user account was disabled or modified

• A device and user mismatch is breaking authentication

Electric Desktop App Issues

• App was closed, uninstalled, or shut down due to low system resources

• A third-party antivirus or endpoint protection tool is blocking the app

Step-by-Step Troubleshooting

Step 1: Verify Connectivity

Start here. Many reporting gaps are simply a matter of the device being unreachable.

• Confirm the device has external internet access

• If your organization uses internal network routing, confirm internal access as well

Step 2: Validate MDM Agent Status

Navigate to the device profile and check the Details tab. If the agent shows as inactive and the device is confirmed online, take the following steps based on OS:

Windows

1. Open Task Manager

2. Locate the MDM client process

3. Start the service if it has stopped

macOS

1. Open System Settings

2. Navigate to Profiles

3. Confirm the MDM enrollment profile is present

Step 3: Validate Electric Desktop Status

The Electric Desktop app is responsible for sending device data back to your admin view. If it is not running, data will go stale.

Common reasons the app may not be active:

• Device was powered off for an extended period

• App was terminated due to low system resources

• User manually quit or removed the app

• Antivirus or endpoint protection software blocked the process

Resolution Paths

Path 1: Restart Electric Desktop

The quickest fix. Relaunch the app from the device's application menu and re-authenticate if prompted. In many cases, this restores the connection immediately.

Path 2: Restart the Device

If the app restart does not resolve the issue, a full device restart clears resource constraints and reinitializes background services. Once the device is back online, Electric Desktop should reconnect automatically.

Path 3: Reinstall Electric Desktop

If the issue persists after the above steps, a full reinstall may be necessary. Use the unenroll and reinstall flow to remove and redeploy the app.

System Architecture Notes

Understanding how the two core systems interact helps clarify why you might see one working while the other is not.

• MDM is powered by JumpCloud and manages device policies, security enforcement, and remote actions

• Electric Desktop uses osquery to collect and transmit device health and analytics data

These systems operate independently of one another. It is possible for MDM to remain active while osquery has stopped reporting, and vice versa. When troubleshooting, always validate each system separately rather than assuming one failure indicates both have failed.

Device Data Update Cadence

If device data looks stale in your admin view, check the expected update frequency below before escalating. Some data points update more frequently than others based on their security relevance.

Allow the expected cadence to pass and refresh your view before continuing to troubleshoot.

Still stuck? The support team is ready to help. Reach out at support@electric.ai and request a screenshare session for hands-on guidance.