List matching agents

Home - HTTP Interface - List matching agents

Usage

GET /?a=PATTERN

Parameters

• PATTERN - A pattern to match agents against (currently ignored).

Overview

List agents that have connected at one point to istatd.

Response

• Status code: 200

Response body:

{
    "count": int // The number of agents that have connected.
    "agents": [ 
        {
            "_peer" : string, // A string containing hostname and port that the remote agent connected from.
            "_online" : boolean, // Whether the agent is currently connected or not.
            "_connected": string, // An ISO-8601 datetime containing the last time the agent connected.
            "_idle": int // The number of seconds since last activity.
            // ...Other metadata, provided by the agents on connection.
        },
        // ... the rest of the agents.
    ]
}