Agent Installation

Quazzar Space uses lightweight agents installed on your infrastructure to collect metrics, monitor service health, and enable remote management. There are two agent types: the VM Agent for virtual machines and bare metal servers, and the Kubernetes Agent for K8s clusters.

VM Agent

The VM Agent is a small daemon that runs on Linux servers. Once installed, it reports heartbeat status, collects system metrics, and monitors services running on the host.

Installation

1. Navigate to Infrastructure > Agents in your Quazzar Space dashboard
2. Click Add Agent > VM Agent
3. Select the target project and environment
4. Copy the installation command provided — it includes a unique registration token

Run the command on your server:

curl -fsSL https://app.quazzar.space/install/agent.sh | bash -s -- --token YOUR_REGISTRATION_TOKEN

The installer will:

• Download and install the agent binary
• Register the agent with your Quazzar Space account
• Start the agent as a systemd service
• Begin sending heartbeat signals immediately

Verifying Installation

After installation, the agent should appear in your dashboard within 60 seconds. You can also verify locally:

# Check agent status
systemctl status quazzar-agent
 
# View agent logs
journalctl -u quazzar-agent --no-pager -n 50

Heartbeat Monitoring

The VM Agent sends periodic heartbeat signals to Quazzar Space. If a heartbeat is missed, the server status changes to Unreachable in your dashboard and an alert is triggered (if configured).

Heartbeat statuses:

Service Health Checks

Configure the agent to monitor services running on the host:

• HTTP checks — Verify a URL returns an expected status code
• TCP checks — Confirm a port is accepting connections
• Custom checks — Run a script and evaluate the exit code

Add health checks in Infrastructure > Agents > [Agent] > Health Checks.

Metrics Collection

On Business plans and above, the VM Agent collects system-level metrics:

• CPU — Usage percentage, load average
• Memory — Used, available, swap usage
• Disk — Usage per mount point, I/O statistics

Metrics are visible in the service and environment dashboards and can be used by AI Suggestions for optimization recommendations.

Log Collection

On Enterprise+ plans, the agent can forward application logs to Quazzar Space for centralized viewing and AI analysis. Enable log collection in the agent configuration panel.

SSH Key Management

The VM Agent supports SSH key deployment for secure remote access:

1. Navigate to Infrastructure > Agents > [Agent] > SSH Keys
2. Add authorized public keys
3. The agent deploys keys to the appropriate authorized_keys file on the server

This allows team members with the right permissions to connect securely without sharing passwords.

Kubernetes Agent

The Kubernetes Agent is deployed as a workload in your cluster and provides resource discovery, metrics, and service mapping.

Installation

1. Navigate to Infrastructure > Agents in your dashboard
2. Click Add Agent > Kubernetes Agent
3. Select the target project and environment
4. Copy the provided Kubernetes manifest

Apply the manifest to your cluster:

kubectl apply -f quazzar-k8s-agent.yaml

The manifest creates:

• A quazzar-system namespace
• A ServiceAccount with read permissions across the cluster
• The agent Deployment
• Necessary RBAC roles and bindings

Resource Discovery

Once deployed, the Kubernetes Agent automatically discovers and reports:

• Nodes — Name, capacity, allocatable resources, conditions
• Pods — Status, resource requests/limits, restart counts
• Deployments — Replica counts, rollout status
• Services — Type, ports, endpoints

Discovered resources appear in your environment dashboard and can be linked to Quazzar Space services.

Metrics Collection

The agent collects per-node metrics including CPU, memory, and pod counts. These metrics feed into your dashboards and AI analysis features.

Resource-to-Service Mapping

Map discovered Kubernetes resources to services in Quazzar Space for unified visibility. The agent can auto-map resources based on labels, or you can create manual mappings in the dashboard.

Auto-Sync

The Kubernetes Agent periodically syncs cluster state with Quazzar Space. The sync interval is configurable in the agent settings (default: 5 minutes).

Agent Limits by Plan

Agent Capabilities by Plan

Managing Agents

Updating

Agents check for updates automatically. When a new version is available, you can trigger the update from Infrastructure > Agents > [Agent] > Update.

Removing an Agent

To remove a VM Agent:

systemctl stop quazzar-agent
systemctl disable quazzar-agent
rm /usr/local/bin/quazzar-agent

To remove a Kubernetes Agent:

kubectl delete -f quazzar-k8s-agent.yaml

After removal, delete the agent entry from your dashboard.

Next Steps

• AI & Agents Overview — Learn about all AI and agent capabilities
• AI Copilot — Use AI to analyze data from your agents
• Cloud Integrations — Connect cloud providers alongside your agents