Documentation Index

Fetch the complete documentation index at: https://support.controlup.com/llms.txt

Use this file to discover all available pages before exploring further.

macOS Agent

Prev Next

Agent Manager 2.18.1.3259 - March 30, 2026

Agent Manager 2.18.0.3252 - March 16, 2026

  • Added support for native deployment of the ControlUp for Compliance Agent. This new deployment option is not yet available to use. The ControlUp for Compliance release notes will be updated when the feature is available.

Agent 2.17.5.2942 - August 10, 2025

Features

  • The following Agent settings are now customizable in the Extended Settings page:

    • CPU Idle Threshold - A device’s CPU is considered to be idle if it is below the set CPU usage percentage threshold. This affects the Run only when idle option for scripts.

    • Process Monitoring Threshold % (CPU) - Sets the CPU usage threshold for a process to be named in the CPU Usage chart when viewing details for a device. These processes are in the _highresourceprocs data index.

    • Process Monitoring Threshold % (Memory) - Sets the Memory usage threshold for a process to be named in the Memory Usage chart when viewing details for a device. These processes are in the _highresourceprocs data index.

  • The Agent can now use Wi-Fi information to determine a device’s location.

  • Remote Control security improvements.

  • Support for macOS 26.

Fixes

  • Fixed an issue causing Agent installations to fail.

  • The ‘Run Command’ action wasn’t working when running a command as a logged in user.

  • Improved UPN detection reliability.

  • Improved Remote Control reliability.

Known issues

  • When you uninstall the Agent, the network filter for monitoring UCC call metrics and network bytes per process is still enabled.

  • Some external monitor serial numbers aren’t recorded correctly.

  • If you upgrade the Agent during an active Microsoft Teams call, the Agent doesn't resume collecting data for that call. Call data collection will resume normally on the next Teams call.

Agent 2.17.0.2809 - May 25, 2025

New Features

  • The System Events log now contains full details when a script is executed on a device.

Fixes

  • Scripts writing to a custom data index reporting the wrong date and time.

  • Some session login information was not recorded correctly.

  • The Agent was uploading data as the wrong data type to the following fields in the url_domains index:

    • duration_ms

    • ad_device_groups

    • ad_user_groups

Agent 2.16.0.2562 - February 17, 2025

New Features

  • Remote control improvements: Due to recent changes by Apple, which deprecated the previous method for screen capture, we have made updates to our remote control capabilities to ensure seamless remote access. Note that this change requires end users to agree to a new user prompt to give the Agent permission for Remote Control when a device updates to version 2.16.

  • Data collection for connected monitors: Comprehensive reporting on all connected monitors, including display resolution, orientation, and more.

  • Enhanced capturing of installed apps data: Now including the install date for installed applications.

  • Foreground app friendly name reporting: Devices in a locked state will now report the foreground app friendly name "Locked" instead of "Loginwindow".

  • New process monitor metrics:

    • averageworkingset_long (MEMORY.AVERAGE)

    • kernelcputime_long (CPU.KERNEL)

    • Peakworkingset (MEMORY.PEAK)

    • readbytes (BYTES.READ)

    • totalcputime (CPU.TOTAL)

    • usercputime_long (CPU.USER)

    • writebytes (DISK.BYTES.WROTE)

Agent 2.15.0.2203 - October 27, 2024

New Features

  • Support for macOS Sequoia (version 15).

  • Agent collects additional data about processes, active applications, and UPNs to match data collection for the Windows Agent.

  • Added a tooltip in the Employee Sentiment survey response window to inform respondents when they are completing a non-anonymous survey.

Fixes

  • Improved QoS network filter installation and removal.

  • Some Remote Control sessions were showing a blank screen.

  • Caps lock wasn’t working in Remote Control sessions.

  • Remote Shell sessions now start in the root folder.

  • Agent was opening too many websocket connections.

  • The following network IO data was missing for processes:

    • network_bytes_total

    • network_total_bytes_out

    • network_total_bytes_in

  • Improved process stop/start data collection.

  • Sometimes the Agent would not report an active user, preventing an administrator performing actions on the device

  • Renamed the executable for Employee Sentiment surveys to “ControlUp Survey Toaster”

  • Anonymization of User Principal Name in app_focus.

  • Send correct console user for first update after Agent start.

  • Inconsistent foreground application capture.

Agent Manager 2.15 - October 1, 2024

New Features

  • Added support for new Agent version control settings to control the timing of Agent installation.

Agent 2.14.1.1860 - July 28, 2024

Fixes

  • Agent constantly prompts for access on data folder.

  • Unable to install Network filter on OSX 12&13.

  • Network Filter does not capture any UCC data.

  • Network Content filter (QoS) seems to be blocking file downloads.

  • Device is prompted to Allow QoS filter even if it is disabled in extended settings.

Agent 2.14.0.1802 - June 28, 2024

Note: Upgrading to version 2.14 requires end users to agree to prompts for:

  • Installing and using a network filter to collect UC&C data from Teams and to capture network bytes used per process.

  • Requesting data from Chrome and Safari to collect active URLs for End User Activity Monitoring.

You can prevent these user prompts from appearing by using Extended Settings. If you prevent the user prompts, then Agent doesn’t collect the additional data unless you have allowed the Agent by some other method such as an MDM solution.

New Features

  • Added support for the new Sentiment feature for delivering customized surveys. Learn more.

  • UC&C data from Microsoft Teams is now collected by the agent, letting you see additional minute-by-minute metrics when you drill down into the details of a Teams call. You can also view calls in the Live Callers Dashboard to view real-time performance of active calls. The new metrics include network information for audio/video and MOS (Mean Opinion Score), which is a standardized metric for VoIP call performance.

  • URL domains are now recorded for End User Activity monitoring. This lets you use the End User Activity dashboard to monitor which URLs your end users on Mac devices are actively using.

  • Process Stop data is now aligned with the format for Windows devices to allow combined reports across platforms.

  • Added an Extended Setting to prevent the user prompt for location collection. Location data can still be collected if enabled by another method such as an MDM solution.

  • Improved compatibility with some MDM solutions by changing the UserAgent from a command line executable to an application. This makes it easier to target MDM policies.

  • Improved data upload efficiency.

  • Agent now records network bytes used per process.

  • Updated Agent geolocation logic to support custom locations by IP ranges. Learn more.

  • Support for custom messages to appear when the device is rebooted from Edge DX. Learn more.

Fixes

  • Agent was not sending the correct list of active users unless force killed and restarted.

  • Issue with collecting and sending UPN.

  • Issue where Wi-Fi information wasn't showing for the latest macOS release.

  • Fixed CPU spikes.

  • Remote Control was failing on new user sessions.

  • Improved reliability of Websocket reconnects.

  • macOS Monterey was showing the incorrect number of active user sessions.

Agent 2.12.9.1094 - February 9, 2024

Fixes

  • No attempt to run modules without a valid license.

  • Do not allow stdin to block taskrunner