MatuOps Agent

Node.js + TypeScript agent that runs on monitored Linux servers (Ubuntu 20.04/22.04/24.04) and forwards:

• Metrics: CPU, load average, RAM, swap, disk, network throughput, uptime, temperature
• Systemd services: detection of known services (nginx, mysql, docker, …) with status / PID / CPU / RAM / restarts
• Processes: top CPU / RAM consumers
• Docker containers: running / exited containers with stats
• Logs: journalctl, syslog, auth.log, nginx / apache / docker logs
• Security events: SSH brute force, sudo anomalies

The agent registers itself with the MatuOps platform via a one-time registration key and then authenticates each request with a per-server agent token.

Install (Ubuntu)

curl -fsSL https://ops.matubyte.com/agent/install.sh | sudo bash -s -- \
  --server https://ops.matubyte.com \
  --key mreg_xxxxxxxxxxxxxxxxxxxxxxxxx

Or install the package directly:

npm install -g @matubyte/matuops-agent

The installer:

1. Verifies Node.js ≥ 18 (installs it if missing).
2. Installs the agent globally via npm.
3. Writes /etc/matuops/agent.yaml.
4. Calls matuops-agent register.
5. Enables and starts the matuops-agent systemd service.

CLI

matuops-agent register --server <url> --key <registration-key>
matuops-agent start                    # foreground (systemd runs this)
matuops-agent status                   # prints heartbeat status
matuops-agent logs --follow            # tail agent logs
matuops-agent uninstall                # stop + disable + remove

Configuration

/etc/matuops/agent.yaml:

server: https://app.matuops.com
serverId: 00000000-0000-0000-0000-000000000000
agentToken: mat_xxxxxxxxxxxxxxxxxxxxxxxxx
intervals:
  metrics: 20
  services: 30
  processes: 30
  containers: 30
  heartbeat: 30
collectors:
  logs: true
  security: true
  docker: true
logLevel: info