Conservative SmartOS global-zone memory pressure guard with dry-run-first policy and SMF integration.
No puede seleccionar más de 25 temas Los temas deben comenzar con una letra o número, pueden incluir guiones ('-') y pueden tener hasta 35 caracteres de largo.
 
 
 
 
psarria cbedc4fdfe Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
etc Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
logs Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
smf Release o6h-memory-guard 1.0.5 hace 1 mes
src Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
tests Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
.gitignore Audit PCKILL results and bound rescue validation in v1.0.8 hace 1 mes
AUDIT_PCKILL_LATENCY_2026_09_28.md Release o6h-memory-guard 1.0.9 hace 1 mes
CHANGELOG.md Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
CHECKPOINT.md Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
INCIDENT_FLOOR_KILL_FAILED_2026_09_23.md Audit PCKILL results and bound rescue validation in v1.0.8 hace 1 mes
INCIDENT_PAGEOUT_DEADMAN_2026_09.md Release o6h-memory-guard 1.0.4 hace 1 mes
INCIDENT_PAGEOUT_DEADMAN_AVOIDED_2026_09_21.md Release o6h-memory-guard 1.0.6 hace 1 mes
INCIDENT_PAGEOUT_DEADMAN_PANIC32_2026_09_22.md Harden panic32 rescue path for v1.0.7 hace 1 mes
INCIDENT_PAGEOUT_DEADMAN_PANIC33_2026_10_08.md Release o6h-memory-guard 1.0.10: persistent FLOOR and incremental cache hace 1 mes
INCIDENT_PAGEOUT_DEADMAN_PANIC34_2026_10_09.md Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
Makefile Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
README.md Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
SHA256SUMS Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
VALIDATION.md Prepare o6h-memory-guard 1.0.11: staged minfree deadman risk hace 1 mes
install.sh Release o6h-memory-guard v1.0.2 hace 1 mes

README.md

o6h-memory-guard 1.0.11

panic34: riesgo VM persistente alrededor de minfree

v1.0.11 añade persistent_minfree_deadman_risk sin cambiar los umbrales de estado, ranking, protecciones, gracias TERM/KILL ni transporte PCKILL. Una única muestra FLOOR nunca abre16: FLOOR inmediato sigue limitado a12. Para13–16 se necesita FLOOR persistente según v1.0.10, o el nuevo camino escalonado descrito abajo. No se aplica la propuesta de FLOOR inmediato a16 del documento inicial: la aclaración del operador la descartó expresamente.

Configuración distribuida:

DEADMAN_RISK_MARGIN_PAGES 1024
DEADMAN_RISK_SECONDS 5
DEADMAN_RISK_SAMPLES 6
DEADMAN_RISK_NSCAN_ACTIVE_SAMPLES 3
DEADMAN_RISK_ANONPGOUT_ACTIVE_SAMPLES 4

Ventana fija preasignada (máximo32 muestras): por defecto al menos5 de6 cerca de minfree (free<=minfree+1024 y free<desfree),3 con nscan>0 y4 incrementos anónimos entre pares consecutivos, durante al menos5 segundos monotónicos. Debe haber EMERGENCY y escasez actual dentro de la banda; no crea un estado nuevo. Un nscan=0 aislado no borra la ventana. Anon debe ser válido, sin reset de contador en la ventana; swap físico se registra como corroboración, no es trigger ni requisito de crecimiento. El delta físico es firmado (es un gauge).

Al agotarse8 y confirmarse el riesgo, el escalón1 autoriza hasta12. Después de tres segundos adicionales de riesgo continuo desde ese primer override, escalón2 autoriza hasta16. Una recuperación pausa esa continuidad: exige tres segundos nuevos de riesgo para promover de1 a2. Si2 ya se ganó, se conserva pero sólo se usa con evidencia actual de riesgo. FLOOR persistente conserva su vía independiente a16; FLOOR aislado no salta el segundo escalón.

RECOVERY breve conserva víctimas, etapa de override, caché y muestras (no permisos de actuar con memoria recuperada). RECOVERY estable hasta NORMAL reinicia ventana/override/presupuesto, conservando la ventana móvil de rate limit existente. Los overruns no borran el historial. Para no autorizar con datos antiguos se rechaza una ventana que abarque más de3 veces DEADMAN_RISK_SECONDS y un permiso VM de más de1,5 segundos. El refresco actual debe seguir en la banda, con contador anónimo válido y sin retroceder.

Rangos validados: margen0–65536 páginas, duración5–60 s, muestras6–32, nscan activo1–N y anon activo1–(N-1); duplicados/valores inválidos se rechazan. Con muestreo de1 s conviene N>=duración+1: por ejemplo,6 muestras para5 s. Valores incompatibles con la cadencia pueden impedir el override, no relajarlo.

El scanner VM se distingue del scanner /proc: vm_page_scanner_active es la corroboración de nscan por ventana; proc_scanner_complete/ proc_scan_complete indican la situación del recorrido de procesos. Un scan incompleto o antiguo no inhibe el override si hay identidades revalidables. Si no las hay: action_blocked reason=no_revalidatable_candidate, con cache_entries/rejected_entries/latest_complete_age_ms/proc_scan_complete.

