Skip to content
GOVERN Admin

Admin Agent Management

As an admin, you manage monitoring agents across all organizations. The agent fleet view aggregates agent status from every tenant into a single operational view.

Fleet-level agent view

Go to Monitoring → Agents in the admin console. The table shows every deployed agent with:

  • Agent ID and name
  • Owning organization
  • Environment (prod, staging, dev)
  • Status and last heartbeat
  • Version (flag agents running old versions)
  • Discovery count

Upgrading agents

When a new agent version is released:

Terminal window
# Pull the new image
docker pull archetypal/govern-agent:latest


# Restart the agent container
docker compose restart govern-agent

For Kubernetes deployments:

Terminal window
helm upgrade govern-agents archetypal/govern-agents --set image.tag=1.2.0

Agent version enforcement

In Settings → Agent Policy, configure the minimum agent version. Agents running below the minimum version appear in the dashboard with a warning and their assessments are flagged.

Remote agent diagnostics

For agents that show degraded status, use the remote diagnostics command to collect logs without needing direct server access:

Terminal window
govern-admin agent diagnose --agent-id agent_xxxx