Esta página describe Calíope 1.7, la versión que estoy construyendo ahora mismo. La 1.6 está en la App Store para Mac, iPad, iPhone, Apple Watch, Apple TV y Apple Vision Pro. El changelog dice en qué versión llegó cada función.

Añade un botón «Abrir en Calíope» a cada tema. Sólo funciona con la app instalada.

Tablero

Abrir el Tablero

Monitorea el estado del servidor en tiempo real.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

Pulsa Tablero en la barra de navegación del workspace. El Tablero muestra métricas del servidor actualizadas automáticamente: conexiones activas, hilos, tiempo en línea y velocidades de transferencia.

Cadencia: el selector del encabezado decide cada cuánto se consulta el estado del servidor (1, 2, 5, 10 o 30 segundos), y al lado se indica cuándo llegó el último dato. Los tamaños de base de datos y la lista de procesos son más costosos de calcular y se actualizan cada 100 segundos, al margen de esa elección.

Las cifras por segundo se calculan con el tiempo real entre muestras, así que cambiar la cadencia no altera su escala.

Oracle

En Oracle la cabecera suma Almacenamiento más lleno: el tablespace más ocupado, en porcentaje de su tamaño máximo con el crecimiento automático contado (DBA_TABLESPACE_USAGE_METRICS). Un usuario sin permiso sobre las vistas V$ no lee la muestra: la cabecera y cada tarjeta dicen el motivo del servidor en vez de esperar una primera muestra que no va a llegar.

Palabras clave: dashboard, tablero, monitor, tiempo real, métricas, estado

Gráficas de tráfico y consultas

Visualiza el tráfico de red y el ritmo de consultas por segundo.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

MySQLMariaDBAurora

El Tablero incluye gráficas de línea para Bytes Enviados/seg, Bytes Recibidos/seg y Consultas/seg (QPS).

SQL Server

El Tablero incluye una gráfica de línea para Consultas/seg, que cuenta los lotes que recibe el servidor (Batch Requests/sec). El servidor no publica los bytes enviados y recibidos, así que esas tarjetas no se dibujan.

PostgreSQL

El Tablero incluye una gráfica de línea para Transacciones/s: las confirmadas más las deshechas, de pg_stat_database. El servidor no publica ni las sentencias ni los bytes enviados y recibidos, así que esas tarjetas no se dibujan.

ClickHouse

El Tablero incluye gráficas de línea de Bytes enviados/s, Bytes recibidos/s y Consultas/s (QPS), de los contadores NetworkSendBytes, NetworkReceiveBytes y Query del servidor.

Oracle

El Tablero incluye gráficas de línea de Bytes enviados/s, Bytes recibidos/s y Consultas/s (QPS), de las estadísticas bytes sent via SQL*Net to client, bytes received via SQL*Net from client y execute count de V$SYSSTAT. Un usuario sin permiso para leer las vistas V$ no recibe ningún contador, y el Tablero lo dice en vez de dibujar ceros.

Las gráficas se actualizan en tiempo real con un historial de los últimos puntos medidos.

Palabras clave: qps, tráfico, bytes, red, queries per second

Gráficas de distribución

Tortas de conexiones, memoria de caché y uso de disco por BD.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

Las gráficas circulares del Tablero muestran las conexiones por usuario y el tamaño de cada base de datos (las ocho mayores, sin las del sistema), la memoria (la caché de datos dividida en datos limpios, datos sucios y libre en los servidores que publican ese desglose, o en uso y libre donde el servidor publica su memoria total) y los hilos (activos, dormidos y, donde el servidor los publica, en caché). Los usuarios y los tamaños se actualizan cada 100 segundos.

Palabras clave: pie chart, caché, innodb, memoria, distribución, hilos

Cambiar el layout del Tablero

Alterna entre vista de 2 y 3 columnas.

Dónde está: Tablero › Botón de layout

El botón de layout en la cabecera del Tablero alterna entre disposición de 2 columnas (más ancha) y 3 columnas (más compacta). Útil para adaptar la vista según el tamaño de la ventana.