Observabilidad asíncrona, después del rescate:

  • deadman_risk active=0|1: sólo cambios, con contadores de ventana y deltas anónimo/físico y sus flags de validez.
  • budget_override reason=persistent_minfree_deadman_risk, from_limit=8, to_limit=12; segundo escalón: reason=persistent_minfree_deadman_risk_continues, from_limit=12, to_limit=16. Sólo cambios de escalón.
  • budget_override_blocked: persistencia insuficiente, scanner VM inactivo o anon sin crecimiento; como máximo uno cada30 s.
  • Presupuesto: episode_victims_total/current_budget_tier/current_limit, normal_limit/emergency_limit/floor_limit/absolute_limit y override_stage. Se retiran los cuatro *_used ambiguos: eran el mismo total repetido, no cuotas. Los límites siguen siendo acumulados, nunca sumables. El tier floor/absolute nombra el techo vigente, aunque se alcance por riesgo VM sin floor=1. override_stage describe sólo el camino de riesgo VM; la vía FLOOR persistente conserva su evento persistent_floor independiente.

Fixture sintético: panic34_persistent_minfree_budget_exhaustion_2026_10_09.csv. Informe: INCIDENT_PAGEOUT_DEADMAN_PANIC34_2026_10_09.md. No se promete que más víctimas hubieran evitado el panic. Source-only; no se cambian swap ni SLOG.

panic33: vía FLOOR y caché incremental conservadas

Presupuestos acumulados del mismo episodio: normal 4, emergency 8, floor 12 y MAX_HARD_FLOOR_VICTIMS_EPISODE 16. No son cuotas sumables. Se exige normal <= emergency <= floor <= hard <=16, con floor<=12 desde v1.0.11. Se rechaza una configuración FLOOR16 para no habilitar16 sin persistencia. TERM+KILL cuenta una sola identidad.

En la vía FLOOR, el tramo adicional requiere EMERGENCY, FLOOR (free<=minfree/2), floor normal agotado, nscan>0 y delta reciente positivo/válido de anon_pageout. Debe persistir cinco segundos/seis muestras, con separación máxima de 1,5 s. Una muestra aislada, hueco, contador reseteado/delta no positivo, pageout desconocido o recuperación invalida el permiso. El refresco antes de actuar debe seguir en FLOOR, con pageout válido, scanner activo y autorización de antigüedad <=1,5 s. Nunca se mata sólo por métricas de swap/pageout. Swap físico sigue teniendo deltas 5/15/60: es un gauge que puede bajar y no se exige su crecimiento para autorizar el override. Los relojes son monotónicos.

RECOVERY breve conserva víctimas, rate limit y caché, pero exige nueva persistencia para otro override. Sólo RECOVERY estable durante RECOVERY_SECONDS (free>=lotsfree, nscan=0) hasta NORMAL reinicia el presupuesto. Un fallo de muestreo inhibe acciones sin regalar un episodio nuevo.

El scanner publica cada candidato elegible antes de continuar, fusionando 16 entradas y conservando supervivientes mejores. ENOENT/ESRCH/ESTALE invalidan identidades; hay memoria acotada de 64 rechazos, reiniciada tras recuperación estable. Toda acción sigue revalidando PID/start/UUID/generación/allow/protect. En presión se solicita scan cada segundo sin esperar. Al agotar SCAN_BUDGET_MS se conserva el cursor para no comenzar siempre por los mismos PID. Un recorrido reanudado sigue marcado incompleto incluso al llegar a EOF: no renueva la fecha del último scan completo. Ranking y pesos no cambian; el componente de zona de un parcial usa los datos disponibles y puede subestimar su total. Un parcial no reemplaza una entrada mejor por una peor.

Límite temporal: el presupuesto es cooperativo entre operaciones. No interrumpe una syscall /proc bloqueada. Los candidatos publicados antes del bloqueo siguen disponibles, pero no se promete descubrir otros hasta que retorne. Rescate no espera el mutex del scanner (trylock); no se crean hilos ilimitados ni se altera PCKILL, logger o syslog asíncrono.

Eventos conservados: victim_budget tier=normal|emergency|floor|hard_floor|absolute con used/limit/remaining/mode al consumir víctima o cerrar episodio; budget_override reason=persistent_floor (LOG_CRIT) por víctima adicional. Bloqueos: el total y los límites se separan explícitamente desde v1.0.11; añaden nscan y anonpgout_delta/anonpgout_delta_ok. Las muestras incluyen hard_floor_ready y persistent_floor_samples.

Informe: INCIDENT_PAGEOUT_DEADMAN_PANIC33_2026_10_08.md. Fixture sintético: panic33_persistent_floor_budget_exhaustion_2026_10_08.csv. No garantiza evitar un deadman. Source-only, sin cambios de swap/zvol, dry-run por defecto y sin UUID autorizados.

Primera implementación para SmartOS global zone: daemon C de 64 bits, libkstat, /proc, identidad UUID + generación de zona + PID + instante de creación, configuración separada y servicio SMF. Entrega de código fuente; no contiene un binario nativo validado en SmartOS. Véase VALIDATION.md.

Una instalación nueva arranca en dry-run porque la configuración distribuida contiene ACTION_MODE dry-run. El manifiesto SMF de producción no fuerza ese modo: la configuración es la única fuente de la política de acción. No se entrega ninguna zona autorizada. Esta revisión no se ha desplegado, no ha activado armed y no ha enviado señales reales.

