# DockProc

> Self-hosted, open-source Docker monitoring tool that reads wrote_bytes and read_bytes from /proc to report true container block I/O and export Prometheus metrics.

- **Category:** [Monitoring & observability](https://selfhost.directory/monitoring-observability)
- **Licence:** apache-2.0
- **Source model:** Open source
- **Latest version:** Unknown
- **Author:** n0r1sk
- **Platforms:** Docker
- **Ports:** 8080 (Port exposed by the container for the Prometheus metrics daemon)
- **Tags:** Monitoring, CLI, Grafana, Nfs, Docker, Prometheus, Prometheus exporter

## Docker images

- [`registry.gitlab.com/n0r1sk/dockproc`](https://registry.gitlab.com/n0r1sk/dockproc)

## 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.

## Should you self-host DockProc?

DockProc scores **44/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#80 of 105** in [Monitoring & observability](https://selfhost.directory/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](https://selfhost.directory/project/prometheus) (92/100, 67 651 stars). It scores higher overall, so compare the two before you pick. [See DockProc vs prometheus side by side.](https://selfhost.directory/compare/dockproc-vs-prometheus)

## 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
```

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

## DockProc alternatives

- [dockprom](https://selfhost.directory/project/dockprom): dockprom is a self-hosted, open-source Docker monitoring stack with Prometheus, Grafana, cAdvisor, NodeExporter, AlertManager, Pushgateway, and Caddy in one Compose file. (compare: https://selfhost.directory/compare/dockproc-vs-dockprom)
- [dockprobe](https://selfhost.directory/project/dockprobe): Self-hosted Docker monitoring dashboard with real-time metrics, anomaly detection, and Telegram alerts in a single container. (compare: https://selfhost.directory/compare/dockprobe-vs-dockproc)
- [Dockpeek](https://selfhost.directory/project/dockpeek): An open-source, self-hosted Docker dashboard that opens container web UIs, streams logs, shows published ports, and checks image updates across multiple hosts and Swarm. (compare: https://selfhost.directory/compare/dockpeek-vs-dockproc)
- [Node Exporter](https://selfhost.directory/project/node-exporter): Open-source metrics exporter for Unix systems hardware and OS data. Collects CPU, memory, disk, network stats via pluggable collectors. (compare: https://selfhost.directory/compare/dockproc-vs-node-exporter)
- [Doku](https://selfhost.directory/project/doku): Self-hosted web dashboard that tracks where a Docker host's disk space goes: layers, logs, volumes and more, with basic auth, TLS support and read-only access. (compare: https://selfhost.directory/compare/dockproc-vs-doku)
- [dockhand](https://selfhost.directory/project/dockhand): Dockhand is a self-hosted Docker management platform with real-time container monitoring, Compose orchestration, Git deployments, and SSO. Free for homelabs under BSL 1.1 (compare: https://selfhost.directory/compare/dockhand-vs-dockproc)
- [portracker](https://selfhost.directory/project/portracker): Open-source, self-hosted port monitoring dashboard that auto-discovers services on Docker and TrueNAS hosts and unites many servers through peer instances. (compare: https://selfhost.directory/compare/dockproc-vs-portracker)
- [dockwatch](https://selfhost.directory/project/dockwatch): Self-hosted Docker container manager with web UI for updates, notifications (Notifiarr, Telegram, Mattermost), multi-host control, auto-restart, and orphan cleanup. (compare: https://selfhost.directory/compare/dockproc-vs-dockwatch)

## More in Metrics

- [gigapipe](https://selfhost.directory/project/gigapipe): Self-hosted open-source observability backend merging four telemetry types into ClickHouse with Loki, Prometheus, Tempo and Pyroscope protocol support.
- [GrafanaMimir](https://selfhost.directory/project/grafanamimir): Open-source, self-hosted long-term TSDB for Prometheus: multi-tenant, replicated metrics storage that scales past a billion active series.
- [hertzbeat](https://selfhost.directory/project/hertzbeat): Apache HertzBeat is a self-hosted, open-source observability system unifying agentless metrics and logs collection, alerting, and notification dispatch.
- [Kula](https://selfhost.directory/project/kula): Self-hosted, open-source Linux server monitor in one Go binary: real-time web dashboard plus TUI, built-in ring-buffer storage, Prometheus export, app monitoring.
- [Monitorix](https://selfhost.directory/project/monitorix): Self-hosted, open-source monitoring daemon for Linux and BSD servers that charts system, network, sensor and service statistics in a built-in web interface.
- [monoscope](https://selfhost.directory/project/monoscope): Open-source, self-hosted observability that keeps logs, metrics and traces in your own S3 buckets, with plain-English queries, scheduled AI agents and session replay.
- [munin](https://selfhost.directory/project/munin): Open-source, self-hosted infrastructure monitor: a master polls nodes every five minutes, stores data in RRD files, and draws graphs in a web UI with 500+ plugins.
- [pcp](https://selfhost.directory/project/pcp): Performance Co-Pilot (PCP) is an open-source, self-hosted framework for system-level performance monitoring across distributed systems.
- [prometheus](https://selfhost.directory/project/prometheus): Prometheus is a self-hosted, open-source monitoring toolkit that pulls metrics via HTTP, stores them locally, and uses PromQL for powerful queries and alerting.
- [statsd](https://selfhost.directory/project/statsd): A self-hosted, open-source network daemon that aggregates counters, timers, and gauges sent over UDP or TCP, forwarding them to pluggable backends like Graphite.
- [Telegraf](https://selfhost.directory/project/telegraf): Open-source, self-hosted telemetry agent that collects, processes and writes metrics and logs via 300+ plugins, shipped as a single static binary configured in TOML.
- [UniFi-Poller](https://selfhost.directory/project/unifi-poller): This open-source, self-hosted poller gathers UniFi controller data every 30 seconds and feeds InfluxDB, Prometheus or Loki, with thirteen ready-made Grafana dashboards.

## Links

- [Homepage](https://gitlab.com/n0r1sk/dockproc)

---
Source: https://selfhost.directory/project/dockproc