Palabras clave: layout, columnas, distribución, grid, vista

Gráficas de rendimiento del servidor

Tarjetas adicionales: consultas lentas, conexiones abortadas, caché de datos y bloqueos.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

MySQLMariaDBAurora

Además de las gráficas de tráfico y QPS, el Tablero incluye tarjetas de línea para:

- Consultas lentas/seg — ritmo de consultas que superaron el umbral long_query_time
- Conexiones abortadas/seg — conexiones rechazadas o interrumpidas de forma anómala
- Caché de datos (%) — porcentaje de lecturas servidas desde la caché del servidor sin tocar disco. No es lo llena que está
- Bloqueos de tabla — número de veces que una consulta tuvo que esperar un bloqueo de tabla

SQL Server

Junto a Consultas/seg, el Tablero dibuja Bloqueos de tabla: las esperas de bloqueo por segundo (Lock Waits/sec). El servidor no publica las consultas lentas ni las conexiones abortadas, así que esas tarjetas no se dibujan.

PostgreSQL

El servidor no publica ni las consultas lentas, ni las conexiones abortadas, ni las esperas de bloqueo, así que esas tarjetas no se dibujan: las tarjetas de línea son Transacciones/s y Caché de datos (%), que sale de los bloques leídos de la caché frente a los leídos de disco en pg_stat_database.

ClickHouse

El servidor no cuenta ni consultas lentas, ni conexiones abortadas, ni esperas de bloqueo, y no tiene una caché de páginas cuyo acierto se pueda medir, así que esas tarjetas no se dibujan. La gráfica de memoria enseña lo que usa el servidor frente a su techo max_server_memory_usage.

Oracle

Oracle no publica como contador las consultas lentas, las conexiones abortadas ni las esperas de bloqueo, así que esas tarjetas no se dibujan. Caché de datos (%) sale de session logical reads frente a physical reads, y la gráfica de memoria enseña lo que usa la instancia —la SGA ocupada más la PGA en uso— frente a lo que le queda libre a la SGA.

Caché de datos, en la cabecera, es el porcentaje de lecturas servidas desde la caché del servidor sin tocar disco, en todos los motores que la publican. Las consultas lentas y las conexiones abortadas siguen la cadencia del Tablero; la caché de datos y los bloqueos, que no cambian de un segundo a otro, se recalculan cada 10 segundos aunque la cadencia sea más rápida.

Palabras clave: slow queries, consultas lentas, aborted connections, caché, InnoDB buffer, bloqueos, table locks

Alertas automáticas del Tablero

El Tablero avisa cuando la caché de datos, las conexiones abortadas o los bloqueos cruzan su umbral, y puede enviar notificaciones del sistema.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

Calíope vigila el servidor de dos maneras.

En la cabecera, en cada actualización del Tablero: aparece un banner cuando la Caché de datos baja del 90 %, cuando hay Conexiones abortadas o cuando los Bloqueos de tabla pasan de media espera por segundo. Nombra la métrica y su valor, y desaparece solo cuando el valor vuelve a la normalidad. Una métrica que el servidor no publica no lo hace saltar nunca.

Como notificaciones del sistema: el botón de la campana, en la cabecera, abre Alertas del servidor, donde se activan y se fijan los umbrales de conexiones frente al máximo del servidor y de tasa de acierto de la caché. La misma alerta no se repite antes de 5 minutos.

MySQLMariaDBAuroraClickHouse

Ahí está también el umbral de retraso de réplica, que se evalúa desde el Monitor de réplica.

Palabras clave: alerta, warning, umbral, conexiones abortadas, bloqueos, notificación

Zoom en tarjetas del Tablero

Amplía una tarjeta individual para verla en detalle.

Dónde está: Tablero › Doble clic en tarjeta

Haz doble clic en cualquier tarjeta del Tablero (doble toque en iPad) para expandirla en modo zoom. La tarjeta se muestra a pantalla completa dentro del Tablero con el historial de datos ampliado. Pulsa Todos los gráficos o, en macOS, Esc para volver a la vista normal de todas las tarjetas.

