EDB Qué significa un código de error y qué hacer con él

Todos los servicios › atalaya

102913 La credencial del canal ya no sirve

CREDENCIAL_CANAL_INVALIDA

El servicio tiene este código declarado, pero todavía no lo emite.

Clase común a toda la flota (familia «credenciales»): Credencial inválida o caducada. El fallo está en la petición o en la configuración de quien llama.

Qué ha pasado

El destino rechaza nuestra credencial: la tenemos puesta, pero no vale. En Matrix se ve como 401 con M_UNKNOWN_TOKEN. NO es una caída del destino ni un problema de red: el servicio está sano y nos dice que no nos conoce.

Cómo se soluciona

Acuñar una credencial EXCLUSIVA del worker y desplegarla: bash ~/pending-jobs/bin/atalaya-cura-token-matrix.sh. Para Matrix, con device_id dedicado (atalaya-worker-fortiseg), porque dos clientes que comparten device_id se invalidan el token mutuamente.

Qué hacer mientras tanto

Ninguno que sirva de verdad. Reponer el mismo valor que usa una persona compra horas: volverá a morir en cuanto alguien use la cuenta desde otro cliente. Mientras tanto, la guardia debe mirar el panel de Alertmanager y no la sala.

Ya costó tiempo

2026-08-23 a 2026-08-29. El canal de alertas de la flota estuvo CUATRO DÍAS mudo con tres reposiciones que parecían funcionar y duraban horas. En ese hueco, un disco de nodo1 llegó a 0 bytes con la alerta sonando 28 h 30 min sin que nadie la oyera, y tumbó nuestra propia API con disk I/O error. 864 entregas terminaron en agotado, que es terminal: se perdieron. La causa NO era el procedimiento de reposición —era correcto— sino la credencial: el token del worker y el del operador eran EL MISMO VALOR. Un código con esta página habría ahorrado la mayor parte de esa semana.

Dónde se lanza

SIN CABLEAR (4-sep). El puente clase→código YA existe (CODIGO_POR_CLASE) y cubre siete transversales, pero clase_de_fallo no distingue todavía el 401/403 de credencial: cae en rechazado (102904). Falta una clase propia para la credencial inválida. Camino: drivers/matrix.py (401) → clase nueva → CODIGO_POR_CLASE

Cómo se lee el código

1
origen: Fortiseg
02
servicio: atalaya
913
clase común a toda la flota: Credencial inválida o caducada