Skip to main content

Breeze Agent 1.x Overview

Breeze Agent 1.x is the original generation of the Cloudaware cross-platform discovery and configuration management agent. It runs on servers and Kubernetes nodes to collect OS-level inventory and telemetry and provide a secure execution channel between managed infrastructure and Cloudaware.

The collected data enriches Cloudaware CMDB and supports services such as Vulnerability Management, Intrusion Detection (IDS), Patch Management, and network discovery.

Intended Audience​

Breeze is designed for teams responsible for operating and securing servers and Kubernetes clusters, including:

Design Characteristics​

  • Simple deployment – Install from Cloudaware Admin with a single command; no inbound firewall rules required, outbound TLS on TCP 443 only.
  • Portability – Runs across major Linux distributions, Windows Server, macOS, and container/Kubernetes environments.
  • Low footprint – Designed for minimal CPU, memory, and disk usage on managed hosts.
  • Extensible platform – Pluggable architecture and SDKs so Cloudaware and customers can ship new collectors, integrations, and automation.
  • Secure by design – Uses certificate‑based authentication and TLS to communicate with Cloudaware.
  • Desired state enforcement – In DevOps modes, Breeze can keep required tools installed, configured, and healthy on target hosts.

Where Breeze Agent Runs​

Breeze Agent supports infrastructure across cloud, on-premises, and hybrid environments, including:

  • Linux, Windows, and macOS workloads running on virtual machines or physical servers
  • Public cloud compute resources such as AWS EC2, Azure virtual machines, and GCE instances
  • On-premises VMware and physical server environments
  • Kubernetes clusters, including Amazon EKS, Azure Kubernetes Service, and Google Kubernetes Engine

On Kubernetes, Breeze Agent runs as a DaemonSet, deploying an agent instance to each eligible node.

What Breeze Agent Does​

OS-Level Inventory and Telemetry Collection​

Breeze Agent collects information that cloud provider APIs do not normally expose, including:

  • Installed software and packages
  • Running processes and services
  • Local users
  • File systems and mount points
  • Network configuration
  • Hardware information
  • Host performance metrics

The agent normalizes and sends this data to Cloudaware CMDB, where teams can search inventory, build reports and dashboards, and relate operating system information to cloud and infrastructure resources. See Telemetry for details about the collected data.

Support for Security and Operations​

Breeze Agent provides OS-level context and local execution capabilities for Cloudaware security modules.

Depending on the enabled services, the agent can:

  • Collect vulnerability and configuration data.
  • Support intrusion detection and host monitoring.
  • Install and manage patches.
  • Run operational checks and collect evidence.
  • Deploy and operate supporting components such as TunHub.
  • Return execution results to Cloudaware CMDB.

See Breeze-related Workflows for module-specific details.

Automation Enablement​

Breeze Agent can run plugins and scheduled tasks delivered through Cloudaware. These capabilities support operations such as:

  • Installing packages and supporting tools
  • Applying configuration changes
  • Running custom scripts
  • Collecting integration-specific data
  • Maintaining required software and configuration state

See Extensions & Collectors and Playbooks for guidance on automation and extensibility.

Explore the Breeze Agent 1.x Documentation​

Get Started​

Follow these guides to prepare, deploy, and configure Breeze Agent:

  1. Review requirements. Check supported platforms, processor architectures, permissions, system resources, and network connectivity.

  2. Install Breeze Agent. Deploy the agent on Linux, Windows, macOS, or Kubernetes nodes.

  3. Configure Breeze Agent. Configure agent settings, proxies, connectivity, and environment-specific behavior.

Operate and Secure​

Use these guides to manage deployed agents and their Cloudaware workflows:

  • Operations: Verify agent health, manage services, validate check-ins, and troubleshoot operational issues.
  • Telemetry & Discovery: Review the inventory, OS facts, and metrics collected by Breeze Agent.
  • Breeze-related Workflows: Use Breeze Agent with Cloudaware modules and supporting integrations.
  • Security: Review authentication, communication, permissions, and agent security.
  • Playbooks: Follow procedures for common operational and troubleshooting scenarios.

Extend and Maintain​

Use these resources to extend Breeze Agent and track changes:

  • Extensions & Collectors: Develop and deploy collectors, plugins, and custom extensions.
  • Changelog: Review Breeze Agent 1.x releases, fixes, and behavior changes.