HQbird-Serverzustand
Server-Health in einer Minute
Jede Minute sammelt der Agent Daten über den Server, das OS, die Festplatten und die Firebird-Datenbanken. Alle 10 Minuten vergleicht er diese Daten mit Schwellenwerten und schreibt einen Status-Snapshot. Sie öffnen den Bericht und sehen sofort, was kaputtgegangen ist, wann und was zu tun ist.
- 1 Min. Server- und Datenbank-Metriken
- 10 Min. Status-Snapshot
- 18 Systeme im Bericht
- 24 h · 7 · 14 Tage Historie
- read-only Monitoring ändert nichts am Server
Szenario
Die Minute eines Administrators
Morgen. Die Benutzer sagen, dass letzte Nacht alles langsam war. Vier HQ Monitor-Bildschirme geben die Antwort, bevor Ihr Kaffee kalt wird.
server_status
Wie Daten gesammelt werden
Der Agent läuft auf dem Firebird-Server und liest Daten dort, wo sie sind: OS-Counter, cgroup und ETW, die MON$-Überwachungstabellen, Trace, firebird.log, Datenbank-Header und die Ergebnisse seiner eigenen Jobs. Kein separater Monitoring-Server und keine Agenten innerhalb der Datenbanken.
Alle 10 Minuten legt der Agent alles in einen Status-Snapshot. Jede Prüfung hat zwei Schwellenwerte: Warnung und ernst. Jeder Befund hat einen Schlüssel, einen Text und einen Hinweis. Ein neues Problem erscheint nach zwei Snapshots in Folge, also nach etwa 20 Minuten. Ein Notfall, zum Beispiel OOM oder Datenbankkorruption, erscheint sofort. Der Snapshot geht zusammen mit den anderen Daten an HQ Monitor.
- 1Sammelnjede Minute: CPU, Speicher, Festplatten, Verbindungen, Transaktionen
- 2Snapshotalle 10 Minuten, Durchschnitte und Spitzenwerte für 10 Minuten
- 3SchwellenwerteWarnung und ernst; in den Agent-Einstellungen festgelegt
- 4Befundwas gefunden wurde, wo, ein Hinweis, eine Aktionsschaltfläche
- 5✓ BerichtMatrix für 24 h, 7 oder 14 Tage; E-Mail von HQCenter
Schwere Jobs des Agenten selbst (Backup, Sweep, Datenbankprüfung, Festplattentest) sind in den Diagrammen markiert. Eine langsame Minute während eines Backups wird nicht als Benutzerproblem gezählt.
CPU · Speicher · Programme
Server und OS
Eine langsame Datenbank ist oft nicht die Schuld von Firebird. HQ Monitor zeigt nicht nur die Serverlast, sondern auch, wer sie erzeugt: Firebird, der Agent selbst oder andere Programme und Dienste.
| Was Sie sehen | Details | Standard-Schwellenwert |
|---|---|---|
| Firebird-Version und -Ordner | Der Versionsstring in der Serverliste; die Version und der Installationsordner im Dashboard. | — |
| CPU und Load Average | Jede Minute. CPU nach Programm für 10 Minuten: Firebird, der Agent, andere, kurzlebige Prozesse. | 80% · 97% |
| Speicher | Belegt, Swap, Speicherdruck (PSI unter Linux). Speicher nach Dienst (Linux) oder nach Programm (Windows), Dateicache, Kernel. | 80% · 96% |
| OOM und Swap | Nur Linux: vom OOM-Killer beendete Prozesse und aktiver Swap. | jedes OOM — ernst |
| Firebird im OS-Cache | Nur Linux, Kernel 6.5+: wie viel jeder Datenbankdatei im OS-Cache liegt und ob die Datei mit O_DIRECT geöffnet ist. | — |
| Firebird-Speicher und MON$ | Der Speicher des Firebird-Prozesses neben dem, was Firebird selbst in MON$MEMORY_USAGE zählt. | — |
| Dateisystem | Einmal täglich: Dateisystemtyp und Clustergröße für die Firebird-, Datenbank- und Agent-Ordner. | Befund mit dem Pfad |
TasksMax · NPROC · NOFILE · threads-max
OS-Limits: der Ausfall vor dem Ausfall
„Firebird ist unter Last abgestürzt“ bedeutet oft: Ein OS-Limit ist erschöpft. Firebird kann keinen Thread oder Prozess erstellen, neue Verbindungen schlagen fehl, und pthread_create failed erscheint in firebird.log.
Unter Linux vergleicht der Agent jede Minute jeden Firebird-Server mit den OS-Limits. Warnung ab 80% des Limits, ernst ab 95%, bezogen auf den Spitzenwert für 10 Minuten. Der Befund erscheint nach zwei Snapshots in Folge. Wenn ein Limit bereits die Erstellung eines Prozesses verweigert hat, ist dies sofort ernst, ohne Wartezeit.
Der Agent liest nur: Er ändert keine Limits, benötigt kein Root und ruft kein systemctl auf. Der Hinweis des Befunds liefert einen fertigen Befehl für den Administrator.
Ein Beispielfall: TasksMax = 4915, 3 Threads pro Verbindung. Classic startet einen Prozess für jede Verbindung, daher erreicht es zuerst TasksMax.
| Limit | Wo es gesetzt wird | Was passiert, wenn es erschöpft ist |
|---|---|---|
| Tasks des Firebird-Dienstes | TasksMax des Dienstes oder des übergeordneten Slice | Classic kann keine neue Verbindung annehmen |
| Tasks des Firebird-Benutzers | LimitNPROC, limits.d | Die Thread-Erstellung wird verweigert |
| Tasks des gesamten Hosts | kernel.threads-max, pid_max | Für alle Programme verweigert; threads-max wird beim Boot aus dem RAM berechnet |
| Offene Dateien | LimitNOFILE | SuperServer und SuperClassic erreichen dieses Limit zuerst |
| Speicher | Speicherlimit des Dienstes, RAM | Der OOM-Killer beendet den Prozess |
- Welche Ebene limitiertDer Dienst oder der übergeordnete Slice, zum Beispiel system.slice.
- Der eigene Anteil des AgentenSeine Tasks und seine untergeordneten gbak- und fbsvcmgr-Prozesse werden separat gezählt.
- Für ClassicThreads pro Verbindung und wie viele weitere Verbindungen das Limit noch erlaubt.
- Kein Befund, zur AnalyseTasks, die auf die Festplatte warten, und CPU-Zeit, die der Hypervisor beansprucht (Steal).
Speicherplatz · Temp · IO · Latenz
Festplatten
Der Agent kennt die Rolle jeder Festplatte: Sie enthält Datenbanken, Firebird-Temporärdateien oder den Installationsordner. Für diese Festplatten zählt er freien Speicherplatz, die Füllprognose, Lese- und Schreib-Latenz, IOPS und wer die Festplatte belastet.
- Freier SpeicherplatzWarnung unter 5 GB, kritisch unter 1 GB. Für jeden Ordner sehen Sie, auf welcher Festplatte er liegt.
- Füllstand in ProzentWarnung: Die Festplatte ist zu 90 % voll und weniger als 20 GiB sind frei. Kritisch: 97 % und weniger als 5 GiB. Beide Bedingungen müssen erfüllt sein, damit eine große Festplatte mit Reserve keinen Fehlalarm auslöst.
- Festplatte füllt sich schnellWarnung, wenn sich die Festplatte bei aktueller Geschwindigkeit in weniger als 6 Stunden füllt; kritisch, wenn in weniger als 2. Ein normales nächtliches Backup löst keinen Alarm aus. Der Befund nennt, wer in den letzten 10 Minuten auf die Festplatte geschrieben hat.
- Temporäre Dateien von FirebirdWie viele und wie groß, nach Typ: Sort, Blob, Undo, Lock. Warnung ab 10 GB, kritisch ab 50 GB. Sie sehen, ob Temp und die Datenbanken auf derselben Festplatte liegen.
- Performance-TestEinmal pro Woche nachts: INSERT, UPDATE und DELETE von einer Million Datensätzen in einer temporären Datenbank. Sie können die Ergebnisse verschiedener Wochen vergleichen.
- Latenz und IOPSJede Minute für Festplatten mit Datenbanken und Temp. Lesen: Warnung ab 20 ms, kritisch ab 50 ms. Schreiben: Warnung ab 10 ms, kritisch ab 30 ms. Durchschnitt über 10 Minuten, bei 10 IOPS oder mehr. Eine Festplatte nur mit Temp — nicht über Warnung.
- Festplatte voll: Eintrag in firebird.logEin „no space“-Fehler in
firebird.logergibt sofort kritisch und bleibt 24 Stunden bestehen. Der Befund nennt die Festplatte mit dem geringsten freien Speicherplatz. - Datenträgerbezeichnung unter WindowsDie Festplatte wird nach ihrem Buchstaben und Volume-Label benannt, zum Beispiel
b: (DATA, Disk 2, database), nicht nach der Volume-GUID.
Wenn Firebird weniger als 20 % der Lese- oder Schreibzugriffe auf die Festplatte ausmacht, belastet ein anderes Programm die Festplatte. Dann nennt der Hinweis des Befunds den wichtigsten „Nachbarn“ auf der Festplatte und den Anteil von Firebird. Der Agent schreibt den Hinweistext auf Englisch.
Wer die Festplatte belastet
Unter Linux nach systemd-Dienst, unter Windows nach Prozess. Die Firebird-Zeile ist hervorgehoben. Wenn Firebird wenig liest und schreibt, die Festplatte aber ausgelastet ist, ist ein Nachbarprogramm die Ursache: ein Antivirus, ein fremdes Backup, ein anderer Dienst. Unter Windows laufen Schreibzugriffe über den Systemcache, daher wird dort der Anteil von Firebird nur anhand der Lesezugriffe gezählt.
Header · LWM · MON$ · gstat
Datenbanken
Jede Datenbank auf dem Server hat ihre eigene Seite: Größe, Zustand, Sweep, Seitengröße, Dialekt, Eigentümer, ob sie eine eigene Security-DB hat. Vier Diagramme pro Minute: Verbindungen und Abfragen, Transaktionen, Seitenlese- und -schreibzugriffe, Query-Vorbereitung und -Ausführung.
Der Agent entnimmt den Zustand aus MON$DATABASE oder aus dem Datei-Header, je nachdem, welcher neuer ist: Shutdown, Read-only, Replica, nbackup-Sperre. Der Header kann ohne Verbindung gelesen werden. So ist auch eine Datenbank im Shutdown sichtbar, obwohl sie keine Verbindungen hat. Ein Klick auf eine Minute im Diagramm öffnet die schweren Abfragen aus dem Trace und alle Verbindungen dieser Minute.
Transaktionen: ein Signal vor der Verlangsamung
Next − OAT wächst, solange eine Transaktion lange offen bleibt. Datensatzversionen häufen sich an, und die Datenbank beginnt langsamer zu werden. Warnung bei einer Differenz von 4 Millionen, kritisch bei 8 Millionen. Die lange Transaktion ist in der Verbindungstabelle leicht zu finden. OST − OIT wächst, wenn die Garbage Collection nicht Schritt halten kann, zum Beispiel wenn ein Sweep nötig ist.
- MON$-MetrikenEinmal pro Stunde für aktive Datenbanken: Datensatzoperationen, Speicher nach Programm, die schwersten Verbindungen.
- Client-VersionenEinmal pro Tag: welche Client-Bibliotheken sich verbinden und wie viele Verbindungen jede hat.
- gstat mit AnalyseDie Anzahl kritischer Befunde und Warnungen für Tabellen und Indizes.
- Wachstumsprognose„+25 % in N Tagen“ für die am schnellsten wachsende Tabelle oder den Index; rot bei 30 Tagen oder weniger.
server_status
Server-Zustandsbericht
Zeilen sind Serversysteme, Spalten sind Zeit. Für 24 Stunden ist eine Zelle eine Stunde, für 7 Tage sind es 4 Stunden, für 14 Tage 6 Stunden. Eine Zelle zeigt die schlechteste Stufe für diesen Zeitraum. Rot ist kritisch, Orange ist Warnung, Grün ist OK. Ein Klick auf eine Zelle öffnet den Snapshot für diesen Moment.
Neu, schlimmer, verschwunden
Das Verlaufsfenster zeigt, wann ein Befund aufgetreten ist, schwerwiegender wurde und verschwand. Ein einmaliger Fehler im Log ist sofort sichtbar und bleibt eine Stunde bestehen, mit der Uhrzeit des Eintrags im Text.
Wie lange das Problem andauerte
Zeit in jeder Stufe und eine Tabelle der Probleme: Beginn, Ende, Dauer, System. „Noch aktiv“ ist sofort sichtbar.
Ursache, Hinweis, Schaltfläche
Der Befundtext nennt das Objekt: Festplatte, Ordner, Datenbank, Benutzer, Programm, Client-Version, Abfrage. Jeder Hinweis nennt eine Aktion. Daneben steht eine Schaltfläche: Backup-Aufgabe hinzufügen, Backup-Suchordner festlegen, eine Aufgabe oder eine Einstellung öffnen.
- 18 SystemeServer, CPU, Speicher, OS-Limits, Festplatten, Festplattengeschwindigkeit, firebird.log, Trace-Fehler, Transaktionen und GC, Sperren, Abfragen, Verbindungen, Indizes, Backups, fbagent-Jobs, Replikation, fbagent-Agent, Sicherheit und Lizenz. Gibt es weitere Befunde, erscheint eine Zeile „Andere Befunde“.
- Schwellen im DiagrammFür CPU, Speicher und Festplattengeschwindigkeit sehen Sie die Warn- und Kritisch-Linien.
- Tabellen in den PanelsFestplatten: Volumes und Temp-Ordner. Transaktionen: Datenbanken mit einer OIT/OAT-Differenz und lange Transaktionen mit Benutzer und Prozess. Replikation: Master und Replikate mit Lag. Agent: sein Zustand, Dateiwarteschlangen und Hauptjobs.
- Eine Karte für eine Gruppe von BefundenDrei oder mehr Befunde derselben Art und derselben Stufe werden als eine Karte angezeigt. Der Wert steht neben der Schwelle: „476,5 MiB / 1 GiB“.
- Fehler, Abfragen, BackupsHäufige Trace-Fehler, die langsamsten Abfragen mit einem Link zum Perf Report, eine Tabelle mit Backup-Befunden.
- DatenquellenFür jede Quelle: der Zustand und das Alter der Daten. Der Zustand ist auf Englisch, zum Beispiel stale oder missing. Eine veraltete oder fehlende Quelle wird hervorgehoben. Ein stiller Agent sieht nicht nach „alles in Ordnung“ aus.
- Was keinen Fehlalarm auslöstDie Verarbeitungswarteschlange des Agenten liegt nicht über der Warnschwelle. Ein gestoppter Firebird macht den Zustand des Agenten selbst nicht ernst: Das ist ein separater Befund.
- Schlagzeile auf dem DashboardNeben dem Symbol „Serverstatus“ steht eine Zeile: der wichtigste Befund und die Systeme mit Befunden. Ein Klick öffnet diesen Bericht.
← Zurück zur Übersicht von HQbird 2027 · Backups im Detail →