Agent Details View

Selecting a machine from the Agents list opens its detail view — the single-machine workspace where you inspect a host, watch its live resource use, drill into its inventory, and act on it. This page maps out the screen: the header and its action toolbar, the four at-a-glance stat boxes, the live resource metrics, and each section of the side navigation. The view refreshes on its own as new heartbeats, metrics, inventory, scan results, and update progress arrive from the agent.

The header#

The top of the view identifies the machine and carries the action toolbar. On the left, an operating-system icon sits beside the agent's display name (or hostname if none is set), with a subtitle showing the OS version and last-seen IP address. On the right, a status indicator shows whether the agent is Online, Offline, Revoked, or in an Error state.

The action buttons to the right of the status indicator let you act on the machine directly:

Header stat boxes

Below the title, four stat boxes summarise the machine's health at a glance:

When a software update is being pushed to the agent, an update-progress banner appears under the stat boxes, showing the current phase (starting, downloading, verifying, preparing, installing, restarting, completed, failed, or rolled back), a progress bar during download, and any status or error message. See Agent Binaries & Updates.

Overview#

The first section, Overview, is a single card of key facts about the machine, pulled from its inventory:

Hostname · operating system · IP address · domain · manufacturer · model · serial number · processor · total memory · agent version · time zone.

It's the fastest way to confirm you're on the right host and to read its identity without digging into the deeper inventory sections.

Live resource metrics#

The Resource Metrics section (under Performance) shows the machine's current load with bars for:

These figures track the agent in near real time while an online machine is streaming metrics. The other Performance sections — Processor Details, Memory Slots, Storage Devices, and Physical Disks — break the hardware down further.

Side-navigation sections#

The left-hand navigation groups every section of the detail view. Some entries are shown only when they apply — Windows-only sections on non-Windows agents, Remote Access when the RustDesk integration is enabled, Recordings when session recording is enabled, and Virtualization when a hypervisor is detected on the host.

Inventory sections

The System, Performance, Network, Software, and Configuration groups are the per-machine face of Inventory. Between them they cover the operating system, hardware, boot and firmware/security state, processors, memory slots, storage and physical disks, network interfaces and shares, installed software, Windows updates and features, services, certificate, local groups, environment variables, and containers. The Agent Info section also exposes per-agent switches for unattended access and the screen-share recording policy, along with screen-share diagnostics for the host.

Operate on the machine

Several sections let you take action rather than just read state:

• Services — start, stop, and manage Windows services on the host; see Remote Services Control.
• Windows Updates — review missing and installed updates and trigger an on-demand scan; see Windows Update Management.
• PowerShell Scans — run a scan against this machine now and read its latest results.
• System Manager — browse the machine's files with the File Browser, and (on Windows) inspect the registry.
• Storage Devices — jump straight from a drive into the file browser.

Live updates#

The detail view keeps itself current without a manual refresh. While it is open, it reacts to events from the agent and updates the relevant part of the screen in place:

The live Agent Logs view streams the agent's log entries as they happen, with a log-level filter, auto-scroll, and a clear button. For the full picture of agent logging — where logs are written on the host and how to stream them — see Agent Logs.

Reading the same data over the API#

Everything the detail view shows comes from the agent and inventory endpoints, so you can read the same record and per-section inventory programmatically. Listing and reading agents requires a Helpdesk (or higher) token; see the API Reference for authentication.

# The agent record shown in the header and Overview
GET /api/agents/550e8400-e29b-41d4-a716-446655440000
GET /api/agents/hostname/SERVER01

# Per-section inventory for the machine
GET /api/agents/{id}/inventory
GET /api/agents/{id}/inventory/os
GET /api/agents/{id}/inventory/hardware
GET /api/agents/{id}/inventory/metrics
GET /api/agents/{id}/inventory/storage
GET /api/agents/{id}/inventory/network
GET /api/agents/{id}/inventory/software
GET /api/agents/{id}/inventory/services
GET /api/agents/{id}/inventory/updates

PowerShell#

The Athena PowerShell module wraps the same endpoints, so you can script the same reads the detail view performs. All require a Helpdesk role or higher.

# Find the machine, then read its sections
$agent = Get-AthenaAgent -Hostname "SERVER01"

# Full inventory, or a single section
Get-AthenaAgentInventory -AgentId $agent.Id
Get-AthenaAgentOperatingSystem -AgentId $agent.Id
Get-AthenaAgentHardware -AgentId $agent.Id
Get-AthenaAgentMetrics -AgentId $agent.Id
Get-AthenaAgentNetwork -AgentId $agent.Id
Get-AthenaAgentSoftware -AgentId $agent.Id
Get-AthenaAgentServices -AgentId $agent.Id
Get-AthenaAgentWindowsUpdate -AgentId $agent.Id