Palabras clave: zoom, ampliar tarjeta, detalle, expandir, fullscreen card

Personalizar el Tablero

Reordena o esconde las tarjetas del Tablero; el diseño se sincroniza por iCloud.

Dónde está: Tablero › Botón personalizar (sliders)

El Tablero permite personalizar tanto el orden como la visibilidad de sus tarjetas. Activa el modo de personalización con el botón ☰ (sliders) en el encabezado del Tablero.

Reordenar arrastrando: arrastra una tarjeta y suéltala sobre otra; la tarjeta arrastrada se coloca en la posición de la segunda y las demás se desplazan. Mientras arrastras, la tarjeta de destino se resalta. En macOS se usa el ratón; en iPad se mantiene presionada la tarjeta y se arrastra.

Reordenar sin arrastrar: cada tarjeta muestra dos flechas en su esquina inferior izquierda que la mueven una posición a izquierda o derecha. Es el camino a usar con teclado o con VoiceOver, donde el arrastre no está disponible.

Ocultar: dentro del modo personalización, cada tarjeta muestra un botón con el icono de ojo tachado en la esquina superior derecha. Al pulsarlo, la tarjeta se mueve al panel Tarjetas ocultas que aparece debajo de la cuadrícula. Toca cualquier tarjeta oculta para volver a mostrarla.

Restablecer: el botón de flecha circular restaura el orden por defecto y muestra todas las tarjetas nuevamente. Pide confirmación antes de aplicar.

Sincronización: el diseño se guarda por cuenta de iCloud. Si activas la sincronización de iCloud en Ajustes, el orden y las tarjetas ocultas se replican automáticamente entre tus dispositivos. Sin iCloud, se guarda solo en el dispositivo actual.

Mientras el modo personalización está activo, el doble-clic para zoom queda deshabilitado; sal del modo (mismo botón, ahora con check) para retomar el zoom.

Palabras clave: personalizar tablero, customize dashboard, reordenar, arrastrar tarjetas, ocultar tarjeta, eye slash, reset layout, iCloud sync

Los gráficos a pantalla completa, sin barras ni menús, para dejar el Tablero puesto.

Dónde está: Tablero › Botón Modo TV (televisor)

El botón con el icono de televisor, en el encabezado del Tablero, deja los gráficos ocupando la pantalla entera: se retiran la cabecera de la herramienta, la barra lateral, la barra de pestañas y la barra de estado. Está pensado para dejar el Tablero puesto en una pantalla y mirarlo de lejos, así que el número de columnas se calcula según el ancho disponible y los gráficos crecen para llenarlo.

Salir: en macOS, pulsa Esc. En iPad, toca cualquier parte de la pantalla y aparecerá una barra superior con el botón de cerrar. Un toque no sale directamente para que limpiar la pantalla o rozarla no interrumpa el modo.

La barra superior se esconde sola a los pocos segundos y muestra el nombre del servidor y cuándo llegó el último dato.

Pantalla encendida: mientras el modo TV está activo, la pantalla no se apaga por inactividad. Es independiente del botón «Mantener activo» de la barra de herramientas: entrar y salir del modo TV no cambia esa preferencia.

El modo TV no conviene con el zoom de una tarjeta ni con el modo de personalización; al entrar, ambos se cierran.

Palabras clave: modo tv, tv mode, pantalla completa, kiosco, quiosco, sin distracciones, esc, salir, pantalla encendida

Pausar y reanudar el Tablero

El botón de pausa de la cabecera detiene el muestreo sin borrar las gráficas; el mismo botón lo reanuda.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

El botón de pausa de la cabecera del Tablero (Pausar la actualización) deja de muestrear el servidor: las gráficas conservan lo dibujado, el selector de cadencia queda desactivado y el punto de en vivo deja de latir.

El mismo botón (Reanudar la actualización) vuelve a empezar. Las tasas se miden desde cero al reanudar, así que el primer punto tras una pausa no mezcla el tiempo que estuvo parado.

