Welcome to Monitoring Hub¶

The definitive Software Factory for Prometheus Exporters.

🎯 Project Goal¶

Monitoring Hub is an automated Software Factory that transforms simple YAML manifests into production-ready monitoring tools. It focuses on Enterprise Standards, Multi-Architecture support, and Full Automation.

🚀 Key Features¶

• Native Multi-Arch: Every tool is built for x86_64 and aarch64 (ARM64)
• Multi-Format Packages: RPM (RHEL/CentOS/Rocky/Alma), DEB (Ubuntu/Debian), and OCI containers
• GPG-Signed Packages: All RPM and DEB packages are cryptographically signed for integrity
• Hardened Security: All Docker images use Red Hat UBI 9 Minimal with Trivy scanning
• Linux Standard (FHS): Packages include system users, standard paths, and systemd integration
• Zero-Click Updates: Automated watcher opens PRs and merges when tests pass
• Always Up-to-Date: Never worry about upstream releases again

📦 What's Included¶

The factory currently builds and maintains 30+ Prometheus exporters, including:

• System Monitoring: node_exporter, process_exporter, systemd_exporter
• Database: postgres_exporter, mysql_exporter, mongodb_exporter, redis_exporter
• Web Services: nginx_exporter, apache_exporter, blackbox_exporter
• Storage: ceph_exporter, ipmi_exporter, smartctl_exporter
• Messaging: kafka_exporter, rabbitmq_exporter, nats_exporter
• And many more...

Browse the complete catalog →

📚 Quick Links¶

🏭 How It Works¶

graph LR
    A[YAML Manifest] --> B[Builder]
    B --> C[RPM Packages]
    B --> D[Docker Images]
    C --> E[YUM Repository]
    D --> F[GHCR Registry]
    E --> G[Production]
    F --> G

1. Define: Create a simple YAML manifest describing the exporter
2. Build: Automated CI builds RPM and Docker artifacts
3. Distribute: Packages are published to YUM repo and GHCR
4. Update: Watcher monitors upstream and auto-updates

📋 Distribution¶

YUM Repository (RPM)¶

# Add GPG key
sudo rpm --import https://sckyzo.github.io/monitoring-hub/RPM-GPG-KEY-monitoring-hub

# Configure repository
sudo dnf config-manager --add-repo https://sckyzo.github.io/monitoring-hub/el9/$(arch)/

# Install any exporter
sudo dnf install node_exporter

# Enable and start
sudo systemctl enable --now node_exporter

APT Repository (DEB)¶

# Add GPG key
curl -fsSL https://sckyzo.github.io/monitoring-hub/apt/monitoring-hub.asc | \
  sudo gpg --dearmor -o /usr/share/keyrings/monitoring-hub.gpg

# Add repository (Ubuntu 22.04 "jammy" example)
echo "deb [signed-by=/usr/share/keyrings/monitoring-hub.gpg] \
  https://sckyzo.github.io/monitoring-hub/apt jammy main" | \
  sudo tee /etc/apt/sources.list.d/monitoring-hub.list

# Install any exporter
sudo apt update && sudo apt install node-exporter

# Enable and start
sudo systemctl enable --now node_exporter

Container Registry (Docker)¶

# Pull any exporter
docker pull ghcr.io/sckyzo/monitoring-hub/node_exporter:latest

# Run
docker run -d -p 9100:9100 ghcr.io/sckyzo/monitoring-hub/node_exporter:latest

🤝 Contributing¶

We welcome contributions! Check out our Contributing Guide to get started.

📄 License¶

Distributed under the MIT License. See LICENSE for more information.