Complete Deployment Guide

Deploy HyperObserve Agent across your infrastructure with our comprehensive guide

Quick Start

5-minute deployment with automatic 7-day trial

Zero Instrumentation

eBPF-powered monitoring without code changes

Multi-Platform

Linux, Windows, Kubernetes, Docker support

Overview

HyperObserve Agent is a high-performance, zero-instrumentation monitoring agent that provides comprehensive observability across multiple platforms. It leverages eBPF technology on Linux for kernel-level monitoring without requiring any application changes.

Key Features

Automatic 7-day trial - No license required to start
Multi-platform support - Linux (AMD64/ARM64), Windows
Zero-instrumentation - Works immediately after installation
eBPF-powered - Kernel-level observability (Linux only)
Multi-database support - MySQL, PostgreSQL, MongoDB, Redis, and more

Supported Platforms

Platform	Architecture	eBPF Support	Binary Name
Linux	AMD64 (x86_64)	✅ Full	hyperobserve-agent
Linux	ARM64 (aarch64)	✅ Full	hyperobserve-agent
Windows	AMD64 (x86_64)	❌ No	hyperobserve-agent.exe

Pre-Deployment Requirements

System Requirements

Minimum Hardware

• CPU: 2 cores (4 cores recommended)
• Memory: 2GB RAM (4GB recommended)
• Disk: 500MB free space + 2GB for buffering
• Network: Outbound HTTPS connectivity

Operating System

• Linux Kernel: 4.14+ (5.4+ recommended)
• Ubuntu 18.04+, RHEL/CentOS 7+
• Amazon Linux 2, Debian 10+
• Windows 10/Server 2016+

Required Kernel Features (Linux)

# Check kernel version
uname -r

# Verify eBPF support
ls /sys/kernel/debug/tracing/events/

# Check BPF syscall support
grep CONFIG_BPF_SYSCALL /boot/config-$(uname -r)

Network Requirements

Outbound Connections Required:

• License Server: https://license.hyperobserve.com (TCP 443)
• Telemetry Server: https://telemetry.hyperobserve.com (TCP 443)
• Update Server: https://updates.hyperobserve.com (TCP 443)

Installation Methods

Method 1: Binary Installation (Recommended)

Linux Installation

# Detect architecture
ARCH=$(uname -m)
case $ARCH in
  x86_64) PLATFORM="linux-amd64" ;;
  aarch64) PLATFORM="linux-arm64" ;;
  *) echo "Unsupported architecture: $ARCH"; exit 1 ;;
esac

# Download from HyperObserve (registration required)
# Visit https://www.hyperobserve.com/downloads

# Install binary
sudo chmod +x hyperobserve-agent
sudo mv hyperobserve-agent /usr/bin/

# Create required directories
sudo mkdir -p /etc/hyperobserve /var/lib/hyperobserve /var/log/hyperobserve

Windows Installation

# PowerShell as Administrator

# Create directories
New-Item -ItemType Directory -Force -Path "C:\Program Files\HyperObserve"
New-Item -ItemType Directory -Force -Path "C:\ProgramData\HyperObserve\config"
New-Item -ItemType Directory -Force -Path "C:\ProgramData\HyperObserve\logs"

# Download from https://www.hyperobserve.com/downloads
# Copy hyperobserve-agent.exe to C:\Program Files\HyperObserve\