Instalación nueva
→ ACTION_MODE dry-run
→ SMF no fuerza dry-run

Activación real
→ el operador cambia explícitamente ACTION_MODE armed
→ reinicia SMF
→ armed_warmup=60 sigue aplicando

Documentación de la entrega

  • README.md: instalación, semántica, política, operación y rollback.
  • VALIDATION.md: validación local realizada al construir esta entrega y comprobaciones nativas que en ese momento quedaban pendientes.
  • CHECKPOINT.md: checkpoint operativo posterior, incorporado sin cambios, con la evidencia acumulada de compilación, ejecución y logging de v1.0.2 en SmartOS real, además del estado exacto y los requisitos antes de armed.
  • INCIDENT_PAGEOUT_DEADMAN_2026_09.md: cronología del panic real observado con v1.0.2, endurecimiento de v1.0.3 y corrección del ranking global en v1.0.4.
  • INCIDENT_PAGEOUT_DEADMAN_AVOIDED_2026_09_21.md: evidencia de campo de un episodio en el que la acción real liberó memoria antes de un nuevo panic.
  • INCIDENT_PAGEOUT_DEADMAN_PANIC32_2026_09_22.md: análisis del panic32, el stall de 145 s y el rediseño no bloqueante de v1.0.7.
  • CHANGELOG.md: evolución de versiones y revisión documental del paquete.

El checkpoint es cronológicamente posterior a VALIDATION.md; por ello amplía sus resultados de campo sin cambiar el código ni autorizar el modo armed.

Instalación inicial y activación en dry-run

Los comandos siguientes se ejecutan por el operador, como root en la global zone. Requieren gcc de 64 bits, cabeceras nativas y GNU make (gmake) en PATH. Si no hay herramientas de desarrollo, compilar en una zona nativa SmartOS de la misma plataforma (no LX), ejecutar allí gmake test, y copiar el binario junto a este árbol al host. No instalar un compilador en un nodo bajo presión.

Copiar el archivo distribuido a /var/tmp/o6h-memory-guard-1.0.11.tar.gz:

mkdir -p /opt/custom/src
cd /opt/custom/src
gzip -dc /var/tmp/o6h-memory-guard-1.0.11.tar.gz | tar -xf -
cd /opt/custom/src/o6h-memory-guard
gmake CC=gcc
gmake test CC=gcc
file ./o6h-memory-guard
ldd ./o6h-memory-guard
sh ./install.sh

file debe identificar un ELF nativo de 64 bits. ldd no debe mostrar dependencias ausentes. El instalador sólo copia archivos y valida el manifiesto; no importa ni inicia servicios, y rechaza sobrescribir una instalación existente. Si ya se copió un binario compilado en una zona nativa, omitir gmake CC=gcc en la global zone; conservar los resultados de compilación y pruebas.

Inventariar UUID y alias fuera del daemon:

vmadm list -o uuid,alias
vi /opt/custom/etc/o6h-memory-guard.conf

Añadir una línea por zona, con UUID real y alias sin espacios:

zone <UUID-real-de-web5> web5 allow
zone <UUID-real-de-base-de-datos> database protect
zone <UUID-real-de-monitorizacion> monitoring protect

Esos marcadores no son valores válidos: sustituirlos, incluidos los signos < >. allow hace elegible una zona para las simulaciones; no habilita señales mientras el servicio esté en dry-run. protect, observe o la ausencia de una regla excluyen la zona de toda acción. Sin reglas allow el monitor funciona y registra métricas/top de procesos, pero informa no_authorized_candidate.

/opt/custom/bin/o6h-memory-guard --check-config --force-dry-run
/opt/custom/bin/o6h-memory-guard --probe --force-dry-run
svccfg validate /opt/custom/smf/o6h-memory-guard.xml
svccfg import /opt/custom/smf/o6h-memory-guard.xml
svcadm enable -s svc:/site/o6h-memory-guard:default
svcs -xv svc:/site/o6h-memory-guard:default
svcprop -p start/exec svc:/site/o6h-memory-guard:default
tail -f /opt/custom/var/log/o6h-memory-guard/guard.log

Verificar mode=dry-run en event=start, ausencia de --force-dry-run en start/exec, arc_ok=1, swap_committed_ok=1, swap_physical_used_ok=1, anon_pageout_ok=1 y proc_scan complete=1. No generar presión artificial en producción. Para comprobar selección y UUID, revisar candidate, zone y top_process durante carga natural; WOULD_ACTION sólo aparece si se alcanzan los umbrales y hay candidato autorizado. --probe lee una muestra y sale sin locks, logs ni acciones; --check-config sólo valida configuración y permisos.

Para que se active automáticamente tras un reinicio de SmartOS, después de validar este arranque editar únicamente create_default_instance a enabled="true" en el manifiesto persistente y volver a importarlo:

vi /opt/custom/smf/o6h-memory-guard.xml
svccfg validate /opt/custom/smf/o6h-memory-guard.xml
svccfg import /opt/custom/smf/o6h-memory-guard.xml

