القائمة
Cómo leer, interpretar y buscar en los logs del worker, generación de PDFs, sync y corrección de cédulas. Úsalo para diagnosticar errores, seguir un trámite o entender qué pasó.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Reglas, errores corregidos y decisiones técnicas aprendidas durante la implementación del proceso automático de generación de coberturas integradas PDF.
Consultas Oracle rápidas para diagnosticar pendientes, trámites específicos, errores, avance por mes y estado de cobertura. Úsalo cuando necesites saber cuántos faltan, qué pasó con un trámite o cómo va el mes.
Rutina diaria de revisión del sistema. Estado completo en un solo paso: Oracle, worker, timer, PDFs, cuarentena, sync y logs recientes. Úsalo al inicio del día o cuando quieras saber si todo está bien.
Control directo del worker sin depender de sudo ni systemd. Lanzar, detener, forzar corrida, cambiar mes, ver estado. Úsalo cuando sudo no está disponible o necesitás control fino.
Evalúa y mantiene la autonomía del worker, timer, locks, estado RUNNING/RETRY_PENDING/RETRY_PENDING_SLOW, cuarentena y reanudación automática. Úsalo cuando se pregunte si el sistema puede correr desatendido o por qué no avanza solo.
Protocolo de cero roturas para modificar Cobertura Automática MSP. Úsalo antes de cambiar Python, Streamlit, Oracle, worker, cuarentena, sync, systemd, rutas o panel de operación.
| name | cobertura-logs |
| description | Cómo leer, interpretar y buscar en los logs del worker, generación de PDFs, sync y corrección de cédulas. Úsalo para diagnosticar errores, seguir un trámite o entender qué pasó. |
logs/
├── cobertura_auto_YYYYMMDD_HHMMSS.jsonl ← Worker: todos los eventos
├── cobertura_auto_YYYYMMDD_HHMMSS_errors.jsonl ← Worker: solo errores
├── cedulas_tramite_audit.jsonl ← Corrección de cédulas
├── cobertura_auto_resume_state.json ← Estado persistente
├── cobertura_repo_sync.sqlite ← Sync: tracking
├── cobertura_sync_queue.sqlite ← Sync: cola pendiente
├── cobertura_quarantine.sqlite ← Cuarentena
└── worker_launcher.log ← Salida del launcher
cd /data_nuevo/cobertura_integrada
grep "5959391" logs/cobertura_auto_*.jsonl
tail -20 $(ls -t logs/cobertura_auto_*.jsonl | head -1)
cat logs/cobertura_auto_20260505_163436.jsonl | python3 -c "
import sys, json
for line in sys.stdin:
e = json.loads(line.strip())
t = e.get('event','')
if t in ('ROW_START','ORACLE_UPDATE_END','PDF_GENERATION_ERROR','RUN_START','RUN_END'):
print(f\"{e['ts']} | {t} | tram={e.get('dig_tramite','')} | {e.get('total','')} | {e.get('ok','')}\")
"
grep "PDF_GENERATION_ERROR" logs/cobertura_auto_$(date +%Y%m%d)_*.jsonl 2>/dev/null | head -20
grep "5958993" logs/cedulas_tramite_audit.jsonl | python3 -c "
import sys, json
for line in sys.stdin:
e = json.loads(line.strip())
a = e['antes']; d = e['despues']
print(f\"{e['ts']} | {e['evento']} | CED: {a['DIG_CEDULA']}->{d['DIG_CEDULA']} | COB: {a['DIG_COBERTURA']}->{d['DIG_COBERTURA']}\")
"
cat logs/cobertura_auto_resume_state.json | python3 -m json.tool
grep "PDF_GENERATION_ERROR" logs/cobertura_auto_$(date +%Y%m%d)_*.jsonl 2>/dev/null | python3 -c "
import sys, json
from collections import Counter
cats = Counter()
for line in sys.stdin:
e = json.loads(line.strip())
err = e.get('error','')[:80]
if '503' in err: cats['503 Service Unavailable'] += 1
elif 'timeout' in err.lower(): cats['Timeout'] += 1
else: cats['Otro'] += 1
for c, n in cats.most_common(): print(f'{c}: {n}')
"
sqlite3 logs/cobertura_quarantine.sqlite "SELECT tramite, retry_count, motivo, datetime(expires_at,'unixepoch','localtime') FROM quarantine WHERE expires_at > strftime('%s','now') ORDER BY expires_at LIMIT 20;"
sqlite3 logs/cobertura_sync_queue.sqlite "SELECT tramite, attempts, status, updated_at FROM cobertura_sync_queue WHERE status='PENDING' ORDER BY created_at LIMIT 20;"