Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
watchdog.checkMódulo 36
Módulo de la plataforma
Issuance watchdog
Detecta una plataforma que emite leases o credenciales demasiado rápido, o que se ha quedado callada, leyendo el ledger en lugar de preguntar a la plataforma.
watchdog.check lee el ledger e informa de anomalías de ritmo en dos familias: concesiones de leases y emisión de credenciales mediante iam.assume y iam.warehouse. Lanza un rate-spike, un de un actor y . No importa nada de los módulos que vigila y no guarda nada.
Intralock · Leases · Parley · Fleet Map
Un producto Trustvice
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
EstadoNada ejecuta el vigilante con una programación
watchdog/check responde cuando se le llama. No hay cron, cola ni aviso conectado a él, así que un hallazgo solo se ve cuando algo lee la ruta. Llámalo desde tu propio planificador y envía findings a tus alertas.
Registro
El registro
Qué se registra
findings
Las anomalías encontradas. Vacío cuando nada está fuera de rango.
code
En cada hallazgo: rate-spike, burst o went-silent.
En cada hallazgo: el DID tras un burst, y null para los demás códigos.
observed
El recuento que disparó el hallazgo. 0 para went-silent.
baseline
La mediana de los intervalos anteriores para un spike, el límite de ráfaga para un burst y null para el silencio.
why
Una frase que indica los recuentos y la ventana.
scanned
Cuántos eventos del ledger leyó la comprobación.
background
Cuántos de ellos no eran de una familia vigilada.
tuning
Anulaciones opcionales por llamada, con nowMs para fijar el reloj.
Mecanismo
Paso a paso
Cómo funciona
Lee el ledger
GET /api/v1/acp/watchdog/check lista los eventos del ledger del workspace y conserva dos familias: coordination.lease, e iam.assume con iam.warehouse.
Compara el último intervalo
Los eventos se reparten en diez intervalos de 60 000 ms. Se lanza un rate-spike cuando el último intervalo es al menos cuatro veces la mediana de los anteriores, y al menos cinco.
Detecta la ráfaga de un actor
Se lanza un burst para un actor con diez eventos de una familia en 5000 ms. El hallazgo nombra al actor y el recuento.
Trata el silencio como hallazgo
Se lanza went-silent cuando una familia lleva ausente 15 minutos mientras llegaron al menos otros tres eventos del ledger en ese tiempo. Un ledger callado en todas partes no lanza nada.
Di lo que vio
La respuesta lleva findings, cuántos eventos se scanned, cuántos eran background y los tipos watched, para poder contrastar un hallazgo de silencio con el resto del tráfico.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/watchdog/check
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de watchdog.check
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
{
"at": "2026-11-01T09:15:00.000Z",
"findings": [
{
"code": "went-silent",
"family": "credential",
"actor": null,
"observed": 0,
"baseline": null,
"why": "no credential events at all while 14 other ledger events were written in the last 15 minutes – zero is not quiet when the ledger is still moving"
}
],
"scanned": 57,
"background": 41,
"watched": {
"lease": [
"coordination.lease"
],
"credential": [
"iam.assume",
"iam.warehouse"
]
}
}
Uso
Casos de uso
Cuándo lo usan los equipos
Un gestor que deja de registrar
Sigue emitiendo credenciales pero deja de anotarlas. El ledger sigue activo con otros tipos, así que went-silent salta para la familia credential.
Un agente desbocado
Un agente toma leases en un bucle cerrado. burst nombra su DID y cuántos tomó.
Muchos agentes a la vez
Una flota empieza a tomar leases a la vez. El último intervalo supera cuatro veces la mediana y salta rate-spike.
Una noche tranquila
Un tenant sin tráfico alguno no lanza ningún hallazgo, porque el silencio cuenta solo mientras siguen llegando otros eventos al ledger.
Cuándo usar otra cosa
Decidir una sola acción. La admisión es coordination.admit; el vigilante lee historial.
Encontrar agentes que se disputan un recurso. Usa detection.run.
Alertar. Devuelve hallazgos y no envía nada, así que conecta su salida a tus propias alertas.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Lee eventos del ledger, nunca la instantánea del propio coordinador, y no importa nada de los módulos que vigila.
No guarda estado: ni línea base, ni umbral aprendido, ni fijación, así que no hay nada que reescribir entre dos comprobaciones.
Una petición enrutada no puede escribir eventos de ledger coordination., así que quien llama no puede falsificar los eventos de lease que cuenta.
La línea base es una mediana, así que un pico no puede esconderse en su propio promedio.
No hace
Que el ledger esté completo. Si nunca se escriben los eventos, la única evidencia es un hallazgo went-silent, y solo mientras continúa otro tráfico.
Que un hallazgo sea un ataque. Un pico o ráfaga puede ser un despliegue legítimo; un hallazgo indica recuentos, no intención.
Que se alertara a alguien. Nada avisa a una persona desde esta ruta.
Detalles
Notas de construcción
Antes de construir
Ajuste
Una petición puede pasar tuning con bucketMs, buckets, spikeMultiple, minSpike, burstMs, burstCount, quietMs y aliveEvents. Los valores por defecto son 60 000 ms, 10, 4, 5, 5000 ms, 10, 15 minutos y 3.
Las credenciales no entran
La emisión de credenciales aparece en el ledger como un hecho: quién y contra qué. La clave, el secreto y los tokens no se escriben.
Lagunas de registro
Una escritura fallida de un evento de lease o credencial no lanza error. La laguna es lo que went-silent existe para detectar.
La ruta de familias
GET /api/v1/acp/watchdog/families devuelve los tipos vigilados y el ajuste por defecto.
Límites y medición
Solo se vigilan dos familias: concesiones de leases y emisión de credenciales mediante iam.assume e iam.warehouse.
Un pico se juzga solo sobre el último intervalo, frente a la mediana de los nueve anteriores.
Una ráfaga necesita un actor en el cuerpo del evento (actorDid, holder, principal o did). Los eventos sin él cuentan para picos pero no para ráfagas.
tuning se aplica solo a esa llamada. Ninguna ruta guarda un umbral ni una programación.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
GET/api/v1/acp/watchdog/checkHace una pasada por el ledger y devuelve los hallazgos.
GET/api/v1/acp/watchdog/familiesLista los tipos vigilados y el ajuste por defecto.
Acciones MCP
Este módulo no tiene acción MCP. Llámalo por REST desde cualquier agente o programa.