Esta página describe Calíope 1.5, la versión que estoy construyendo ahora mismo. La 1.4 ya 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.

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.

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 (pie charts) del Tablero muestran la distribución de conexiones por usuario, el tamaño de cada base de datos, la memoria de caché (buffer pool, log buffer, etc.) en los servidores que publican ese desglose y la distribución de hilos (running/sleeping/waiting).

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: Transacciones/s es la única tarjeta de línea.

Caché de datos, en la cabecera, es el porcentaje de lecturas servidas desde la caché del servidor sin tocar disco, en todos los motores. Estas métricas se actualizan al mismo ritmo que el resto del Tablero.

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

Alertas automáticas del Tablero

El Tablero genera advertencias cuando conexiones abortadas o bloqueos superan umbrales.

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.

MySQLMariaDBAurora

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 › 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.

Reset: 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 Preferencias, el orden y las tarjetas ocultas se replican automáticamente entre tus dispositivos Mac, iPad e iPhone. 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; también sirve la tecla Esc de un teclado externo. 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

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: Preferencias del Sistema › Notificaciones y enfoque › Calíope.
- iPad: Ajustes › Notificaciones › Calíope.

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