Diese Seite beschreibt Calíope 1.5, die Version, die ich gerade baue. Die 1.4 ist im App Store für Mac, iPad, iPhone, Apple Watch, Apple TV und Apple Vision Pro. Das Changelog sagt, in welcher Version jede Funktion kam.
Fügt jedem Thema einen Button „In Calíope öffnen“ hinzu. Funktioniert nur mit installierter App.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
Klicke in der Navigationsleiste des Arbeitsbereichs auf Dashboard. Das Dashboard zeigt automatisch aktualisierte Servermetriken: aktive Verbindungen, Threads, Laufzeit und Übertragungsraten.
Intervall: Die Auswahl in der Kopfzeile bestimmt, wie oft der Serverstatus abgefragt wird (1, 2, 5, 10 oder 30 Sekunden); daneben steht, wann die letzte Messung eintraf. Datenbankgrößen und Prozessliste sind aufwendiger zu berechnen und werden unabhängig davon alle 100 Sekunden aktualisiert.
Werte pro Sekunde werden aus der tatsächlich verstrichenen Zeit zwischen zwei Messungen berechnet; ein anderes Intervall ändert ihre Skala also nicht.
Stichwörter: dashboard, überwachung, monitor, echtzeit, metriken, status
Visualisiere den Netzwerkverkehr und die Rate der Queries pro Sekunde.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
MySQLMariaDBAurora
Das Dashboard enthält Liniendiagramme für Gesendete Bytes/s, Empfangene Bytes/s und Queries/s (QPS).
SQL Server
Das Dashboard enthält ein Liniendiagramm für Queries/s, das die Batches zählt, die der Server empfängt (Batch Requests/sec). Der Server meldet keine gesendeten und empfangenen Bytes, deshalb werden diese Karten nicht gezeichnet.
PostgreSQL
Das Dashboard enthält ein Liniendiagramm für Transaktionen/s: Commits plus Rollbacks aus pg_stat_database. Der Server meldet weder Anweisungen noch gesendete und empfangene Bytes, deshalb werden diese Karten nicht gezeichnet.
Die Diagramme werden in Echtzeit mit einem Verlauf der zuletzt gemessenen Punkte aktualisiert.
Stichwörter: qps, datenverkehr, bytes, netzwerk, queries per second
Kreisdiagramme für Verbindungen, Cache-Speicher und Speicherplatz pro DB.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
Die Kreisdiagramme (pie charts) des Dashboards zeigen die Verteilung der Verbindungen pro Benutzer, die Größe jeder Datenbank, den Cache-Speicher (Buffer-Pool, Log-Buffer usw.) auf Servern, die diese Aufschlüsselung veröffentlichen und die Verteilung der Threads (running/sleeping/waiting).
Stichwörter: pie chart, cache, innodb, speicher, verteilung, threads
Wo es zu finden ist: Dashboard › Layout-Schaltfläche
Die Layout-Schaltfläche in der Kopfzeile des Dashboards wechselt zwischen der 2-Spalten-Anordnung (breiter) und der 3-Spalten-Anordnung (kompakter). Nützlich, um die Ansicht an die Fenstergröße anzupassen.
Zusätzliche Karten: langsame Queries, abgebrochene Verbindungen, Datencache und Sperren.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
MySQLMariaDBAurora
Neben den Diagrammen für Datenverkehr und QPS enthält das Dashboard Liniendiagramm-Karten für:
- Langsame Queries/s — Rate der Queries, die den Schwellenwert long_query_time überschritten haben
- Abgebrochene Verbindungen/s — abgewiesene oder anormal unterbrochene Verbindungen
- Datencache (%) — Prozentsatz der Lesevorgänge, die ohne Festplattenzugriff aus dem Cache des Servers bedient werden. Nicht sein Füllstand
- Tabellen-Locks — Anzahl der Male, die eine Query auf eine Tabellensperre warten musste
SQL Server
Neben Queries/s zeichnet das Dashboard Tabellen-Locks: die Sperrwartezeiten pro Sekunde (Lock Waits/sec). Der Server meldet weder langsame Queries noch abgebrochene Verbindungen, deshalb werden diese Karten nicht gezeichnet.
PostgreSQL
Der Server meldet weder langsame Queries noch abgebrochene Verbindungen noch Sperrwartezeiten, deshalb werden diese Karten nicht gezeichnet: Transaktionen/s ist die einzige Liniendiagramm-Karte.
Datencache in der Kopfzeile ist in jeder Engine der Prozentsatz der Lesevorgänge, die ohne Festplattenzugriff aus dem Cache des Servers bedient werden. Diese Metriken werden im selben Takt wie der Rest des Dashboards aktualisiert.
Das Dashboard erzeugt Warnungen, wenn abgebrochene Verbindungen oder Sperren die Schwellenwerte überschreiten.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
Calíope überwacht den Server auf zwei Arten.
In der Kopfzeile, bei jeder Aktualisierung des Dashboards: Ein Banner erscheint, wenn der Datencache unter 90 % fällt, wenn es Abgebrochene Verbindungen gibt oder wenn die Tabellen-Locks über eine halbe Wartezeit pro Sekunde steigen. Es nennt die Metrik und ihren Wert und verschwindet von selbst, wenn der Wert wieder normal ist. Eine Metrik, die der Server nicht meldet, löst es nie aus.
Als Systemmitteilungen: Die Glocke in der Kopfzeile öffnet Server-Warnungen, wo du sie aktivierst und die Schwellenwerte für die Verbindungen im Verhältnis zum Servermaximum und für die Cache-Trefferquote festlegst. Dieselbe Warnung wiederholt sich frühestens nach 5 Minuten.
MySQLMariaDBAurora
Dort liegt auch der Schwellenwert für die Replikationsverzögerung, der vom Replikations-Monitor ausgewertet wird.
Vergrößere eine einzelne Karte, um sie im Detail zu sehen.
Wo es zu finden ist: Dashboard › Klick auf Karte
Doppelklick auf eine beliebige Karte des Dashboards (auf dem iPad doppelt tippen), um sie im Zoom-Modus zu erweitern. Die Karte wird im Dashboard bildschirmfüllend mit erweitertem Datenverlauf angezeigt. Drück Alle Diagramme oder, unter macOS, Esc, um zur normalen Ansicht aller Karten zurückzukehren.
Ordne die Karten des Dashboards neu an oder blende sie aus; das Layout wird per iCloud synchronisiert.
Wo es zu finden ist: Dashboard › Anpassen-Schaltfläche (Slider)
Im Dashboard lassen sich Reihenfolge und Sichtbarkeit der Karten anpassen. Aktiviere den Anpassungsmodus mit der ☰-Schaltfläche (Schieberegler) in der Kopfzeile.
Per Ziehen umsortieren: Ziehe eine Karte auf eine andere; die gezogene Karte übernimmt deren Position, die übrigen verschieben sich. Während des Ziehens wird die Zielkarte hervorgehoben. Unter macOS mit der Maus; auf dem iPad die Karte gedrückt halten und ziehen.
Ohne Ziehen umsortieren: Jede Karte zeigt unten links zwei Pfeile, die sie eine Position nach links oder rechts verschieben. Das ist der Weg für Tastatur und VoiceOver, wo Ziehen nicht verfügbar ist.
Ausblenden: Im Anpassungsmodus zeigt jede Karte oben rechts eine Schaltfläche mit durchgestrichenem Auge. Sie verschiebt die Karte in den Bereich Ausgeblendete Karten unter dem Raster. Tippe eine ausgeblendete Karte an, um sie zurückzuholen.
Zurücksetzen: Die Schaltfläche mit dem Kreispfeil stellt die Standardreihenfolge wieder her und zeigt alle Karten. Sie fragt vorher nach.
Synchronisierung: Das Layout wird pro iCloud-Konto gespeichert. Mit aktivierter iCloud-Synchronisierung in den Einstellungen werden Reihenfolge und ausgeblendete Karten zwischen Mac, iPad und iPhone übernommen. Ohne iCloud bleibt es lokal.
Solange der Anpassungsmodus aktiv ist, ist der Doppelklick zum Zoomen deaktiviert; verlasse den Modus (dieselbe Schaltfläche, jetzt mit Häkchen), um wieder zu zoomen.
Diagramme im Vollbild, ohne Leisten und Menüs, um das Dashboard stehen zu lassen.
Wo es zu finden ist: Dashboard › TV-Modus-Schaltfläche (Fernseher)
Die Fernseher-Schaltfläche in der Kopfzeile des Dashboards gibt den Diagrammen den ganzen Bildschirm: Werkzeug-Kopfzeile, Seitenleiste, Tab-Leiste und Statusleiste werden entfernt. Gedacht ist das dafür, das Dashboard auf einem Bildschirm stehen zu lassen und aus der Entfernung zu lesen – die Spaltenzahl ergibt sich aus der verfügbaren Breite, und die Diagramme wachsen mit.
Beenden: Unter macOS Esc drücken. Auf dem iPad irgendwo tippen; dann erscheint oben eine Leiste mit Schließen-Schaltfläche, und auch die Esc-Taste einer externen Tastatur funktioniert. Ein Tippen beendet den Modus nicht direkt, damit Abwischen oder Streifen des Bildschirms ihn nicht unterbricht.
Die obere Leiste verbirgt sich nach wenigen Sekunden von selbst und zeigt Servernamen und Zeitpunkt der letzten Messung.
Bildschirm bleibt an: Im TV-Modus schaltet sich der Bildschirm nicht wegen Inaktivität ab. Das ist unabhängig von der Schaltfläche «Aktiv halten» in der Symbolleiste: Betreten und Verlassen des TV-Modus ändert diese Einstellung nicht.
Der TV-Modus lässt sich nicht mit dem Zoom einer einzelnen Karte oder dem Anpassungsmodus verbinden; beim Betreten werden beide beendet.
Stichwörter: tv-modus, vollbild, kiosk, ablenkungsfrei, esc, beenden, bildschirm an
Erhalte Systembenachrichtigungen, wenn der Server konfigurierbare Schwellen für Verbindungen, Cache-Trefferrate oder Replikations-Lag überschreitet.
Wo es zu finden ist: Dashboard › Warnungen (Glocke)
Calíope kann dir Systembenachrichtigungen senden, wenn es kritische Bedingungen auf dem verbundenen Server erkennt.
So konfigurierst du die Warnungen:
1. Öffne das Dashboard über die Seitenleiste Werkzeuge.
2. Klick auf das Glocken-Symbol in der oberen Leiste des Dashboards.
3. Aktiviere den Schalter System-Warnungen aktivieren. Beim ersten Mal fragt das System um Erlaubnis, Benachrichtigungen zu senden; akzeptiere sie.
4. Passe die Schwellen an deine Umgebung an:
- Maximale Verbindungen (%) — Prozentsatz der Verbindungsauslastung im Verhältnis zum auf dem Server konfigurierten Maximum. Standard: 80%. Nützlich, um Verbindungsspitzen zu erkennen, bevor der Server saturiert wird.
- Minimale Cache-Trefferrate (%) — warnt, wenn der Prozentsatz der aus dem Cache bedienten Lesevorgänge unter diesen Wert fällt. Standard: 95%. Ein niedriger Wert deutet darauf hin, dass der Buffer Pool für die Arbeitslast nicht ausreicht.
- Replikations-Lag (Sek.) — maximal tolerierte Verzögerung in Sekunden auf der Replik. Standard: 30 s. Gilt nur, wenn der Server als Replik konfiguriert ist.
Verhalten der Benachrichtigungen:
- Die Benachrichtigungen werden als Systembenachrichtigungen gesendet.
- Es gibt ein Abkühlungsintervall (Cooldown) von 5 Minuten zwischen Benachrichtigungen desselben Typs, um Spam zu vermeiden, wenn die Bedingung anhält.
- Die Warnungen werden in jedem Aktualisierungszyklus des Dashboards ausgewertet, solange dieses geöffnet ist.
Berechtigungen:
Wenn du die Benachrichtigungsberechtigung abgelehnt hast, kannst du sie zurücksetzen unter:
- macOS: Systemeinstellungen › Mitteilungen & Fokus › Calíope.
- iPad: Einstellungen › Mitteilungen › Calíope.
Stichwörter: Warnungen, Benachrichtigungen, Verbindungen, Cache, InnoDB, Hit Rate, Replik, Lag, Schwellen, Glocke, Buffer Pool, Cooldown, 5 Minuten