Launching an Agent

Run a Cloud Agent on-demand from the Agent Catalog.

You can launch any Cloud Agent on-demand from the Agent Catalog. The agent starts immediately, executes against the target you specify, and produces a report when it finishes.

Launch Steps

  1. Open Agent Hub → Cloud Agents → Agent Catalog.
  2. Find the agent you want to run and click Launch.
  3. Fill in the launch form:
    • Target cluster — required for agents that run against a cluster. The dropdown shows all clusters connected to your Control Hub instance.
    • Namespace — required for agents scoped to a namespace (shown only when applicable).
    • Additional inputs — agent-specific parameters such as resource names, severity thresholds, or output format. Each field includes a description of what it expects.
  4. Click Run to start the agent.

After Launch

Once launched, the run appears immediately in Agent Runs with status Running. You can:

  • Follow live execution logs and step-by-step progress (for Workflow agents).
  • Wait for the run to complete and then view or download the report.

Disconnected Clusters

If the selected cluster is disconnected at launch time, the run will retry automatically before being marked as Failed. Check cluster connectivity under Cluster Management if a run is stuck retrying.

Permissions

Some agents require specific Kubernetes RBAC permissions on the target cluster. The Agent Catalog entry for each agent lists its required permissions. Verify these are in place before launching — the agent runs under a scoped service account that is provisioned automatically and cleaned up after the run completes.