Qorrelate Agent

A lightweight, cross-platform binary that auto-discovers services, collects telemetry, and streams logs, metrics, and traces to Qorrelate with zero manual configuration.

🚀 Quick Install

curl -fsSL https://install.qorrelate.io/agent | bash -s -- \
  --api-key YOUR_API_KEY \
  --org-id YOUR_ORG_ID

✨ Features

🐧 Linux Installation

Debian/Ubuntu (.deb)

# Download and install
curl -LO https://github.com/sethmichaelking/arqive/releases/latest/download/qorrelate-agent_linux_amd64.deb
sudo dpkg -i qorrelate-agent_linux_amd64.deb

# Configure
sudo vim /etc/qorrelate/agent.yaml

# Start the agent
sudo systemctl enable qorrelate-agent
sudo systemctl start qorrelate-agent

RHEL/CentOS (.rpm)

# Download and install
curl -LO https://github.com/sethmichaelking/arqive/releases/latest/download/qorrelate-agent_linux_amd64.rpm
sudo rpm -i qorrelate-agent_linux_amd64.rpm

# Configure and start
sudo vim /etc/qorrelate/agent.yaml
sudo systemctl enable qorrelate-agent
sudo systemctl start qorrelate-agent

🍎 macOS Installation

# Using Homebrew (coming soon)
brew install qorrelate/tap/qorrelate-agent

# Or download directly
curl -LO https://github.com/sethmichaelking/arqive/releases/latest/download/qorrelate-agent_darwin_arm64.tar.gz
tar -xzf qorrelate-agent_darwin_arm64.tar.gz
sudo mv qorrelate-agent /usr/local/bin/

# Run
qorrelate-agent --api-key YOUR_API_KEY --org-id YOUR_ORG_ID

☸️ Kubernetes Installation

Using Helm

helm repo add qorrelate https://charts.qorrelate.io
helm repo update

helm install qorrelate-agent qorrelate/agent \
  --set apiKey=YOUR_API_KEY \
  --set orgId=YOUR_ORG_ID \
  --namespace qorrelate \
  --create-namespace

Using kubectl (DaemonSet)

# Create secret
kubectl create secret generic qorrelate-agent \
  --from-literal=api-key=YOUR_API_KEY \
  --from-literal=org-id=YOUR_ORG_ID \
  -n qorrelate

# Apply DaemonSet
kubectl apply -f https://raw.githubusercontent.com/sethmichaelking/arqive/main/kubernetes/agent-daemonset.yaml

🐳 Docker Installation

docker run -d \
  --name qorrelate-agent \
  -e QORRELATE_AGENT_API_KEY=YOUR_API_KEY \
  -e QORRELATE_AGENT_ORG_ID=YOUR_ORG_ID \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc:/host/proc:ro \
  -v /sys:/host/sys:ro \
  --pid=host \
  qorrelate/agent:latest

⚙️ Configuration File

The agent configuration file is located at /etc/qorrelate/agent.yaml (Linux) or /usr/local/etc/qorrelate/agent.yaml (macOS).

# /etc/qorrelate/agent.yaml

api:
  key: "your-api-key"
  endpoint: "https://qorrelate.io"
  org_id: "your-org-id"

discovery:
  process:
    enabled: true
    interval: 30s
  docker:
    enabled: true
    socket: "/var/run/docker.sock"
  kubernetes:
    enabled: false  # Enable when running in K8s

telemetry:
  logs:
    enabled: true
    paths:
      - "/var/log/*.log"
      - "/var/log/syslog"
  metrics:
    enabled: true
    interval: 60s
    host_metrics: true

forwarder:
  batch_size: 1000
  flush_interval: 5s
  compression: gzip
  retry:
    max_attempts: 3
    initial_delay: 1s

logging:
  level: info
  file: "/var/log/qorrelate/agent.log"

🔧 Environment Variables

All configuration options can be set via environment variables with the QORRELATE_AGENT_ prefix:

🔍 Service Discovery

The agent automatically discovers services and reports them to the Qorrelate dashboard. You can view discovered services in Settings → Agents.

Detected Service Types