Mantener ACTION_MODE dry-run durante toda la validación inicial. La ubicación /opt/custom/smf se utiliza para servicios personalizados persistentes de SmartOS; no depender exclusivamente del estado habilitado de la instancia en el repositorio del arranque actual. --force-dry-run sigue disponible para --probe, pruebas y validaciones manuales, pero no pertenece al método SMF.

Métricas y ventanas

Cada segundo se leen unix:0:system_pages:{freemem,lotsfree,desfree,minfree,nscan, pp_kernel,pageslocked}, cpu:*:vm:anonpgout y zfs:0:arcstats:size mediante libkstat. swapctl(SC_AINFO) proporciona asignación, reserva y disponibilidad de swap virtual, equivalente a swap -s. La métrica inequívoca es swap_committed_pages = allocated + reserved, e incluye compromiso anónimo que puede seguir residente en RAM; no representa pageout ni bytes escritos en el zvol. La reserva aún no asignada es ani_resv - (ani_max - ani_free).

Por separado, swapctl(SC_LIST) obtiene las mismas entradas que swap -l. swap_physical_used_bytes suma (blocks - free) * 512 de todos los dispositivos; los campos nativos de la API están en páginas y se convierten primero a los bloques de 512 bytes que muestra la utilidad. Esta cifra sí representa ocupación física del swap configurado. Con la validación observada: swap -s indicó unos 28,5 GiB comprometidos, mientras swap -l indicó sólo 8.093.064 bloques usados, es decir 4.143.648.768 bytes (unos 3,86 GiB). No deben compararse como si fueran la misma magnitud.

El log conserva unidades: páginas para VM/compromiso virtual/pageout, bytes para ARC y swap físico, KiB para RSS. page_bytes se obtiene de sysconf, nunca se presupone 4096. nscan es una medida del scanner, no un contador acumulativo; su delta se registra como cambio de la medida y no se interpreta como tasa de pageout.

Historias circulares con timestamps monotónicos, deltas 5/15/60 s para libre, kernel, locked, ARC, compromiso/disponibilidad virtual, ocupación física de swap, pageout anónimo y nscan. Los deltas incluyen la edad real (-100@5.02s). Se exige una muestra a ±1,25 s de la ventana; si falta, sale NA, sin inventar ceros. /proc se recorre cada 5 s en NORMAL y cada 1 s bajo lotsfree; RSS y crecimiento de procesos/zonas usan las mismas ventanas.

El contrato de cada event=sample expone los tres pares inequívocos swap_committed_ok/swap_committed_pages, swap_physical_used_ok/swap_physical_used_bytes y anon_pageout_ok/anon_pageout_pages. Cada muestra va seguida por líneas event=delta con esos tres nombres exactos y d5, d15 y d60. swap_used_pages no es un nombre válido. Se conservan como diagnóstico auxiliar swap_alloc_pages, swap_reserved_pages y swap_available_pages: son los componentes de compromiso virtual de SC_AINFO, todos en páginas, y ninguno representa bytes escritos en el dispositivo swap.

En los datos originales, 425950 > 130875 páginas y nscan=0 corresponden a NORMAL. Los valores de 130875/65437/49077 páginas no están codificados como umbrales: se vuelven a leer del kernel. ARC y pp_kernel son diagnóstico, nunca una prueba de que un proceso concreto causó la presión.

Estados y acción

Estado/condición de entrada Comportamiento predeterminado
NORMAL Sin intervención; muestreo VM de 1 s.
PRE-PRESSURE Bajo lotsfree durante 1 s monotónico por defecto; refresca candidatos, sin señales.
PRESSURE Bajo lotsfree durante 2 s, o caída rápida corroborada; no exige que nscan haya arrancado. Refresca candidatos cada segundo.
CRITICAL Bajo desfree con presión corroborada continua durante 2 s; usa caché, sin scan nuevo, y propone TERM.
EMERGENCY free <= minfree; entrada inmediata. Usa caché y gracia TERM de 1 s.
Floor free <= minfree/2; KILL directo por defecto (FLOOR_KILL_DELAY_SECONDS=0).
RECOVERY Desde CRITICAL/EMERGENCY al recuperar desfree; NORMAL sólo tras 15 s estables con free >= lotsfree y nscan=0.

La entrada temprana a PRESSURE depende de persistencia bajo lotsfree o caída clara y no espera a que el scanner arranque. nscan > 0, caída respecto a la muestra anterior y delta libre negativo siguen corroborando gravedad. Bajo lotsfree, el crecimiento simultáneo en 5 s de swap_physical_used_bytes y anon_pageout_pages corrobora presión. La ocupación física jamás es un trigger único: sin pageout creciente y memoria bajo lotsfree no cambia el estado. El compromiso virtual tampoco se interpreta como pageout. Los tiempos son segundos monotónicos transcurridos, no número de filas leídas. Un sampling_overrun no borra el tiempo ya observado bajo un umbral: si las muestras llegan en t+1,8 y t+4,2, la segunda puede confirmar PRESSURE aunque no existan filas exactas por segundo. Si después de un retraso la siguiente muestra salta desde encima de desfree a free <= desfree, entra directamente en CRITICAL; free <= minfree siempre entra directamente en EMERGENCY. El state_transition registra reason=threshold_jump y skipped_states cuando se omiten estados intermedios. Sólo una muestra inválida, obsoleta o con reloj monotónico no creciente reinicia la confirmación. La gravedad se retiene hasta recuperar desfree; action_pressure indica si el estado retenido aún permite una decisión de rescate.

