KloudMate Agent

The KloudMate Agent is a single program you install on your servers, containers, or clusters. Once running, it finds what you run, collects host metrics and logs, and turns on kernel-level observability. You can then add deeper application tracing one service at a time, all from the KloudMate web interface.

It is built on the OpenTelemetry (OTel) Collector with a curated set of components. You get simple deployment, remote configuration, and extended Berkeley Packet Filter (eBPF) observability without writing any collector configuration.

The agent is managed from the KloudMate web interface. When you change a setting, the agent applies it for you, so there is no need for Secure Shell (SSH) access or local file edits. Each agent’s health and status appear in your dashboards.

To go deeper, read Architecture and the Configuration model.

What the agent collects

Some of what the agent collects is automatic. The rest needs a process restart, so you turn it on per service when you are ready.

Automatic, as soon as the agent is installed:

• Discovery: a live inventory of the services, runtimes, and databases running on each host or cluster.
• Host metrics and logs: CPU, memory, disk, and network metrics plus system logs, with no configuration.
• eBPF monitoring: Rate, Errors, and Duration (RED) metrics, a network service map, Database Activity Monitoring (DAM), and trace-context propagation, with no code changes.

Opt in per service or database:

• Application performance monitoring (APM): distributed traces for Java, Node.js, Python, .NET, and PHP applications.
• Database monitoring: health metrics, query performance, and logs for your databases.

The agent also reports its own status and error logs.

Supported platforms

The agent runs across four deployment modes. Not every capability applies to every mode. eBPF depends on the Linux kernel, so it does not apply on Windows. There, Event Tracing for Windows (ETW) monitoring provides the equivalent view.

Capability	Linux / VM	Windows	Kubernetes	Docker
Service discovery	Yes	Yes	Yes	Yes
Host metrics and logs	Yes	Yes	Yes	Yes
eBPF monitoring (RED, service map, DAM)	Yes	Not applicable	Yes	Yes
Application APM (Java, Node.js, Python, .NET)	Yes	Yes	Yes	Via eBPF
Application APM (PHP)	Yes	Not applicable	Not applicable	Yes
Database monitoring	Yes	Yes	Yes	Yes
Web server monitoring (nginx, Apache)	Yes	Not applicable	Yes	Yes
Log monitoring (custom log files)	Yes	Yes	Not applicable	Yes
Agent health and self-logs	Yes	Yes	Yes	Yes

Note

On Linux, eBPF monitoring needs kernel 4.14 or newer, and does more on 5.8 and above. On Docker, host and container metrics and logs are automatic; application tracing is opt-in per service (Off / eBPF). PHP containers are traced in place without a redeploy, and Java, Node.js, Python, and .NET use eBPF (no SDK injection on Docker). See Docker platform notes.

Install the agent

Network egress rules and host privileges are what commonly block an install in enterprise environments. See Before you start to check both first.

Linux Install the KloudMate Agent on Debian, Ubuntu, RHEL, or CentOS.

Docker Deploy the KloudMate Agent as a Docker container.

Windows Install the KloudMate Agent on Windows Server 2016 and above.

Kubernetes Deploy the KloudMate Agent via DaemonSet and Deployment.

Learn the concepts

Architecture How the agent is managed across deployment modes.

Discovery How the agent inventories your services.

Configuration model Managed and manual modes, and how the collector config is generated.

Future support

In future releases, the agent will also support:

• macOS
• Oracle Cloud Infrastructure (OCI)