UXI Agent for Windows and macOS
The UXI Agent for Windows and macOS is a software application that runs on end-user devices, providing network administrators with real-time insights into user experience and network performance. It captures key performance metrics to help troubleshoot and optimize network connectivity.
The agent may require permissions such as location services to be enabled in order to collect information from the device regarding the wireless network. Please make sure to do a trial in your environment to verify the agent will work for you. Trials are free; contact your HPE account rep if you need an extension of your evaluation subscriptions.
Resource Utilization by UXI agent - These metrics are an average over 10 minutes with 5 tests assigned to the agent
Resource Usage | windows (10 and above)/macOS (12 and above) |
CPU | ~1-3% |
Memory | <100 MB |
Disk Space Required for agent Installation
macOS - 200MB
Windows - 100MB
Subscription
A UXI subscription is required to access the dashboard and manage agents.
Agents do not enforce subscriptions—subscription validation happens at the dashboard level.
Request this via UXI chat support or email at auxi@hpe.com.
Note: UXI is a vendor-neutral platform and works with any infrastructure provider.
To enable and disable subscriptions, please refer to this help article:
Agent in Action
Once Installed and Provisioned
✅ Test results appear on the UXI dashboard within 5-10 minutes after setup.
✅ The agent runs in the background with minimal impact on device performance.
✅ It performs low-impact synthetic tests every 2-5 minutes to measure network experience.
Synthetic Tests
The test cycle runs every 2-5 minutes and performs the following tests:
AP Scan (Wi-Fi only)
Gateway reachability
DNS check (a check to see if the agent can resolve cdn.capenetworks.io)
External connectivity
UXI servers connectivity
After these tests, the agent tests the services that are assigned to its group. The agent supports these service tests:
Ping
TCP port
HTTP GET
HTTPS GET
VoIP MOS
The agent can only test the Wi-Fi or Ethernet network that it is connected to. You cannot change the network settings as you would for a hardware sensor.
You can assign the agents to groups and then assign tests and networks to groups.
If the agent doesn't support an assigned test, it will skip it.
IPV6 support -
Agent is able to test if the machine has IPV6 address assigned to it
Agent is able to test the networking stack with IPV6 address
It can also test services and applications with IPV6 addresses
Useful information provided by the agent
Wi-Fi Experience:
Collects key Wi-Fi performance metrics:
Signal Strength (RSSI)
Signal noise (macOS only)
Transmission Rate (Tx Rate)
SSID, BSSID, Band, Channel and PHY mode
Wi-Fi Visualization Chart: Displays channel overlap, SSIDs, channel width, and nearby AP signal strength to help admins assess interference and coverage.
Ethernet Experience:
Collects the link speed and duplex mode of wired connections.
App Experience: Test critical apps, both internal and external to your environment. Provides valuable information like
DNS lookup time, HTTP and HTTPS response time, TCP port reachability, VoIP MOS score, packet loss, latency, jitter, and gateway reachability.
Path Analysis (macOS only):
Shows the network path (hops and latency) from the device to the services that you test.
Issue Triage:
When a test fails, the agent runs more checks (Wi-Fi association, DHCP, gateway, DNS and external connectivity) to find the cause.
Packet captures (PCAP) can be included with issues (macOS only).
Device Information:
Captures device model, OS version, and Wi-Fi driver version.
Monitors resource utilization (CPU, memory, battery percentage) to assess potential device-level performance issues.
Roaming Indication:
Since the agent runs tests, you can see for the specific times the tests were performed, the associated BSSIDs/APs, channels, and bands the agent was connected to.
Note - the agent does not track successful and failed roaming events reported by the OS.
Back-in-Time Troubleshooting:
Stores network metrics over time for root-cause analysis.
Enables admins to validate network changes retrospectively.
Data Push Destinations:
Integrates with other IT monitoring tools to correlate client-side data with network-wide analytics.
User Self-Service Portal:
Click the UXI Agent icon in the macOS menu bar or the Windows notification area to open the portal.
Displays the status of Gateway, DNS, External Connectivity and UXI Servers (Red = Issue, Green = Normal).
Shows the status of each application tested.
The Advanced section shows key device and network information, such as IP address, gateway, DNS servers, ISP, public IP, OS version, SSID, BSSID, signal, channel, band and PHY mode. Click Copy Data to Clipboard to share it with support.
Right-click the icon and select Upload Logs to upload the agent logs. Share the codes that the agent shows with UXI support.
Known Limitations
Wired 802.1X: The agent tests open Ethernet networks only. It does not test wired networks that use 802.1X authentication, and shows a warning instead
PCAP Data: The Windows agent does not include packet captures in issue triage yet
Path Analysis: The Windows agent does not support UXI path analysis yet
VPN Limitations: The agent does not tag test results as VPN traffic, even if tests are conducted over a VPN. The agent reports test results against the physical Wi-Fi or Ethernet connection
Limited Test Support - Agent does not support Throughput & WAT test
Agent does not support any of the settings under Advanced settings (like roam analysis, voice analysis) under the edit section
Proxy Support - The agent uses the static proxy settings of the device. It does not support proxy auto-configuration (PAC or WPAD) files or proxies that need authentication. The agent resolves service host names with the local DNS of the device, also when a proxy is in use. If only the proxy can resolve host names, the tests fail with DNS errors
Updates - The agent does not update automatically. To update, install the new version over the old version, either manually or with your MDM