NAME

zerodds-monitor - live snapshot or Prometheus /metrics server for the ZeroDDS runtime

SYNOPSIS

zerodds-monitor snapshot [-d DOMAIN] [--duration DUR] [-f FORMAT]

zerodds-monitor serve [-d DOMAIN] [-a ADDR] [--duration DUR]

zerodds-monitor names

DESCRIPTION

zerodds-monitor starts a DCPS runtime and exposes the process-global metric registry either as a one-shot snapshot or via HTTP for Prometheus scraping.

snapshot collects metrics for --duration (default 5s) then prints the registry contents in text or prometheus format.

serve runs the registry as a /metrics HTTP endpoint on --addr (default 127.0.0.1:9991) until SIGINT or --duration elapses.

names prints the canonical list of known ZeroDDS metric names.

OPTIONS

-d, --domain ID: DDS Domain ID. Default: 0.
--duration DUR: Run duration: 5, 30s, 2m, 1h.
-f, --format FORMAT: Output format for snapshot : text (default) or prometheus.
-a, --addr ADDR: Listen address for serve. Default 127.0.0.1:9991.
--config PATH: The base configuration file; its sibling PATH.d/ holds drop-ins. Default: the system configuration directory (/etc/zerodds on Linux, /usr/local/etc/zerodds on macOS).
--set PATH=VALUE: One setting above every file, repeatable; +PATH=VALUE appends to a list.
--check-config: Validate and print the effective configuration with the origin of every value, then exit: 0 valid, 1 invalid value or unknown key, 2 unreadable file, syntax error or include cycle.

EXIT STATUS

0: Success.
2: CLI parse error.
3: DDS or I/O error.

AUTHORS

ZeroDDS Contributors <release@zerodds.org>

BEZEICHNUNG

zerodds-monitor - Live-Schnappschuss oder Prometheus-/metrics-Server für die ZeroDDS-Laufzeitumgebung

ÜBERSICHT

zerodds-monitor snapshot [-d DOMÄNE] [--duration DAUER] [-f FORMAT]

zerodds-monitor serve [-d DOMÄNE] [-a ADR] [--duration DAUER]

zerodds-monitor names

BESCHREIBUNG

zerodds-monitor startet eine DCPS-Laufzeitumgebung und stellt die prozessweite Metrik-Registry bereit, entweder als einmaligen Schnappschuss oder über HTTP zum Abruf durch Prometheus.

snapshot sammelt Metriken für die Dauer von --duration (Standard 5s) und gibt dann den Inhalt der Registry im Format text oder prometheus aus.

serve stellt die Registry als HTTP-Endpunkt /metrics auf --addr bereit (Standard 127.0.0.1:9991), bis SIGINT kommt oder --duration abgelaufen ist.

names gibt die kanonische Liste der bekannten ZeroDDS-Metriknamen aus.

OPTIONEN

-d, --domain ID: DDS-Domain-ID. Standard: 0.
--duration DAUER: Laufzeit: 5, 30s, 2m, 1h.
-f, --format FORMAT: Ausgabeformat für snapshot: text (Standard) oder prometheus.
-a, --addr ADR: Listen-Adresse für serve. Standard 127.0.0.1:9991.
--config PFAD: Die Basis-Konfigurationsdatei; das danebenliegende PFAD.d/ enthält Drop-ins. Standard: das System-Konfigurationsverzeichnis (/etc/zerodds unter Linux, /usr/local/etc/zerodds unter macOS).
--set PFAD=WERT: Eine Einstellung über allen Dateien, wiederholbar; +PFAD=WERT hängt an eine Liste an.
--check-config: Prüft die wirksame Konfiguration und gibt sie mit der Herkunft jedes Werts aus, dann Ende: 0 gültig, 1 ungültiger Wert oder unbekannter Schlüssel, 2 nicht lesbare Datei, Syntaxfehler oder Include-Zyklus.

EXIT-STATUS

0: Erfolg.
2: Fehler beim Parsen der Kommandozeile.
3: DDS- oder E/A-Fehler.

SIEHE AUCH

zerodds-bench(1), zerodds-spy(1), zerodds-snitch(1)

AUTOREN