Las gracias son configurables: 5 s en CRITICAL, 1 s en EMERGENCY y 0 s al floor por defecto. Una lectura kstat fresca debe seguir bajo desfree. Recuperar desfree cancela cualquier TERM pendiente y entra en RECOVERY. Se mantiene como máximo una decisión de señal por tick; si una identidad desaparece o reutiliza el PID se prueba el siguiente candidato cacheado sin recorrer /proc completo.

En NORMAL/PRESSURE/CRITICAL rigen 4 víctimas por episodio y 4 por ventana móvil de 60 s. EMERGENCY puede superar esos límites normales hasta 8 víctimas por episodio; floor tiene un límite normal de 12 y hard-floor un techo absoluto de 16. Cada override se registra como victim_budget_override=emergency|floor. TERM+KILL del mismo proceso cuentan como una víctima. Los límites 4/8/12 son configurables pero deben mantener ese orden y no superar el techo hard-floor de 16. El episodio sólo se reinicia tras RECOVERY estable hasta NORMAL, no tras un error de muestreo. En armed, los primeros 60 s desde el arranque monotónico del daemon inhiben únicamente las señales, también en EMERGENCY, para evitar eludir el límite por minuto mediante reinicios. La detección, el muestreo, los scans permitidos por estado y la reconstrucción del candidate_cache continúan durante ese warmup. Cada bloqueo se registra como event=action_blocked reason=armed_warmup elapsed_seconds=... required_seconds=60. Los contadores son en memoria; el presupuesto por episodio sí se reinicia al reiniciar el daemon. Revisar esta elección antes de usarlo como mecanismo de rescate. No hay garantía de evitar un panic.

Atribución y protecciones

Cada scan completo recorre todos los procesos elegibles de todas las zonas allow y construye un ranking global; no existe una preselección de la mejor zona. La caché interna conserva 16 candidatos y el log muestra sólo los tres primeros para limitar ruido. El score en KiB equivalentes es:

total_score = RSS + 4*max(d5,0) + 2*max(d15,0) + max(d60,0)
              + zone_component

zone_component incorpora zone_rss/64 y crecimiento positivo de zona d5/16, d15/32 y d60/64, pero queda limitado a process_rss/4. Así una zona enorme aporta contexto sin poder monopolizar el ranking; un proceso estable de 1,3 GiB supera normalmente a uno de 250 MiB, mientras un proceso menor con crecimiento explosivo todavía puede ascender. Se usa el mismo ranking balanceado en todos los estados. La caché fija de 16 entradas permite consumir los budgets 8/12 sin nuevo scan y conserva la ruta CRITICAL/EMERGENCY/FLOOR O(Ncache), con N fijo y pequeño. Empates se resuelven por RSS y después PID. El log expone rss_component, growth5_component, growth15_component, growth60_component, zone_component y total_score.

Cada entrada conserva identidad, alias, RSS y d5/d15/d60. La suma de RSS por zona puede contar memoria compartida varias veces: es una aproximación de atribución, no memoria física exclusiva ni memoria garantizada que se recuperará al terminar un proceso.

El UUID es el nombre de zona devuelto por el kernel, validado como UUID canónico en minúscula (convención SmartOS). Se conserva además ZONE_ATTR_UNIQID; se consulta ZONE_ATTR_INITPID. Los alias son etiquetas del catálogo del operador, no se obtienen mediante comandos ni se usan para autorizar señales. Un alias renombrado debe actualizarse manualmente. En illumos con nombres de zona que no sean UUID, el muestreo funciona pero esas zonas quedan excluidas de acciones.

Protecciones obligatorias: global zone completa; PID 0/1 y proceso propio; padre 0; procesos sin LWPs; init de cada zona; identidades no resueltas o sin generación; zonas sin regla allow; RSS menor de 64 MiB por defecto. También se excluyen los nombres init, systemd, svc.startd, svc.configd, sshd, zoneadmd, vminfod, vmadmd, qemu, qemu-system-x86, bhyve y el guard. Las protecciones se aplican incluso al floor y prevalecen sobre toda autorización.

protect_process añade nombres exactos pr_fname de hasta 15 caracteres, sin comodines ni argumentos; protect_pid añade PID global, no PID visto dentro de LX. La config entregada añade PostgreSQL, MySQL/MariaDB, Redis y Zabbix. Las zonas de base de datos/infraestructura deben figurar como protect. Los nombres pueden cambiar/truncarse y no constituyen una frontera contra un proceso malicioso: la protección por UUID completo es la más robusta.

Antes de actuar se comprueban UUID, generación, PID, inicio, nombre, UID/EUID, init, RSS y reglas. Se abren psinfo/ctl respecto al mismo descriptor de directorio /proc y se envía PCKILL al descriptor, no a un número PID mediante kill(2). El inicio de un PID reutilizado invalida el candidato. Cambios de nombre/UID ya visibles también lo invalidan. Queda la carrera inherente de un exec ordinario entre la última lectura de psinfo y la escritura: no se detiene el proceso para eliminarla. No se tocan flags de tracing, no se usa kill-on-close ni señales a grupos. La integración de esta ruta todavía necesita validación nativa de laboratorio.

