Host Agents

Host agents entitlement and usage is reported in two sections:

  • Host Agents - Current Usage
  • Active host agents deployment type overview

Current Usage

The section displays the number of currently connected agents, compared to the entitlement.

  • The bar on the left represents the agents included in the subscription, showing you how many slots you’re currently using, compared to those that are available.

  • On the right, the on-demand bar shows you how many additional agents you can connect, on top of the reserved entitlement. If your contract doesn’t include on-demand usage, this will be disabled, meaning that you can only fill the reserved available slots, after which, additional connections will be refused.

Active Host Agents Deployment Type Overview

This bar breaks down the currently deployed agents into different types:

  • Containerised: The number of agents running in a containerized environment.
  • Non-containerised - The number of agents running in a non-containerised environment.
  • Unspecified - The number of agents running in an unknown environment. Update Sysdig Agent to version 12.18.0 or later to receive environment information.

Agent Connections

Agents connect on a first-come, first-served basis. In the event of an over-subscription (more agents wanting to communicate than are licensed), they will attempt to reconnect on a periodic basis. Once an existing communicating instance goes down and disconnects, the next agent in the queue will connect.

When shutting down a host for any reason, the agent’s license will not be immediately released. This permits the agent to retain its licensing slot for short outages or a reboot. The time-out interval can take up to 20 minutes, and if the connection has not been re-established within the interval the license will be released for use by the next host waiting to connect.

The distinction between reserved and on-demand agents is financial, not technical; when on-demand agents are used they perform exactly like reserved agents.