Questa pagina descrive Calíope 1.5, la versione che sto costruendo adesso. La 1.4 è sull'App Store per Mac, iPad, iPhone, Apple Watch, Apple TV e Apple Vision Pro. Il changelog dice in quale versione è arrivata ogni funzione.
Aggiunge a ogni argomento un pulsante «Apri in Calíope». Funziona solo con l'app installata.
Premi Dashboard nella barra di navigazione dell’area di lavoro. La dashboard mostra metriche del server aggiornate automaticamente: connessioni attive, thread, tempo di attività e velocità di trasferimento.
Cadenza: il selettore nell’intestazione decide ogni quanto viene interrogato lo stato del server (1, 2, 5, 10 o 30 secondi), e accanto è indicato quando è arrivato l’ultimo campione. Le dimensioni dei database e l’elenco dei processi sono più costosi da calcolare e si aggiornano ogni 100 secondi, indipendentemente da questa scelta.
I valori al secondo sono calcolati sul tempo reale trascorso tra due campioni, quindi cambiare la cadenza non altera la loro scala.
Parole chiave: dashboard, cruscotto, monitor, tempo reale, metriche, stato
Visualizza il traffico di rete e il ritmo di query al secondo.
Dove si trova: Workspace › Strumenti › Dashboard
MySQLMariaDBAurora
Il Dashboard include grafici a linee per Byte inviati/sec, Byte ricevuti/sec e Query/sec (QPS).
SQL Server
Il Dashboard include un grafico a linee per Query/sec, che conta i batch che il server riceve (Batch Requests/sec). Il server non pubblica i byte inviati e ricevuti, quindi quelle schede non vengono disegnate.
PostgreSQL
Il Dashboard include un grafico a linee per Transazioni/s: i commit più i rollback, da pg_stat_database. Il server non pubblica né le istruzioni né i byte inviati e ricevuti, quindi quelle schede non vengono disegnate.
I grafici si aggiornano in tempo reale con una cronologia degli ultimi punti misurati.
Parole chiave: qps, traffico, byte, rete, queries per second
Grafici a torta di connessioni, memoria cache e uso del disco per DB.
Dove si trova: Workspace › Strumenti › Dashboard
I grafici a torta (pie chart) del Dashboard mostrano la distribuzione delle connessioni per utente, la dimensione di ogni database, la memoria cache (buffer pool, log buffer, ecc.) sui server che pubblicano questo dettaglio e la distribuzione dei thread (running/sleeping/waiting).
Parole chiave: pie chart, cache, innodb, memoria, distribuzione, thread
Il pulsante di layout nell'intestazione del Dashboard alterna tra la disposizione a 2 colonne (più ampia) e quella a 3 colonne (più compatta). Utile per adattare la vista alle dimensioni della finestra.
Parole chiave: layout, colonne, distribuzione, grid, vista
Schede aggiuntive: query lente, connessioni interrotte, cache dati e blocchi.
Dove si trova: Workspace › Strumenti › Dashboard
MySQLMariaDBAurora
Oltre ai grafici di traffico e QPS, il Dashboard include schede a linee per:
- Query lente/sec — ritmo delle query che hanno superato la soglia long_query_time
- Connessioni interrotte/sec — connessioni rifiutate o interrotte in modo anomalo
- Cache dati (%) — percentuale di letture servite dalla cache del server senza toccare il disco. Non è quanto è piena
- Blocchi di tabella — numero di volte in cui una query ha dovuto attendere un blocco di tabella
SQL Server
Accanto a Query/sec, il Dashboard disegna Blocchi di tabella: le attese di blocco al secondo (Lock Waits/sec). Il server non pubblica né le query lente né le connessioni interrotte, quindi quelle schede non vengono disegnate.
PostgreSQL
Il server non pubblica né le query lente, né le connessioni interrotte, né le attese di blocco, quindi quelle schede non vengono disegnate: Transazioni/s è l'unica scheda a linee.
Cache dati, nell'intestazione, è la percentuale di letture servite dalla cache del server senza toccare il disco, in ogni motore. Queste metriche si aggiornano allo stesso ritmo del resto del Dashboard.
Il Dashboard genera avvisi quando le connessioni interrotte o i blocchi superano le soglie.
Dove si trova: Workspace › Strumenti › Dashboard
Calíope sorveglia il server in due modi.
Nell'intestazione, a ogni aggiornamento del Dashboard: compare un banner quando la Cache dati scende sotto il 90 %, quando ci sono Connessioni interrotte o quando i Blocchi di tabella superano mezza attesa al secondo. Indica la metrica e il suo valore, e scompare da solo quando il valore torna alla normalità. Una metrica che il server non pubblica non lo fa mai scattare.
Come notifiche di sistema: il pulsante della campana, nell'intestazione, apre Avvisi del server, dove si attivano e si fissano le soglie delle connessioni rispetto al massimo del server e del tasso di successo della cache. Lo stesso avviso non si ripete prima di 5 minuti.
MySQLMariaDBAurora
Lì c'è anche la soglia del ritardo di replica, valutata dal Monitor della replica.
Parole chiave: avviso, warning, soglia, connessioni interrotte, blocchi, notifica
Ingrandisci una singola scheda per vederla in dettaglio.
Dove si trova: Dashboard › Clic sulla scheda
Fai doppio clic su una qualsiasi scheda del Dashboard (doppio tocco su iPad) per espanderla in modalità zoom. La scheda viene mostrata a schermo intero all'interno del Dashboard con la cronologia dei dati ampliata. Premi Tutti i grafici o, su macOS, Esc per tornare alla vista normale di tutte le schede.
Parole chiave: zoom, ingrandire scheda, dettaglio, espandere, fullscreen card
Riordina o nascondi le schede del Dashboard; il layout si sincronizza via iCloud.
Dove si trova: Dashboard › Pulsante personalizza (sliders)
La dashboard consente di personalizzare sia l’ordine sia la visibilità delle schede. Attiva la modalità di personalizzazione con il pulsante ☰ (cursori) nell’intestazione.
Riordinare trascinando: trascina una scheda e rilasciala su un’altra; la scheda trascinata prende la posizione della seconda e le altre si spostano. Durante il trascinamento la scheda di destinazione viene evidenziata. Su macOS con il mouse; su iPad tieni premuta la scheda e trascinala.
Riordinare senza trascinare: ogni scheda mostra due frecce nell’angolo in basso a sinistra che la spostano di una posizione a sinistra o a destra. È la via da usare con la tastiera o con VoiceOver, dove il trascinamento non è disponibile.
Nascondere: in modalità personalizzazione ogni scheda mostra un pulsante con l’occhio barrato nell’angolo in alto a destra. Premendolo la scheda passa al pannello Schede nascoste sotto la griglia. Tocca una scheda nascosta per ripristinarla.
Ripristino: il pulsante con la freccia circolare ripristina l’ordine predefinito e mostra di nuovo tutte le schede. Chiede conferma.
Sincronizzazione: il layout è salvato per account iCloud. Se attivi la sincronizzazione iCloud nelle Preferenze, ordine e schede nascoste si replicano tra i dispositivi Mac, iPad e iPhone. Senza iCloud resta solo sul dispositivo corrente.
Mentre la modalità personalizzazione è attiva, il doppio clic per lo zoom è disattivato; esci dalla modalità (stesso pulsante, ora con segno di spunta) per riprendere lo zoom.
I grafici a schermo intero, senza barre né menu, per lasciare la dashboard in vista.
Dove si trova: Dashboard › Pulsante Modalità TV (televisore)
Il pulsante con l’icona del televisore, nell’intestazione della dashboard, dà ai grafici tutto lo schermo: vengono ritirate l’intestazione dello strumento, la barra laterale, la barra delle schede e la barra di stato. È pensato per lasciare la dashboard su uno schermo e leggerla da lontano, quindi il numero di colonne deriva dalla larghezza disponibile e i grafici crescono per riempirla.
Per uscire: su macOS premi Esc. Su iPad tocca un punto qualsiasi e comparirà una barra superiore con il pulsante di chiusura; funziona anche il tasto Esc di una tastiera esterna. Un tocco non fa uscire direttamente, così pulire o sfiorare lo schermo non interrompe la modalità.
La barra superiore si nasconde da sola dopo pochi secondi e mostra il nome del server e quando è arrivato l’ultimo campione.
Schermo acceso: mentre la modalità TV è attiva lo schermo non si spegne per inattività. È indipendente dal pulsante «Mantieni attivo» della barra strumenti: entrare e uscire dalla modalità TV non cambia quella preferenza.
La modalità TV non si combina con lo zoom di una singola scheda né con la modalità personalizzazione; entrandovi si chiudono entrambe.
Parole chiave: modalità tv, schermo intero, chiosco, senza distrazioni, esc, uscire, schermo acceso
Ricevi notifiche di sistema quando il server supera soglie configurabili di connessioni, tasso di successo della cache o lag di replica.
Dove si trova: Dashboard › Avvisi (campanella)
Calíope può inviarti notifiche di sistema quando rileva condizioni critiche nel server connesso.
Per configurare gli avvisi:
1. Apri la Dashboard dalla barra laterale Strumenti.
2. Premi l'icona della campanella nella barra superiore della Dashboard.
3. Attiva l'interruttore Attiva avvisi di sistema. Se è la prima volta, il sistema richiede il permesso di inviare notifiche; accettalo.
4. Regola le soglie in base al tuo ambiente:
- Connessioni massime (%) — percentuale di utilizzo delle connessioni sul totale configurato nel server. Predefinito: 80%. Utile per rilevare i picchi di connessioni prima di saturare il server.
- Tasso di successo cache minimo (%) — avvisa se la percentuale di letture servite dalla cache scende sotto questo valore. Predefinito: 95%. Un valore basso indica che il buffer pool è insufficiente per il carico di lavoro.
- Lag di replica (sec) — secondi di ritardo massimo tollerato nella replica. Predefinito: 30 s. Si applica solo se il server è configurato come replica.
Comportamento delle notifiche:
- Le notifiche vengono inviate come notifiche di sistema.
- C'è un intervallo di raffreddamento (cooldown) di 5 minuti tra notifiche dello stesso tipo per evitare lo spam quando la condizione persiste.
- Gli avvisi vengono valutati a ogni ciclo di aggiornamento della Dashboard mentre questa è aperta.
Permessi:
Se hai rifiutato il permesso per le notifiche, puoi ripristinarlo in:
- macOS: Preferenze di Sistema › Notifiche e Full Immersion › Calíope.
- iPad: Impostazioni › Notifiche › Calíope.
Parole chiave: avvisi, notifiche, connessioni, cache, innodb, hit rate, replica, lag, soglie, campanella, buffer pool, cooldown, 5 minuti