← Zurück zu Downloads

Log-Collector

Der Black-Box-Flugschreiber für Ihre Flotte — Metriken und Log-Bündel von jedem Docker-Host.

Was der Log-Collector tut

Der Log-Collector läuft als kleiner Container neben Ihrer Anwendung und schickt fortlaufend Diagnosedaten an den FleetManager — damit bei einer Störung aussagekräftige Daten zentral vorliegen, bevor ein Gerät offline geht.

  • Host-Metriken: CPU, Last, RAM, Festplatte und Container-Status (~alle 90 s).
  • Log-Bündel: komprimierte Docker-Container-Logs + Host-Diagnose, in resumierbaren Chunks hochgeladen.
  • Ausfallsicher: Logs werden laufend auf ein Volume gespiegelt — ein nach einem Absturz erstelltes Bündel enthält die Logs von vor dem Ausfall.
  • Auf Knopfdruck: „Logs jetzt sammeln" direkt im Dashboard.

Voraussetzungen

  • Beliebiger Linux-Host mit Docker und Docker Compose
  • Ein Ingest-Token (fmt_…) aus Ihrem FleetManager
  • Wenige hundert MB freier Plattenplatz für den Bündel-Spool

1. Fleet-Konfiguration anlegen

Erstellen Sie eine config.json mit Ihrer Fleet-Identität:

{
  "fleetmanagement": {
    "base_url": "https://fleet.brinkhaus-gmbh.de",
    "customer_name": "ihr-kunden-slug",
    "machine": "ihr-maschinen-name",
    "token": "fmt_IHR_INGEST_TOKEN",
    "heartbeat_interval_sec": 60
  }
}

2. Docker Compose einrichten

Erstellen Sie eine docker-compose.yml. Der Collector spricht ausschließlich mit dem schreibgeschützten docker-socket-proxy — nie mit dem rohen Docker-Socket: 

services:
  docker-socket-proxy:
    image: tecnativa/docker-socket-proxy:0.3.0
    restart: always
    environment:
      CONTAINERS: 1
      INFO: 1
      EVENTS: 1
      POST: 0
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

  logcollector:
    image: brinkhausgmbh/fleetmanager-logcollector:latest
    restart: always
    depends_on:
      - docker-socket-proxy
    environment:
      DOCKER_PROXY_URL: tcp://docker-socket-proxy:2375
      METRICS_DISK_PATH: /host-root
      SPOOL_DIR: /spool
    volumes:
      - ./config.json:/app/fleetManagementData/config.json:ro
      - logcollector-spool:/spool
      - /:/host-root:ro
    cpus: 0.50
    mem_limit: 256m

volumes:
  logcollector-spool:

3. Starten und prüfen

# Stack starten
docker compose up -d

# Logs prüfen
docker compose logs -f logcollector

Innerhalb einer Minute erscheint die Maschine im Dashboard — mit einem Ressourcen-Tab (Metriken) und einem Artefakte-Tab (Log-Bündel).

Sicherheit

Der Collector mountet niemals den rohen /var/run/docker.sock. Der gesamte Docker-Zugriff läuft über den schreibgeschützten docker-socket-proxy (CONTAINERS/INFO/EVENTS=1, POST=0). Der Container läuft als unprivilegierter Benutzer; der Spool ist nach oben begrenzt und kann die Platte nie füllen.

Docker-Image

Das offizielle Image wird auf Docker Hub veröffentlicht:

docker pull brinkhausgmbh/fleetmanager-logcollector:latest

# Oder eine spezifische Version:
docker pull brinkhausgmbh/fleetmanager-logcollector:0.2.0

Verfügbare Tags: :latest, :X.Y.Z, :X.Y, :X

Changelog

0.2.0 2026-06-02

Hinzugefügt

  • Eigenständiges, kundeneinsetzbares Modul mit eigenem Docker-Image (brinkhausgmbh/fleetmanager-logcollector) — läuft auf jedem Docker-Host
  • Tier-2 Log-Bündel: komprimierte tar.zst-Snapshots der Container-Logs + Host-Diagnose (df, ps, /proc, docker inspect), per resumierbarem Chunk-Upload
  • Kontinuierliches Log-Mirroring auf ein Host-Volume — Bündel überleben ein Container-Update/-Neustart und enthalten die Logs von vor dem Ausfall
  • On-Demand: Schaltfläche "Logs jetzt sammeln" im Dashboard
  • Ereignisgesteuert: ein Container-Absturz/OOM löst sofort ein Bündel aus
  • Tier-1-Metriken um eine Container-Übersicht (laufend/gesamt/Status) erweitert

Sicherheit

  • Kein direkter Zugriff auf docker.sock — ausschließlich über einen schreibgeschützten docker-socket-proxy (POST=0). Läuft als Non-Root-Benutzer.
0.1.0 2026-06-01

Hinzugefügt

  • Erste Stufe: Host-Metriken (CPU/RAM/Festplatte) per psutil unter dem Software-Slug "logcollector"

Kostenlos starten — 5 Geräte inklusive

Fleet Monitoring und Security Compliance in unter 10 Minuten. Keine Kreditkarte nötig.

Kostenlos starten Live-Demo buchen

Sie möchten mit einem Fachmann sprechen?

Klicken Sie den Link und wir kommen kurz ins Gespräch.

Termin vereinbaren →