# Install as Windows Service
New-Service -Name "HyperObserve Agent" `
  -BinaryPathName '"C:\Program Files\HyperObserve\hyperobserve-agent.exe"' `
  -DisplayName "HyperObserve Monitoring Agent" `
  -StartupType Automatic

Method 2: Quick Install Scripts

Linux One-Liner

curl -sSL https://install.hyperobserve.com | sudo bash

Windows PowerShell

iex ((New-Object System.Net.WebClient).DownloadString('https://install.hyperobserve.com/win'))

Method 3: Container Deployment

Docker

# Pull official image
docker pull hyperobserve/agent:latest

# Run with host network and privileges
docker run -d \
  --name hyperobserve-agent \
  --network host \
  --privileged \
  --pid host \
  -v /sys:/sys:ro \
  -v /proc:/proc:ro \
  -e HYPEROBSERVE_LICENSE_KEY=your-license-key \
  hyperobserve/agent:latest

Kubernetes

# Deploy as DaemonSet
kubectl apply -f https://deploy.hyperobserve.com/kubernetes/daemonset.yaml

Licensing System

🎉 Automatic 7-Day Trial

The agent automatically starts a 7-day trial on first run. No registration or credit card required! The trial is hardware-locked and includes basic monitoring features.

License Types & Features

License Type	Price	Hosts	Key Features
Trial	Free (7 days)	1	Basic monitoring, Process monitoring, Log collection
Starter	$99/month	10	+ Basic alerting, 7-day retention
Professional	$299/month	100	+ eBPF monitoring, APM, Service discovery, 30-day retention
Enterprise	$999/month	Unlimited	+ ML/AI features, Security monitoring, 365-day retention

License Activation Methods

Method 1: Environment Variable

export HYPEROBSERVE_LICENSE_KEY="HO-1.0-PROFESSIONAL-CUST123-1234567890-ABCD1234"
sudo -E hyperobserve-agent

Method 2: Configuration File

# /etc/hyperobserve/agent.yaml
server:
  license_key: "HO-1.0-PROFESSIONAL-CUST123-1234567890-ABCD1234"

Method 3: Command Line

hyperobserve-agent --license-key "HO-1.0-PROFESSIONAL-CUST123-1234567890-ABCD1234"

Configuration

Configuration files are located at:

Linux: /etc/hyperobserve/agent.yaml
Windows: C:\ProgramData\HyperObserve\config\agent.yaml

Basic Configuration

# HyperObserve Agent Configuration
agent_id: "${HOSTNAME}-${RANDOM}"

# Server endpoints (auto-failover enabled)
server:
  endpoint: "https://ingest.hyperobserve.com/v1/data"
  
  # Regional endpoints (automatic failover)
  fallback_endpoints:
    - "https://ingest-us.hyperobserve.com/v1/data"
    - "https://ingest-eu.hyperobserve.com/v1/data"
    - "https://ingest-ap.hyperobserve.com/v1/data"
  
  # License key (optional - uses 7-day trial if not provided)
  license_key: "${HYPEROBSERVE_LICENSE_KEY}"
  
  # Buffering settings
  buffer:
    type: "hybrid"
    memory_size: "100MB"
    disk_size: "1GB"
    
# Collectors
collectors:
  system:
    enabled: true
    interval: "10s"
    
  process:
    enabled: true
    interval: "30s"
    
  ebpf:
    enabled: true
    programs:
      - network_events
      - file_operations
      - process_lifecycle

💡 Tip: Use environment variables for sensitive data like passwords and API keys. The agent automatically expands ${VAR_NAME} syntax in configuration files.

Deployment Scenarios

Scenario 1: Single Server Quick Start

# Download agent from https://www.hyperobserve.com/downloads
chmod +x hyperobserve-agent
sudo ./hyperobserve-agent install

# Agent starts with 7-day trial automatically

Scenario 2: Kubernetes Cluster Deployment

# Create namespace
kubectl create namespace hyperobserve-system

# Create secret with license (optional)
kubectl create secret generic hyperobserve-license \
  --from-literal=license-key=YOUR-LICENSE-KEY \
  -n hyperobserve-system

# Deploy DaemonSet
kubectl apply -f https://deploy.hyperobserve.com/kubernetes/daemonset.yaml

Scenario 3: Fleet Deployment with Ansible

# Install Ansible role
ansible-galaxy install hyperobserve.agent

# Deploy to all hosts
ansible-playbook -i inventory deploy-hyperobserve.yml

Security Considerations

Secure Communication

• All data transmitted over TLS 1.3
• Certificate pinning available for enterprise
• Mutual TLS authentication supported

Minimal Permissions

# Create dedicated user
sudo useradd -r -s /bin/false hyperobserve

# Grant necessary capabilities
sudo setcap cap_sys_admin,cap_sys_resource,cap_net_admin+eip /usr/bin/hyperobserve-agent

Data Privacy

Configure sensitive data filtering to protect PII:

collectors:
  logs:
    filters:
      - type: "regex"
        pattern: "\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b"
        replacement: "[EMAIL]"

Monitoring & Maintenance

Health Checks

Linux Health Checks

# Check agent status
sudo systemctl status hyperobserve-agent

# View logs
sudo journalctl -u hyperobserve-agent -f

# Check health endpoint
curl http://localhost:8080/health

Windows Health Checks

# Check service status
Get-Service "HyperObserve Agent"

# View event logs
Get-EventLog -LogName Application -Source "HyperObserve Agent" -Newest 50

# Check health endpoint
Invoke-RestMethod -Uri "http://localhost:8080/health"

Performance Tuning

# Limit agent resource usage
agent:
  limits:
    cpu_percent: 10      # Max 10% CPU
    memory_mb: 512       # Max 512MB RAM
    disk_io_mbps: 50     # Max 50MB/s disk I/O

Troubleshooting

Common Issues

Agent Fails to Start

Common causes:

Missing kernel headers (Linux)
Insufficient privileges
Port conflicts on 8080

eBPF Programs Fail to Load

# Check kernel support
grep CONFIG_BPF /boot/config-$(uname -r)

# Mount BPF filesystem if missing
sudo mount -t bpf bpf /sys/fs/bpf

High CPU Usage

Solutions:

Adjust sampling rates in configuration
Disable expensive collectors temporarily
Set resource limits in agent configuration

Debug Mode

# Start in debug mode
sudo hyperobserve-agent --debug

# Or set environment variable
export HYPEROBSERVE_DEBUG=true
sudo -E hyperobserve-agent

Generate Diagnostic Bundle

# Create diagnostic bundle for support
sudo hyperobserve-agent diagnostic create

# Creates: /tmp/hyperobserve-diagnostic-<timestamp>.tar.gz

Summary

HyperObserve Agent provides enterprise-grade monitoring across all major platforms with:

Zero-Friction Deployment: Automatic 7-day trial, no registration required
Multi-Platform Support: Linux with eBPF, Windows with WMI
Enterprise Ready: Hardware fingerprinting, feature gating, offline validation
Production Tested: Built with Rust, automatic failover, battle-tested buffering

Download Agent View All Docs