En dry-run nunca se abre ctl: se revalida con lecturas, se escribe WOULD_ACTION=SIGTERM/SIGKILL y se actualiza sólo el estado simulado. Los presupuestos evitan repetir infinitamente el mismo sacrificio hipotético. En armed no se escribe nada antes de la operación real: se valida, se intenta la señal, se actualizan counters en memoria y sólo entonces se encolan action_decision, action_result y, si hubo éxito, signal_sent. Los errores de escritura de señal consumen presupuesto para evitar reintentos ambiguos.

Recursos y fallos

v1.0.9 añade pckill_timing con proc_ctl_open_latency_ms (durante validación), pckill_prepare_latency_ms, pckill_write_latency_ms y pckill_total_latency_ms. El total es prepare+write; no incluye validación ni apertura. El intervalo write incluye desprogramación y no demuestra por sí mismo una causa del kernel. Si supera 100 ms se encola signal_dispatch_slow, sin cambiar la acción. La auditoría y el procedimiento para atribuir la espera están en AUDIT_PCKILL_LATENCY_2026_09_28.md.

action_blocked distingue free_above_desfree (free >= desfree, muestra válida, informativo) de refresh_failed (fallo o muestra caducada). Incluye memoria, refresh_ok, candidate_source, error y latencia. refresh_ok=-1 indica que no se intentó el refresco. Con fallo, sample_source=last_sample identifica los datos anteriores del llamador. Se sigue suprimiendo toda acción cuya presión no pueda confirmarse.

Desde v1.0.8, la preparación ocurre en 16 trabajadores preasignados. La espera del hilo de rescate se limita a 250 ms en CRITICAL, 100 ms en EMERGENCY y 50 ms en FLOOR. Si vence, abandona ese candidato y prueba el siguiente. Los trabajadores nunca envían señales: sólo rescate usa un descriptor preparado y vigente. Un resultado tardío se descarta y su cierre ocurre en el trabajador. Si todos quedan bloqueados, se rechaza por EBUSY sin crear más hilos. Son presupuestos por candidato: máximo 16 entradas y una escalada pendiente por pasada.

Se conserva PID, inicio, UUID/generación, allow/protect y cooldown. La identidad se lee una sola vez por preparación. El último refresco sólo lee freemem con kstat propio; no enumera swap/CPU ni consulta ARC. El muestreo general conserva esas métricas. Los límites controlan la espera, sin garantizar planificación en tiempo real ni una duración máxima de PCKILL dentro del kernel.

action_result usa syscall=write operation=PCKILL attempted=1 rc=... errno=... y errno_name. rc es el retorno en bytes de write, no el retorno de kill(2). La escritura completa equivale a éxito y fuerza errno 0. Una escritura parcial se distingue por transport_status=short_write y no se reintenta. Los rechazos llevan syscall=none attempted=0 errno_origin=validation. No hay timestamps de intento inventados; signal_sent exige escritura completa.

candidate_validation descompone PID, inicio, zona, generación, política, protecciones, cooldown, open/read/parse y memoria. Cooldown incluye la decisión de política en memoria. Algunas medidas se solapan (PID/open), por lo que no se suman; validate_total_ms incluye espera y preparación. validation_late_result discarded=1 informa cuando termina un trabajo expirado. dispatch_latency_ms y action_dispatch_latency_ms miden decisión → retorno: validación + entrega/planificación + syscall, sin logging. kill_latency_ms sólo mide la syscall. Decisión → entrada se obtiene restando decision_mono de kill_attempt_mono.

INCIDENT_FLOOR_KILL_FAILED_2026_09_23.md documenta FLOOR486, la ambigüedad de EAGAIN en v1.0.7 y el PASS real del logger. La recuperación no se atribuye al SIGKILL fallido y la selección de víctimas no se confunde con atribuir causas.

Almacenamiento fijo para 4096 procesos, 256 zonas, 16 candidatos y una cola de 512 eventos, reservado al arrancar; el tamaño se registra. No hay malloc de la aplicación en la ruta de acción, ni system, popen, exec, vmadm, ps o vmstat en el daemon. libkstat/libc sí pueden reservar memoria internamente al actualizar su cadena. No se promete cero asignaciones ni tiempo real estricto.

El recorrido /proc tiene presupuesto cooperativo de 200 ms (hasta 500 ms por configuración) y se ejecuta en un scanner independiente. Un scan incompleto o bloqueado no borra los supervivientes ni detiene el muestreo: publica candidatos parciales según se descubren. NORMAL solicita actualización cada 5 s; en presión, incluyendo CRITICAL/EMERGENCY/FLOOR, se solicita cada segundo. CRITICAL/EMERGENCY/FLOOR nunca esperan al scanner: recorren como máximo 16 entradas precomputadas y revalidan sólo el proceso elegido. Los 15 s de frescura siguen aplicándose en NORMAL/PRE/PRESSURE. En rescate, una entrada más antigua puede usarse como stale_cache_revalidated si PID, inicio, UUID, generación, regla allow, nombre y protecciones todavía coinciden. La caché sobrevive a EMERGENCY → RECOVERY → EMERGENCY; scans parciales pueden renovar sus entradas, mientras que un scan completo sano reconstruye el ranking global.

