Stat-Helper

Simple terminal monitoring for Kubernetes & Docker

stat-helper.sh
$ ./stat-helper.sh
┌──────────────────────────────────────────────────────────────────┐
│           Kubernetes & Docker Monitoring Tool                    │
├──────────────────────────────────────────────────────────────────┤
│ Date:                                      2025-05-13 10:42:15   │
│ User:                                      admin                 │
│ Host:                                      workstation           │
├──────────────────────────────────────────────────────────────────┤
│           Developed by Juni-Crypto @ ChumaoruWorks Club          │
│               https://github.com/Juni-crypto                     │
├──────────────────────────────────────────────────────────────────┤
│                         System Status                            │
│ Kubernetes:             ● Active (v1.27.3)                       │
│ Docker:                 ● Active (v24.0.5)                       │
│ Host Resources:         CPU: 32%  MEM: 47%  DISK: 23%            │
└──────────────────────────────────────────────────────────────────┘

$ _
stat-helper.sh --kubernetes
$ ./stat-helper.sh --kubernetes
┌──────────────────────────────────────────────────────────────────┐
│                    KUBERNETES DASHBOARD                          │
├──────────────────────────────────────────────────────────────────┤
│ NAMESPACE    NAME                     READY     STATUS           │
├──────────────────────────────────────────────────────────────────┤
│ default      web-app-84f8d48b6c-j6mgz 1/1      Running          │
│ default      db-56468d7d5c-vz9j9     1/1      Running          │
│ monitoring   prometheus-5bc6c67877-k 1/1      Running          │
│ kube-system  coredns-59b4f5bbd5-trfk 1/1      Running          │
│ kube-system  etcd-master              1/1      Running          │
├──────────────────────────────────────────────────────────────────┤
│ RESOURCE UTILIZATION                                             │
├──────────────────────────────────────────────────────────────────┤
│ Cluster CPU:    [#########.................] 45%                 │
│ Cluster Memory: [############..............] 58%                 │
│ Pod Count:      12/50                                            │
└──────────────────────────────────────────────────────────────────┘

$ _
stat-helper.sh --docker
$ ./stat-helper.sh --docker
┌──────────────────────────────────────────────────────────────────┐
│                     DOCKER CONTAINERS                            │
├──────────────────────────────────────────────────────────────────┤
│ CONTAINER ID    NAME               STATUS     CPU     MEM        │
├──────────────────────────────────────────────────────────────────┤
│ f8d3e1a92c7b    web-server         Up      0.5%    124MB      │
│ a2c6e73f91d4    postgres-db        Up      1.2%    356MB      │
│ c9b12f854e32    redis-cache        Up      0.3%    42MB       │
│ e5f7d8a1b69c    nginx-proxy        Up      0.1%    12MB       │
├──────────────────────────────────────────────────────────────────┤
│ RESOURCES                                                        │
├──────────────────────────────────────────────────────────────────┤
│ CPU Usage:    [######...................] 29%                    │
│ Memory Usage: [########.................] 37%                    │
│ Disk Usage:   [#####....................] 23%                    │
└──────────────────────────────────────────────────────────────────┘

$ _

What It Does

Kubernetes Monitoring

Real-time monitoring of pods, services, deployments and node health

Docker Management

Track container status, resource usage and performance metrics

Terminal-Based UI

Clean, lightweight interface that works in any terminal

Why Terminal-Based Tools Excel

Modern DevOps demands efficiency and simplicity. Terminal-based monitoring provides:

  • Lightweight: Minimal resource footprint compared to heavy web dashboards, keeping your system resources free
  • Security-focused: No additional services or ports exposed, reducing your attack surface significantly
  • Lightning-fast: Instant access to critical information without browser loading times
  • Remote-friendly: Works seamlessly over SSH connections even on low-bandwidth networks
  • Automation-ready: Easy integration with scripts and CI/CD pipelines
  • Server-efficient: Perfect for headless servers where GUI tools aren't practical

Install in seconds

Terminal
$ git clone https://github.com/Juni-crypto/stat-helper.git
Cloning into 'stat-helper'...
remote: Enumerating objects: 52, done.
remote: Counting objects: 100% (52/52), done.
remote: Compressing objects: 100% (38/38), done.
remote: Total 52 (delta 14), reused 52 (delta 14)
Receiving objects: 100% (52/52), 24.6 kb, done.

$ cd stat-helper

$ chmod +x stat-helper.sh

$ ./stat-helper.sh
Loading Stat-Helper...
Checking dependencies...
Starting monitoring services...


                        

Prerequisites

Bash kubectl Docker