Palabras clave: pausar, reanudar, detener actualización, tablero

Anclar el servidor del widget desde el Tablero

El alfiler de la cabecera del Tablero hace de este servidor el que enseña el widget; es el mismo perfil anclado que el de los ajustes del widget.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

El alfiler de la cabecera del Tablero (Anclar esta conexión al widget) hace de este servidor el que enseña el widget. Es el mismo ajuste «Perfil anclado» de la pestaña Widget de Ajustes, así que cambiarlo en un sitio lo cambia en el otro. Anclar también rearma el refresco en segundo plano, el que mantiene el widget al día con Calíope de fondo.

Cuando este servidor ya es el anclado, el alfiler sale relleno y en ámbar (Conexión anclada al widget). Con la sincronización de iCloud encendida, la elección viaja a tus otros aparatos.

Si el widget no enseña datos, consulta «El widget muestra «Sin datos»: cómo solucionarlo».

Palabras clave: widget, anclar, perfil anclado, refresco en segundo plano, tablero

Pantalla completa del Tablero

El botón de las dos flechas, al final de la cabecera, da al Tablero toda la pantalla; no es el modo TV.

Dónde está: Espacio de Trabajo › Herramientas › Tablero

El botón de las dos flechas, al final de la cabecera del Tablero (Pantalla completa), le da toda la pantalla. En el Mac pone la ventana a pantalla completa. Fuera del Mac cubre la pantalla con las cifras de la cabecera, el botón de columnas y las tarjetas, y se cierra con su ✕.

No es el modo TV: la pantalla completa conserva las cifras de la cabecera y no mantiene la pantalla encendida.

Palabras clave: pantalla completa, tablero, ampliar, cubrir

Alertas del servidor

Recibe notificaciones del sistema cuando el servidor supera umbrales configurables de conexiones, tasa de acierto de caché o lag de replicación.

Dónde está: Tablero › Alertas (campana)

Calíope puede enviarte notificaciones del sistema cuando detecta condiciones críticas en el servidor conectado.

Para configurar las alertas:
1. Abre el Tablero desde la barra lateral Herramientas.
2. Pulsa el ícono de campana en la barra superior del Tablero.
3. Activa el interruptor Activar alertas del sistema. Si es la primera vez, el sistema solicita permiso para enviar notificaciones; acéptalo.
4. Ajusta los umbrales según tu entorno:
- Conexiones máximas (%) — porcentaje de uso de conexiones sobre el total configurado en el servidor. Defecto: 80%. Útil para detectar picos de conexiones antes de saturar el servidor.
- Tasa de acierto de caché mínima (%) — alerta si el porcentaje de lecturas servidas desde la caché cae por debajo de este valor. Defecto: 95%. Un valor bajo indica que el buffer pool es insuficiente para la carga de trabajo.
- Lag de replicación (seg) — segundos de retraso máximo tolerado en la réplica. Defecto: 30 s. Solo aplica si el servidor está configurado como réplica.

Comportamiento de las notificaciones:
- Las notificaciones se envían como notificaciones del sistema.
- Hay un intervalo de enfriamiento (cooldown) de 5 minutos entre notificaciones del mismo tipo para evitar spam cuando la condición persiste.
- Las alertas se evalúan en cada ciclo de actualización del Tablero mientras este esté abierto.

Permisos:
Si rechazaste el permiso de notificaciones, puedes restablecerlo en:
- macOS: Ajustes del Sistema › Notificaciones y enfoque › Calíope.
- iPad: Ajustes › Notificaciones › Calíope.

ClickHouse

Con ClickHouse no hay umbral de Tasa de acierto de caché mínima: el servidor no publica una tasa de aciertos, así que el Tablero no dibuja esa tarjeta y la hoja no ofrece el umbral.

Palabras clave: alertas, notificaciones, conexiones, caché, innodb, hit rate, réplica, lag, umbrales, campana, buffer pool, cooldown, 5 minutos