Questa pagina descrive Calíope 1.7, la versione che sto costruendo adesso. La 1.6 è 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.
Oracle
Con Oracle l’intestazione aggiunge Spazio più pieno: il tablespace più occupato, in percentuale della sua dimensione massima con l’estensione automatica conteggiata (DBA_TABLESPACE_USAGE_METRICS). Un utente senza permesso sulle viste V$ non legge il campione: l’intestazione e ogni scheda riportano il motivo del server invece di attendere un primo campione che non arriverà.
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.
ClickHouse
Il Dashboard include grafici a linee per Byte inviati/s, Byte ricevuti/s e Query/s (QPS), dai contatori NetworkSendBytes, NetworkReceiveBytes e Query del server.
Oracle
Il Dashboard include grafici a linee per Byte inviati/s, Byte ricevuti/s e Query/s (QPS), dalle statistiche bytes sent via SQL*Net to client, bytes received via SQL*Net from client ed execute count di V$SYSSTAT. Un utente senza il permesso di leggere le viste V$ non riceve alcun contatore, e il Dashboard lo dice invece di disegnare zeri.
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 del Dashboard mostrano le connessioni per utente e la dimensione di ogni database (gli otto più grandi, senza quelli di sistema), la memoria (la cache dei dati divisa in dati puliti, dati sporchi e libera sui server che pubblicano questo dettaglio, oppure in uso e libera dove il server pubblica la sua memoria totale) e i thread (attivi, inattivi e, dove il server li pubblica, in cache). Utenti e dimensioni si aggiornano ogni 100 secondi.
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: le schede a linee sono Transazioni/s e Cache dati (%), che viene dai blocchi letti dalla cache rispetto a quelli letti dal disco in pg_stat_database.
ClickHouse
Il server non conta né query lente, né connessioni interrotte, né attese di lock, e non ha una cache di pagine di cui misurare il tasso di successo, quindi quelle schede non vengono disegnate. Il grafico della memoria mostra quanto usa il server rispetto al suo tetto max_server_memory_usage.
Oracle
Oracle non pubblica come contatore le query lente, le connessioni interrotte né le attese di lock, quindi quelle schede non vengono disegnate. Cache dati (%) deriva da session logical reads rispetto a physical reads, e il grafico della memoria mostra ciò che usa l’istanza — la SGA occupata più la PGA in uso — rispetto a ciò che resta libero nella SGA.
Cache dati, nell'intestazione, è la percentuale di letture servite dalla cache del server senza toccare il disco, in ogni motore che la pubblica. Le query lente e le connessioni interrotte seguono la cadenza del Dashboard; la cache dei dati e i blocchi, che non cambiano da un secondo all’altro, vengono ricalcolati ogni 10 secondi anche quando la cadenza è più rapida.
Il Dashboard avvisa quando la cache dei dati, le connessioni interrotte o i blocchi superano la loro soglia, e può inviare notifiche di sistema.
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.
MySQLMariaDBAuroraClickHouse
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 › Doppio 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 Impostazioni, ordine e schede nascoste si replicano tra i tuoi dispositivi. 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. 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
Il pulsante di pausa dell’intestazione ferma il campionamento senza cancellare i grafici; lo stesso pulsante lo riprende.
Dove si trova: Workspace › Strumenti › Dashboard
Il pulsante di pausa dell’intestazione della Dashboard (Metti in pausa l’aggiornamento) smette di campionare il server: i grafici conservano ciò che hanno disegnato, il selettore della cadenza viene disattivato e il punto del dal vivo smette di pulsare.
Lo stesso pulsante (Riprendi l’aggiornamento) riparte. I tassi si misurano da zero alla ripresa, quindi il primo punto dopo una pausa non mescola il tempo di arresto.
Parole chiave: pausa, riprendere, fermare l’aggiornamento, dashboard
La puntina dell’intestazione della Dashboard fa di questo server quello che il widget mostra; è lo stesso profilo fissato delle impostazioni del widget.
Dove si trova: Workspace › Strumenti › Dashboard
La puntina dell’intestazione della Dashboard (Fissa questa connessione al widget) fa di questo server quello che il widget mostra. È la stessa impostazione «Profilo fissato» della scheda Widget delle Impostazioni, quindi cambiarla in un punto la cambia nell’altro. Fissarlo riavvia anche l’aggiornamento in background, quello che tiene il widget aggiornato con Calíope in background.
Quando questo server è già quello fissato, la puntina è piena e ambra (Connessione fissata al widget). Con la sincronizzazione iCloud attiva, la scelta passa ai tuoi altri dispositivi.
Se il widget non mostra dati, consulta «Il widget mostra «Sin datos»: come risolverlo».
Parole chiave: widget, fissare, profilo fissato, aggiornamento in background, dashboard
Il pulsante con le due frecce, alla fine dell’intestazione, dà alla Dashboard tutto lo schermo; non è la modalità TV.
Dove si trova: Workspace › Strumenti › Dashboard
Il pulsante con le due frecce, alla fine dell’intestazione della Dashboard (Schermo intero), le dà tutto lo schermo. Sul Mac mette la finestra a schermo intero. Fuori dal Mac copre lo schermo con i dati dell’intestazione, il pulsante delle colonne e le schede, e si chiude con la sua ✕.
Non è la modalità TV: lo schermo intero conserva i dati dell’intestazione e non tiene acceso lo schermo.
Parole chiave: schermo intero, dashboard, ingrandire, coprire
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: Impostazioni di Sistema › Notifiche e Full Immersion › Calíope.
- iPad: Impostazioni › Notifiche › Calíope.
ClickHouse
Con ClickHouse non c’è la soglia Tasso di successo cache minimo: il server non pubblica un tasso di hit, quindi la Dashboard non disegna quella scheda e il foglio non offre la soglia.
Parole chiave: avvisi, notifiche, connessioni, cache, innodb, hit rate, replica, lag, soglie, campanella, buffer pool, cooldown, 5 minuti