Muestras obligatorias ausentes/invalidas o demasiado lentas inhiben señales; ARC/swap/pageout opcionales ausentes se marcan con *_ok=0 y no bloquean por sí solos. Un fallo o stall del log ya no inhibe acciones. El hilo principal encola con pthread_mutex_trylock; nunca espera al logger. Si la cola está ocupada o llena, descarta telemetría y acumula dropped_events. El worker realiza escritura, rotación y syslog, y genera posteriormente logging_delivery o logging_stall con latencias por canal. No hay fsync; las últimas líneas pueden perderse por drop, alimentación o panic. Es observabilidad best-effort, no un journal de transacciones de señales. No se cambia swap, ARC ni caps de zona. La enumeración física admite hasta 64 dispositivos swap con almacenamiento fijo; si el nodo supera ese límite, swap_physical_used_ok=0 y esa señal diagnóstica se omite sin autorizar acciones.

Un lock fcntl evita dos instancias (incluso una manual y otra SMF); el PID guardado es diagnóstico, nunca se usa para señalizar. Config/locks/logs exigen propietario root, archivo regular de un enlace, destino sin symlink y directorios resueltos sin escritura para grupo/otros. Directorios /opt con symlinks legítimos de root se admiten al resolver su destino. SIGHUP sólo reabre el log; la configuración se recarga reiniciando el servicio. SIGTERM/SIGINT al daemon solicitan salida limpia.

Logging y mantenimiento

/opt/custom/bin/o6h-memory-guard
/opt/custom/etc/o6h-memory-guard.conf
/opt/custom/smf/o6h-memory-guard.xml
/opt/custom/var/run/o6h-memory-guard.lock
/opt/custom/var/log/o6h-memory-guard/guard.log
/opt/custom/var/log/o6h-memory-guard/guard.log.1 ... guard.log.5

Rotación interna: 10 MiB por archivo y 5 copias, aproximadamente 60 MiB máximos. El volumen de líneas por segundo puede hacer que la retención sea inferior a un día; aumentar LOG_MAX_MIB/LOG_KEEP o recoger logs externamente si se necesita un estudio de varios días. No configurar copytruncate/logadm simultáneamente. Snapshots de todas las zonas y top 20 procesos cada 60 s normal / 5 s en presión. Las muestras de 1 s posteriores a las acciones permiten revisar la recuperación en 1/2/5/10 s, siempre que no haya overruns. No se registran argumentos de procesos. logs/policy-tests.log y logs/runtime-tests.log proceden de pruebas locales; no son datos del nodo. logs/example.log es un ejemplo sintético de formato. Los eventos state_transition, candidate_cache, action_decision y recovery_check permiten reconstruir el estado, origen/rank/edad del candidato, resultado del último scan, componentes del score y cualquier override de presupuesto.

Syslog nativo selectivo

guard.log sigue siendo el registro detallado principal; bajo saturación puede perder eventos antes que bloquear una señal. Con SYSLOG_ENABLED yes se envía además un subconjunto operativo mediante openlog(3C), syslog(3C) y closelog(3C), con ident o6h-memory-guard y facility configurable local0…local7 (local5 por defecto). No se invoca logger, shell ni un proceso auxiliar. SYSLOG_ENABLED no lo desactiva.

Evento/condición Severidad
start, recovery_complete, transición a NORMAL/RECOVERY INFO
transición a PRE-PRESSURE NOTICE
transición a PRESSURE, action_blocked WARNING
transición a CRITICAL, SIGTERM ERR
transición a EMERGENCY/floor, SIGKILL, error interno grave CRIT

También se envían state_transition, signal_sent, action_blocked e internal_error. signal_sent se construye después de que el backend haya confirmado el envío real e incluye estado, señal, UUID, alias, PID, nombre, RSS y memoria libre; nunca existe en dry-run. sample, delta, candidate_cache, top_process, proc_scan y zone no se duplican en syslog. Un fallo al enviar a syslog se ignora para la decisión: syslog se ejecuta exclusivamente en el worker y no puede preceder ni cambiar el resultado de una señal.

Los eventos de acción incluyen decision_mono, kill_attempt_mono, kill_return_mono, dispatch_latency_ms, candidate_validate_latency_ms, kill_latency_ms y log_enqueue_latency_ms. El worker mide además guard_log_write_latency_ms y syslog_latency_ms. Así se distingue un retraso de validación/señal de un stall posterior del canal de observabilidad.

Antes de asumir un archivo de destino, inspeccionar la configuración local:

grep -v '^[[:space:]]*#' /etc/syslog.conf

Localizar allí el destino de local5; el guard no modifica syslog.conf ni presupone /var/adm/messages. Un reenvío futuro a syslog central o mediante Alloy/Loki puede configurarse fuera del guard, pero esta entrega no lo hace.

Modelo de activación real (operación futura; no ejecutada en esta entrega)

v1.0.11 debe compilarse y observarse primero en SmartOS con ACTION_MODE dry-run. El manifiesto ya no contiene una segunda puerta oculta. Cuando exista aprobación operativa explícita, el único cambio de modo es editar la configuración:

vi /opt/custom/etc/o6h-memory-guard.conf
# cambiar exactamente: ACTION_MODE dry-run  →  ACTION_MODE armed
/opt/custom/bin/o6h-memory-guard --check-config
svcadm restart svc:/site/o6h-memory-guard:default

Mantener las reglas UUID allow mínimas y verificar antes las protecciones y el laboratorio nativo. Tras el restart, comprobar event=start mode=armed; durante los primeros 60 s armed_warmup inhibe señales, aunque la detección y la caché siguen activas. No se proporciona un script que arme automáticamente el servicio.

Para volver a dry-run, restaurar ACTION_MODE dry-run, validar la configuración y reiniciar SMF. No es necesario editar el manifiesto.

Parada, rollback y actualización

Parar el guard sin borrar evidencia:

svcadm disable -s svc:/site/o6h-memory-guard:default
svcs -p svc:/site/o6h-memory-guard:default

Si se habilitó el arranque persistente, volver a enabled="false" e importar el manifiesto para mantenerlo deshabilitado en próximos arranques. Para retirar el servicio conservando los archivos y logs:

mkdir -p /opt/custom/var/backups/o6h-memory-guard
mv /opt/custom/smf/o6h-memory-guard.xml /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.disabled
svccfg delete svc:/site/o6h-memory-guard:default

Comprobar antes que el destino de backup no exista y elegir un nombre distinto si ya se utilizó. El manifiesto sale del directorio de importación automática; binario/config/logs permanecen recuperables. No eliminar ni truncar el lock de una instancia viva. Restaurar el manifiesto e importarlo permite reinstalar SMF.

Para actualizar: deshabilitar primero, conservar copias del binario, config y manifiesto en un directorio de backup nuevo, reemplazar el binario estando parado y validar los tres archivos. No reemplazar automáticamente la config ni perder las protecciones. Al migrar desde v1.0.2 es obligatorio fusionar explícitamente PRE_SECONDS=1, PRESSURE_SECONDS=2, las tres nuevas gracias, MAX_CACHED_CANDIDATE_AGE_SECONDS y los límites 8/12 del fichero distribuido; conservar 3/10 mantendría la detección lenta anterior. Validar con --check-config --force-dry-run antes de reiniciar. El instalador inicial se niega a sobrescribir por ese motivo.

La migración desde v1.0.3 a v1.0.4 no añade parámetros de configuración: cambia el algoritmo de ranking y su logging. Comparar el top‑3 global en SmartOS real antes de reemplazar el binario observado.

Upgrade del manifiesto desde v1.0.4 o anterior

Los manifiestos antiguos incluían --force-dry-run. Antes de retirarlo, comprobar el modo configurado. Si no se pretende activar señales en ese mismo restart, debe decir literalmente ACTION_MODE dry-run:

grep '^ACTION_MODE ' /opt/custom/etc/o6h-memory-guard.conf
/opt/custom/bin/o6h-memory-guard --check-config --force-dry-run
kstat -p unix:0:system_pages:freemem unix:0:system_pages:lotsfree

No hacer un restart innecesario cuando freemem esté cerca o por debajo de lotsfree: cada arranque reinicia armed_warmup=60 y, si el modo fuese armed, dejaría las señales inhibidas durante 60 s precisamente cuando podrían ser necesarias. Posponer el cambio hasta que el nodo esté estable.

Con memoria estable, conservar el manifiesto anterior y copiar el nuevo:

mkdir -p /opt/custom/var/backups/o6h-memory-guard
cp -p /opt/custom/smf/o6h-memory-guard.xml \
  /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.v1.0.4-forced-dry-run
cp /opt/custom/src/o6h-memory-guard/smf/o6h-memory-guard.xml \
  /opt/custom/smf/o6h-memory-guard.xml
svccfg validate /opt/custom/smf/o6h-memory-guard.xml
svccfg import /opt/custom/smf/o6h-memory-guard.xml
svcadm restart svc:/site/o6h-memory-guard:default

Comprobar tanto la definición importada como el proceso activo:

svccfg export svc:/site/o6h-memory-guard:default |
grep -A3 -B2 'o6h-memory-guard --daemon'

pgrep -fl o6h-memory-guard

Ambas salidas deben quedar sin --force-dry-run. Con la configuración distribuida, event=start debe seguir mostrando mode=dry-run.

Rollback del manifiesto anterior

Primero asegurar ACTION_MODE dry-run y comprobar de nuevo que la memoria está holgada respecto a lotsfree. Después restaurar la copia y reimportarla:

cp /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.v1.0.4-forced-dry-run \
  /opt/custom/smf/o6h-memory-guard.xml
svccfg validate /opt/custom/smf/o6h-memory-guard.xml
svccfg import /opt/custom/smf/o6h-memory-guard.xml
svcadm restart svc:/site/o6h-memory-guard:default

El rollback vuelve a añadir la puerta forzada del manifiesto antiguo. Registrar qué versión queda instalada para no confundir ese comportamiento con la política de configuración de v1.0.5.

Referencias revisadas

Las interfaces de atributos de zona dependen de la plataforma: confirmar con la versión exacta de SmartOS. La documentación revisada no sustituye la prueba de compilación/ejecución en ese host.