20 · La observabilidad de la consulta
La suite del capítulo diecinueve vigila lo que el equipo cambia. Este capítulo vigila lo que los usuarios viven. Entre ambos cubren los dos únicos modos de cegarse que tiene un sistema de acceso: no ver el efecto de los propios cambios y no ver la vida que el sistema lleva cuando nadie lo mira. Porque el acceso, en producción, es un flujo continuo de decisiones —filtros que se aplican, topes que cortan, veredictos que se emiten— y cada una de esas decisiones deja huella. La observabilidad es el oficio de que la huella se registre, se lea y se convierta en acción. Sin ella, el sistema no está mal: está solo, que es peor.
Qué se guarda: el diario de cada consulta
La unidad de la observabilidad del acceso es el registro de consulta, y su contenido se ordena mejor por el recorrido del libro que por tablas de catálogo. Por la consulta en sí: el texto original tal cual llegó —erratas incluidas—, el usuario o rol —anonimizado cuando toque, que en un despacho las consultas hablan de trabajadores reales y la confidencialidad del capítulo nueve no descansa en el logging—, el dominio de sesión. Por el pipeline: qué filtros se aplicaron y qué descartó cada uno, cuántos candidatos entraron y salieron de cada fase —el embudo del capítulo trece medido consulta a consulta—, qué veredictos emitió el juez —guardados para reutilización, con la versión de la píldora que certificaron, de modo que un veredicto sobre una píldora actualizada caduque solo—, qué píldoras ensambló el contexto final —con su fecha y su vigencia, para que las respuestas que citan documentos viejos salten como alarma— y con qué presupuesto. Y por el desenlace: la respuesta dada, su tiempo total desglosado por fase, y su coste —tokens, llamadas, tarifas—. Y, si la interfaz lo permite, lo que el usuario hizo con la respuesta —qué documento abrió, cuándo—: sin esa telemetría no existe la cabeza del ranking vivida.
Dos principios rigen ese diario y conviene fijarlos antes de que el volumen decida por uno. El primero: registrar decisiones, no solo resultados. Un log que solo guarda la respuesta final sirve para presumir; uno que guarda cuántos candidatos entraron al tamiz y con qué veredicto salieron sirve para diagnosticar. El segundo: retención con política. Los registros de consulta son el activo más sensible del sistema —contienen, en potencia, los problemas jurídicos reales de personas—; su conservación larga es un pasivo, no un activo, y el contrato debe decir cuánto se guarda, qué se agrega al vencer y quién puede leerlo. La observabilidad que fuga su diario ha convertido la herramienta de confianza en el incidente.
Las cinco señales que miran los ojos
Del diario no sale un panel: salen preguntas. Las cinco que en el despacho acabaron siendo la rutina de revisión —y que este libro propone como mínimo vital— son las siguientes, ordenadas por lo que cada una delata.
La primera: consultas sin respuesta. Todo vacío del capítulo diez registrado, visible como cola de trabajo y clasificado con la única técnica que distingue sus dos clases: la misma consulta se vuelve a correr en sombra, sin los filtros duros; si entonces aparece evidencia, era vacío de filtro, y si no, de corpus. Esta cola es, como se verá en el capítulo siguiente, la materia prima del bucle de retorno; aquí baste su regla de lectura: una consulta sin respuesta es información que solo vale si alguien la mira esa semana.
La segunda: filtros que vacían. Cuántas consultas del período perdieron candidatos por cada filtro, distinguiendo las dos familias: en el lado pre, cuántas consultas quedaron por debajo del tope —el modo de fallo que el capítulo siete pide vigilar—; en el lado post, el porcentaje de over-fetch consumido. Es la señal que detecta dos enfermedades distintas con el mismo síntoma: el filtro mal calibrado —demasiado estricto para lo que el corpus tiene— y la taxonomía sucia —el campo que no dice lo que debería—. Y es la que mide el parámetro que el capítulo ocho dejó pendiente: si el múltiplo de over-fetch elegido basta o sobra.
La tercera: la cabeza del ranking vivida. Las métricas del capítulo dieciocho se calculan contra el dataset; esta señal se calcula contra producción: en qué puesto acabó la evidencia que el usuario finalmente usó —cuando la trazabilidad del ensamblado permite saberlo—, cuántas consultas terminaron con el usuario abriendo el documento noveno. Es la MRR del mundo real, con sus sorpresas: los tipos de consulta que el dataset no imaginaba.
La cuarta: latencia por fase. El desglose que separa lo que cuesta el motor —milisegundos— de lo que cuesta el tamiz, el juez y la generación —segundos—. Sin desglose, la latencia es una queja; con él, es un presupuesto de optimización: la señal que dijo en su día qué palanca del capítulo quince mover.
Y la quinta: coste por consulta y por tipo. No la factura global —esa la ve finanzas—, sino el coste unitario por familia de consulta, que es donde las decisiones del libro se convierten en dinero: el juez del dieciséis solo en fácticas críticas, el tamiz con ancho calibrado, el presupuesto del trece contado. El coste unitario es la métrica que permite negociar calidad con números en la mano: qué costaría subir la certificación a las sintéticas, y qué ahorra bajarla de las que nunca la usan.
El hábito semanal, no el panel decorativo
La trampa final de la observabilidad es convertirla en decoración: paneles hermosos que nadie mira, alarmas que nadie atiende. La defensa que sobrevivió en el despacho es de calendario, no de tecnología: una revisión semanal corta —media hora, con el diario y las cinco señales— donde el acceso se lee como se lee un libro de caja. Tres preguntas la estructuran: ¿qué consultas se quedaron sin respuesta y cuáles de esas son huecos reales?, ¿qué filtro se comió más candidatos de la cuenta y por qué?, ¿qué consultas caras o lentas superaron su línea? Media hora semanal que el equipo, al principio, vivía como burocracia y acabó defendiendo como la herramienta de diagnóstico más rápida del sistema: casi todo incidente del acceso deja su huella en el diario días antes de llegar como queja.
Una nota final de honestidad: la observabilidad perfecta no existe y perseguirla es la forma más cara de procrastinar. El mínimo vital de este capítulo —el diario completo, las cinco señales, la media hora semanal— cubre el 95 por ciento de las preguntas que el equipo se hará; el resto se construye cuando una pregunta real lo pida, no antes.
Criterio de salida
Diario de consulta completo en producción —texto, filtros aplicados y descartes por fase, veredictos, ensamblado, latencia por fase, coste unitario y, si la interfaz lo da, la huella del usuario—, con retención y accesos definidos en el contrato. Las cinco señales revisadas en rutina semanal: vacíos, filtros vaciadores, cabeza vivida, latencia, coste. Ninguna consulta sin respuesta se pierde sin registro.
Las cinco señales alimentan un destino que solo se ha anunciado: las consultas sin respuesta y los filtros que vacían tienen que volver al corpus en forma de trabajo. Esa vuelta —el bucle que cierra las dos mitades de la serie— es el último capítulo técnico del libro.