Monitoringsystem für die gesamte Netzwerktechnik

Python 46.5%
JavaScript 39.5%
CSS 8.3%
HTML 4.6%
PowerShell 0.5%
Other 0.6%

Find a file

simon 75dd7a3b94 Refine Synology NAS telemetry metrics		2026-05-29 22:51:21 +02:00
agents/server-telemetry	Keep status online after inventory check	2026-05-17 21:24:40 +02:00
apps	Refine Synology NAS telemetry metrics	2026-05-29 22:51:21 +02:00
docker	Add Synology NAS SSH telemetry collector	2026-05-29 17:01:45 +02:00
docs	Refine Synology NAS telemetry metrics	2026-05-29 22:51:21 +02:00
webroot	Refine Synology NAS telemetry metrics	2026-05-29 22:51:21 +02:00
zugang	Add SSH tunnel access scripts	2026-05-15 00:04:26 +02:00
.env.example	Refine Synology NAS telemetry metrics	2026-05-29 22:51:21 +02:00
.gitignore	Refresh dashboard branding and charts	2026-05-16 20:26:57 +02:00
CODEX.md	Document Codex handoff notes	2026-05-16 21:03:56 +02:00
CODEX_SERVER_AGENT_INSTALL_PROMPT.md	Update install prompt and add backup page	2026-05-17 21:04:08 +02:00
Instruction.md	Add bilingual UI support	2026-05-15 00:23:57 +02:00
README.md	Add MQTT server telemetry agent	2026-05-15 23:24:57 +02:00

README.md

infrastat

infrastat ist der zentrale Telemetry-Hub auf Zeus. Server senden Messwerte per MQTT an Mosquitto; der Backend-Service liest diese Nachrichten, speichert sie in PostgreSQL und stellt eine Web-API fuer die Nginx-Weboberflaeche bereit.

Forgejo

Geplanter Repository-Ursprung:

ssh://git@10.10.5.9:2222/infra/infrastat.git

Forgejo Web:

http://10.10.5.9:3002/

Serverpfad

/opt/projects/infrastat
├── test
└── live

Test und Live sind getrennte Deployments desselben Projekts. Secrets, Datenbank, Ports, Logs, Backups und Laufzeitdaten sind pro Umgebung getrennt.

Container

nginx       Webserver und Reverse Proxy
app         Telemetry-Ingestor und API
mqtt        Eclipse Mosquitto MQTT Broker
db          PostgreSQL

Grafana wird bewusst nicht verwendet.

Ports

TEST:
Web:  127.0.0.1:8081
MQTT: 127.0.0.1:1884
DB:   nur internes Docker-Netz

LIVE:
Web:  0.0.0.0:80
MQTT: 0.0.0.0:1883
DB:   nur internes Docker-Netz

Befehle

Test starten:

cd /opt/projects/infrastat/test
docker compose --env-file secrets/.env -f docker/compose.yml up -d

Test Status:

cd /opt/projects/infrastat/test
docker compose --env-file secrets/.env -f docker/compose.yml ps

Test Logs:

cd /opt/projects/infrastat/test
docker compose --env-file secrets/.env -f docker/compose.yml logs -f

Test stoppen:

cd /opt/projects/infrastat/test
docker compose --env-file secrets/.env -f docker/compose.yml down

Live verwendet dieselben Befehle unter:

/opt/projects/infrastat/live

Server-Agent

Der wiederverwendbare Agent fuer ueberwachte Server liegt hier:

agents/server-telemetry/

Er laeuft auf Zielservern als systemd-Dienst und sendet Status- und Telemetrie-Nachrichten an den zentralen MQTT-Broker.

Weitere Details:

docs/topics.md
docs/server-agent.md

Secrets

Produktive Werte liegen nicht im Repository:

secrets/.env
secrets/mosquitto.passwd
secrets/mosquitto.acl

Im Repository liegt nur:

.env.example

Backup

Pro Umgebung sichern:

secrets/.env
secrets/mosquitto.passwd
secrets/mosquitto.acl
docker/compose.yml
apps/mosquitto/config/
db/
data/
logs/ bei Bedarf

Der Anwendungscode kann aus Forgejo wiederhergestellt werden, sobald das Repository initial gepusht ist.