selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitLab
DockProc logo

Self-host DockProc

Unknown

Real container block I/O stats, read straight from /proc

Open Sourceapache-2.0
docker run --pid="host" -d -v /:/host:ro -v /var/run/docker.sock:/var/run/docker.sock:ro -p 8080:8080 registry.gitlab.com/n0r1sk/dockproc:latest
Updated7 years ago
Setup difficultyEasy
Port
8080 (Port exposed by the container for the Prometheus metrics daemon)
Docker
registry.gitlab.com/n0r1sk/dockproc
DockProc screenshot 1

What is DockProc?

DockProc is a small command-line utility that reports how much data your Docker containers actually wrote and read. Instead of trusting docker stats, it scans the host's proc filesystem for container process IDs and picks up their write and read byte counters, so block I/O going over an NFS share is counted correctly. The show command prints live per-container I/O figures, optionally in JSON or YAML form. Running dockproc in prometheus mode turns it into a daemon serving metrics that Prometheus can scrape, and the author points to a ready-made Grafana dashboard. Self-hosting is a single container command: it needs the host root mounted read-only at /host, the Docker socket, the host PID namespace, and it listens on port 8080. The project is Apache-2.0 licensed on GitLab; the repository shows no activity since April 2019.

DockProc alternatives

Should you self-host DockProc?

DockProc scores 44/100 on selfhost.directory (how scoring works) and ranks #80 of 105 in Monitoring & observability.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is apache-2.0-licensed.

Its closest alternative on selfhost.directory is prometheus (92/100, 67 640 stars). It scores higher overall, so compare the two before you pick. See DockProc vs prometheus side by side.

Features

  • Accurate I/O on network shares
  • Container block I/O statistics
  • Daemon Mode
  • JSON Output
  • Live container stats view
  • Prometheus metrics export
  • YAML Output

How to install DockProc

Install DockProc with Docker

docker run --pid="host" -d -v /:/host:ro -v /var/run/docker.sock:/var/run/docker.sock:ro -p 8080:8080 registry.gitlab.com/n0r1sk/dockproc:latest

Host root is mounted read-only at /host (pass --hostsystem=/host) and the container shares the host PID namespace.

How to configure DockProc

  • --hostsystemThe place you mounted the hostsystem, f.e.: /host

    values: path

  • --versionShow application version.
  • --jsonPrint the show output as JSON
  • --yamlPrint the show output as YAML
  • --helpShow context-sensitive help (also try --help-long and --help-man).

More in Metrics

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…