list#

dpsctl agent list Usage Guide#

List the current in-memory inventory of configured Agents and live Agent sessions.

Usage#

dpsctl agent list

Flags#

Includes global dpsctl options.

   --help, -h  show help

Output#

The command returns a JSON array by default. Each entry can contain the following fields:

Field

Description

agent_id

Agent identifier from topology assignments or live handshakes.

configured

true when the active topology assigns devices to the Agent.

connected

true when the Agent has at least one active connection.

assigned_devices

Device instance IDs assigned by the active topology.

sessions

Active connections, including version, capabilities, and reported devices.

The default JSON output omits fields whose values are false or empty.

When no Agents are configured or connected, the command returns an empty array.