netdata v0.1.0

Observability

Netdata — real-time, per-second infrastructure monitoring with thousands of auto-detected metrics, interactive charts, and health alarms, out of the box. Deployed as a host-networked Nomad service that reads the host's /proc, /sys, and Docker socket, with persistent config/lib/cache volumes.

nomad-pack run netdata --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- netdata

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 80.6k ⚑ Report an issue

1 task http 19999 3 volumes image netdata/netdata:latest tracks :latest image bumped today

Variables 10

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run netdata -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "netdata"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The Netdata container image. Pin a tag in production.
image = "netdata/netdata:latest"

# Host port for the Netdata web UI / API. The agent listens on 19999.
port = 19999

# Named volume for Netdata configuration (/etc/netdata).
config_volume = "netdata_config"

# Named volume for Netdata state / metrics database (/var/lib/netdata).
lib_volume = "netdata_lib"

# Named volume for Netdata cache (/var/cache/netdata).
cache_volume = "netdata_cache"

# Placement constraints. Pin to the node holding the volumes. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# Resources for the Netdata task. It keeps recent metrics in memory; bump for many charts.
resources = {
    cpu    = 500
    memory = 512
  }

Name	Type	Default	Description
job_name	string	"netdata"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"netdata/netdata:latest"	The Netdata container image. Pin a tag in production.
port	number	19999	Host port for the Netdata web UI / API. The agent listens on 19999.
config_volume	string	"netdata_config"	Named volume for Netdata configuration (/etc/netdata).
lib_volume	string	"netdata_lib"	Named volume for Netdata state / metrics database (/var/lib/netdata).
cache_volume	string	"netdata_cache"	Named volume for Netdata cache (/var/cache/netdata).
constraints	list	[]	Placement constraints. Pin to the node holding the volumes. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources	object	{ cpu = 500 memory = 512 }	Resources for the Netdata task. It keeps recent metrics in memory; bump for many charts.

Back up this pack

This pack stores data in 3 Docker named volumes: netdata_confignetdata_libnetdata_cache

restic

# Run on the node hosting this pack. Point restic at your repo first:
#   export RESTIC_REPOSITORY="s3:https://<account>.r2.cloudflarestorage.com/<bucket>"
#   export RESTIC_PASSWORD="<repo-password>"
#   export AWS_ACCESS_KEY_ID=<key>  AWS_SECRET_ACCESS_KEY=<secret>
restic backup \
  /var/lib/docker/volumes/netdata_config/_data \
  /var/lib/docker/volumes/netdata_lib/_data \
  /var/lib/docker/volumes/netdata_cache/_data

rclone (sync to S3/R2)

rclone sync /var/lib/docker/volumes/netdata_config/_data backup:<bucket>/netdata_config
rclone sync /var/lib/docker/volumes/netdata_lib/_data backup:<bucket>/netdata_lib
rclone sync /var/lib/docker/volumes/netdata_cache/_data backup:<bucket>/netdata_cache

Paths assume the default Docker volume location (/var/lib/docker/volumes). Restore by stopping the job, restoring files into the same volume, and re-running the pack.

Readme

netdata

Netdata — real-time, per-second monitoring for systems and containers. Thousands of metrics are auto-detected with zero configuration, rendered as interactive charts, with built-in health alarms and anomaly detection. Runs fully self-hosted — no cloud account required.

Single host-networked Nomad service. It reads the host's /proc, /sys, /etc/os-release, and the Docker socket (all read-only) and keeps its state in persistent volumes.

Deploy

nomad-pack registry add nomploy https://github.com/Nomploy/nomad-packs
nomad-pack run netdata --registry=nomploy

Configure

Variable	Default	Description
`port`	`19999`	Web UI / API port (`NETDATA_LISTENER_PORT`).
`config_volume`	`netdata_config`	`/etc/netdata` — your config overrides.
`lib_volume`	`netdata_lib`	`/var/lib/netdata` — the metrics database.
`cache_volume`	`netdata_cache`	`/var/cache/netdata`.
`image`	`netdata/netdata:latest`	Container image. Pin a tag in production.
`resources`	`{ cpu = 500, memory = 512 }`	Task resources. Bump memory for longer retention.

The job adds the SYS_PTRACE capability and apparmor=unconfined so Netdata can read per-process metrics — standard for the official image. The dashboard has no authentication; keep it internal or behind a reverse proxy. Deploy one instance on each node you want to monitor (pin with constraints), or connect several agents to a parent for a single view.