Streams y grupos de consumidores

funcional

Navega por un stream, ve los grupos, consumidores, entradas pendientes y el lag, y ejecuta comandos de stream revisados desde la vista de la clave.

Una clave de stream se abre en el vista de claves como cualquier otra clave, con cuatro pestañas sobre la cuadrícula en lugar de un valor: Entradas, Grupos, Consumidores y Pendiente. Juntos responden a las preguntas que de otra forma tendrías que ir armando a partir de XRANGE, XINFO y XPENDING a mano: qué hay en el flujo, qué grupos de consumidores lo leen, cuánto retraso tiene cada grupo y qué entradas se entregaron a un consumidor que nunca las reconoció. Haz doble clic en una clave de flujo en el explorador, o haz clic derecho y elige Abrir valor.

Las pestañas

TabLo que muestra
EntradasLas entradas del flujo, de la más antigua a la más reciente, 1,000 a la vez con mostrando N de M entradas y Cargar más. Cada fila es el ID de la entrada y sus campos; haz clic en una fila para ver los campos debajo de la cuadrícula, con el selector de formato de valor.
GruposUna fila por grupo de consumidores: cuántos consumidores tiene, cuántas entradas pendientes, la última entrada que se le entregó, cuántas ha leído y su retraso (las entradas añadidas después de la última que leyó) y la longitud del flujo. El retraso y las entradas leídas requieren Redis 7 o posterior y aparecen en blanco antes de esa versión, o cuando el servidor no puede saberlo. Haz clic en un grupo para que sea el que muestren las dos pestañas siguientes.
ConsumidoresLos consumidores del grupo elegido, cada uno con cuántas entradas tiene pendientes, cuánto tiempo ha estado inactivo (milisegundos desde la última lectura) y, en Redis 7.2 y posteriores, cuánto tiempo ha estado inactivo (desde su último avance).
PendienteCada entrada que el grupo elegido entregó y nadie confirmó: el ID de la entrada, el consumidor que la retiene, su tiempo de inactividad en milisegundos y cuántas veces se entregó, 1,000 cada vez con mostrando N de M pendientes y Cargar más. Un consumidor que murió a mitad de un lote aparece aquí como entradas cuyo tiempo de inactividad no deja de crecer.

Los chips de grupo junto a las pestañas cambian las pestañas Consumidores y Pendientes a otro grupo sin tener que volver a Grupos.

SQLly
Stream de Redis en la vista de claves: la pestaña Pendientes de un grupo, con las entradas de un consumidor inactivo y sus milisegundos de inactividad, y el formulario Auto-claim que muestra el XAUTOCLAIM exacto antes de Ejecutar.
Stream de Redis en la vista de claves: la pestaña Pendientes de un grupo, con las entradas de un consumidor inactivo y sus milisegundos de inactividad, y el formulario Auto-claim que muestra el XAUTOCLAIM exacto antes de Ejecutar.

Acciones

TabBotónComando que se ejecuta
EntradasAnexar entrada…XADD key * field value … - escribe un campo y un valor, pulsa Añadir par por cada par extra; * permite que el servidor elija el id, o escribe uno
EntradasEliminar seleccionado…XDEL key id
EntradasRecortar…XTRIM key MAXLEN n (mantener los últimos n) o XTRIM key MINID id (descartar los ids más bajos), opcionalmente aproximado (~); te pide que escribas primero la cantidad o el id
GruposCrear grupo…XGROUP CREATE key group $ - empezar en $ para entregar solo entradas nuevas, o 0 para todo el flujo
GruposDestruir grupo seleccionado…XGROUP DESTROY key group; te pide que escribas primero el nombre del grupo
PendienteConfirmar seleccionada…XACK key group id
PendienteReclamar seleccionada…XCLAIM key group consumer min-idle id - el umbral de inactividad parte del tiempo de inactividad actual de la entrada, así que un consumidor que la haya recogido mientras tanto se la queda
PendienteReclamar automáticamente…XAUTOCLAIM key group consumer 60000 0-0 COUNT 100 - mueve cada entrada que lleve inactiva al menos ese tiempo (un minuto si no lo cambias) al consumidor que indiques

Cada formulario muestra el comando exacto que ejecutará, actualizado mientras escribes, y nada se ejecuta hasta que pulses Ejecutar. Las acciones de stream pasan por las mismas barreras que cualquier edición de vista de claves: una conexión de solo lectura o de producción con las escrituras bloqueadas las rechaza, y una conexión que confirma los cambios de datos convierte el botón en Confirmar ejecución. Tras una acción correcta, la clave se recarga y se mantienen la pestaña y el grupo en los que estabas.

Recortar y destruir un grupo no se puede deshacer. XTRIM elimina entradas y XGROUP DESTROY elimina el grupo con todos sus consumidores y entradas pendientes, así que además de la revisión habitual el formulario te pide escribir el número de recorte (o el id) o el nombre del grupo, y Ejecutar permanece deshabilitado hasta que lo que escribes coincida exactamente. El formulario de recorte también indica aproximadamente cuántas entradas quitaría el conteo.

Los nombres de campos, valores, grupos y consumidores se pasan al servidor como sus bytes exactos: 00014 permanece 00014, y se usa tal cual un nombre de grupo binario o de consumidor seleccionado de la cuadrícula (el nombre de un grupo binario se confirma escribiendo su hexadecimal). Marcar El valor es hexadecimal en Entrada de anexado para escribir valores binarios.