Diese Seite beschreibt Calíope 1.7, die Version, die ich gerade baue. Die 1.6 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.
Oracle
Bei Oracle ergänzt die Kopfzeile Vollster Speicher: den am stärksten belegten Tablespace, in Prozent seiner Maximalgröße einschließlich automatischer Erweiterung (DBA_TABLESPACE_USAGE_METRICS). Ein Benutzer ohne Recht auf die V$-Views kann die Messung nicht lesen: Kopfzeile und jede Karte nennen den Grund des Servers, statt auf eine erste Messung zu warten, die nie kommt.
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.
ClickHouse
Das Dashboard enthält Liniendiagramme für Gesendete Bytes/s, Empfangene Bytes/s und Queries/s (QPS), aus den Zählern NetworkSendBytes, NetworkReceiveBytes und Query des Servers.
Oracle
Das Dashboard enthält Liniendiagramme für Gesendete Bytes/s, Empfangene Bytes/s und Queries/s (QPS), aus den Statistiken bytes sent via SQL*Net to client, bytes received via SQL*Net from client und execute count in V$SYSSTAT. Ein Benutzer ohne Leserecht auf die V$-Views erhält keinen einzigen Zähler, und das Dashboard sagt das, statt Nullen zu zeichnen.
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 des Dashboards zeigen die Verbindungen pro Benutzer und die Größe jeder Datenbank (die acht größten, ohne die des Systems), den Speicher (den Datencache, aufgeteilt in saubere Daten, Dirty Data und frei auf Servern, die diese Aufschlüsselung veröffentlichen, oder in belegt und frei, wo der Server seinen Gesamtspeicher veröffentlicht) und die Threads (aktiv, schlafend und, wo der Server sie veröffentlicht, im Cache). Benutzer und Größen werden alle 100 Sekunden aktualisiert.
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: die Liniendiagramm-Karten sind Transaktionen/s und Datencache (%), berechnet aus den aus dem Cache gelesenen Blöcken gegenüber den von der Festplatte gelesenen in pg_stat_database.
ClickHouse
Der Server zählt weder langsame Queries noch abgebrochene Verbindungen noch Sperrwartezeiten, und er hat keinen Seiten-Cache, dessen Trefferquote sich messen ließe, deshalb werden diese Karten nicht gezeichnet. Das Speicherdiagramm zeigt, was der Server gegenüber seiner Obergrenze max_server_memory_usage belegt.
Oracle
Oracle veröffentlicht langsame Abfragen, abgebrochene Verbindungen und Sperrwartezeiten nicht als Zähler, daher werden diese Karten nicht gezeichnet. Datencache (%) stammt aus session logical reads im Verhältnis zu physical reads, und das Speicherdiagramm zeigt, was die Instanz belegt — die belegte SGA plus die verwendete PGA —, gegenüber dem, was in der SGA noch frei ist.
Datencache in der Kopfzeile ist in jeder Engine, die ihn meldet, der Prozentsatz der Lesevorgänge, die ohne Festplattenzugriff aus dem Cache des Servers bedient werden. Langsame Abfragen und abgebrochene Verbindungen folgen dem Takt des Dashboards; der Datencache und die Sperren, die sich nicht von Sekunde zu Sekunde ändern, werden alle 10 Sekunden neu berechnet, auch wenn der Takt schneller ist.
Das Dashboard warnt, wenn der Datencache, abgebrochene Verbindungen oder Sperren ihren Schwellenwert überschreiten, und kann Systemmitteilungen senden.
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.
MySQLMariaDBAuroraClickHouse
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 › Doppelklick 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 deinen Geräten ü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. 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
Die Pausentaste in der Kopfzeile stoppt die Abtastung, ohne die Diagramme zu löschen; dieselbe Taste setzt sie fort.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
Die Pausentaste in der Kopfzeile des Dashboards (Aktualisierung anhalten) beendet die Abtastung des Servers: Die Diagramme behalten, was sie gezeichnet haben, die Taktauswahl wird deaktiviert und der Live-Punkt hört auf zu pulsieren.
Dieselbe Taste (Aktualisierung fortsetzen) startet erneut. Die Raten werden nach dem Fortsetzen von null an gemessen, sodass der erste Punkt nach einer Pause die angehaltene Zeit nicht einrechnet.
Die Nadel in der Kopfzeile des Dashboards macht diesen Server zu dem, den das Widget zeigt; es ist dasselbe angeheftete Profil wie in den Widget-Einstellungen.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
Die Nadel in der Kopfzeile des Dashboards (Diese Verbindung ans Widget heften) macht diesen Server zu dem, den das Widget zeigt. Es ist dieselbe Einstellung „Angeheftetes Profil“ im Tab Widget der Einstellungen, eine Änderung an einer Stelle ändert also auch die andere. Das Anheften startet außerdem die Hintergrundaktualisierung neu, die das Widget aktuell hält, während Calíope im Hintergrund ist.
Ist dieser Server schon der angeheftete, ist die Nadel gefüllt und bernsteinfarben (Verbindung ans Widget geheftet). Mit eingeschalteter iCloud-Synchronisierung geht die Wahl auf deine anderen Geräte über.
Wenn das Widget keine Daten zeigt, siehe „Das Widget zeigt „Keine Daten“: So behebst du es“.
Die Taste mit den zwei Pfeilen am Ende der Kopfzeile gibt dem Dashboard den ganzen Bildschirm; es ist nicht der TV-Modus.
Wo es zu finden ist: Workspace › Werkzeuge › Dashboard
Die Taste mit den zwei Pfeilen am Ende der Kopfzeile des Dashboards (Vollbild) gibt ihm den ganzen Bildschirm. Auf dem Mac schaltet sie das Fenster in den Vollbildmodus. Außerhalb des Mac bedeckt sie den Bildschirm mit den Zahlen der Kopfzeile, der Spaltentaste und den Karten und schließt sich mit ihrem ✕.
Es ist nicht der TV-Modus: Das Vollbild behält die Zahlen der Kopfzeile und hält den Bildschirm nicht wach.
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 dem Replikat. Standard: 30 s. Gilt nur, wenn der Server als Replikat 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.
ClickHouse
Mit ClickHouse gibt es keinen Schwellenwert Minimale Cache-Trefferrate: Der Server meldet keine Trefferquote, daher zeichnet das Dashboard diese Karte nicht und das Blatt bietet den Schwellenwert nicht an.
Stichwörter: Warnungen, Benachrichtigungen, Verbindungen, Cache, InnoDB, Hit Rate, Replikat, Lag, Schwellen, Glocke, Buffer Pool, Cooldown, 5 Minuten