cloudrun-diagnostics-reporter
Extracts full state of a Cloud Run service (panelin-calc) via REST API and gcloud logging/gsutil, produces a structured diagnostic report and flags persistent anomalies. Can open Cloud Console (Run, L
SKILL.md.cursor/skills/cloudrun-diagnostics-reporter/SKILL.md
GitHubCloud Run Diagnostics & Anomaly Reporter
Analiza el estado completo del servicio Cloud Run panelin-calc (proyecto chatbot-bmc-live, us-central1), ejecutando los comandos correctos en Cloud Shell y opcionalmente en el navegador (Cloud Console). Produce un reporte estructurado y detecta anomalías persistentes.
Contexto importante
gcloud run services describepuede fallar conTypeError: string indices must be integers, not 'str'. Usar siempre el bypass vía REST API v2 (script o curl + Python).- Los comandos que usan
gcloud(logging, auth) ygsutildeben ejecutarse en Google Cloud Shell; el agente puede generar el script y las instrucciones, o usar el navegador para abrir Cloud Console y revisar Run / Logging / Storage.
Orden de ejecución (diagnóstico completo)
Seguir este orden. Si el usuario no tiene Cloud Shell abierto, entregar el script listo para pegar y ejecutar allí.
1. Estado del servicio (REST v2 — sin gcloud describe)
Ejecutar el script del repo que usa solo REST:
# En Cloud Shell (o con CLOUDRUN_ACCESS_TOKEN en otro entorno):
./scripts/cloudrun-full-diagnostic.sh
# O el script reducido solo describe:
./scripts/cloudrun-describe-via-api.sh
Si no hay script disponible, usar el one-liner de REST (ver reference.md).
2. Errores recientes (logging)
Comandos para ejecutar en Cloud Shell:
# Errores (severity >= ERROR), últimas 24h
gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="panelin-calc" AND severity>=ERROR' \
--project=chatbot-bmc-live --limit=50 --format="table(timestamp,jsonPayload.message)" --freshness=1d 2>/dev/null || true
# Resumen por status HTTP (4xx/5xx)
gcloud logging read 'resource.type="cloud_run_revision" AND resource.labels.service_name="panelin-calc" AND httpRequest.status>=400' \
--project=chatbot-bmc-live --freshness=7d --limit=500 --format="value(httpRequest.status)" 2>/dev/null | sort | uniq -c | sort -rn
3. Bucket de tokens (ML OAuth)
gsutil ls -la gs://panelin-calc-ml-tokens/ 2>/dev/null || echo "Bucket no accesible o vacío"
4. Anomalías persistentes
Considerar anomalía persistente si en los logs aparece de forma repetida (p. ej. mismo mensaje >5 veces en 7 días):
- "OAuth not initialized" / "ML_CLIENT_SECRET"
- 500 en
/auth/ml/start - 401 en
/ml/questions - 404 en
/auth/ml/callback,/favicon.ico,/,/robots.txt
Incluir en el reporte una sección Anomalías persistentes con: mensaje, cuenta, último timestamp, recomendación.
5. (Opcional) Navegador — Cloud Console
Si el agente tiene acceso al browser MCP:
- Abrir Cloud Run → servicio
panelin-calc→ pestaña Métricas/Logs. - Abrir Logging → filtrar por
resource.labels.service_name="panelin-calc". - Abrir Storage → bucket
panelin-calc-ml-tokens(si existe).
Usar para verificar estado visual, capturar métricas o confirmar que el reporte generado por comandos es coherente.
Productos del skill
- Reporte de diagnóstico — Usar la plantilla en
reference.md(Estado general, Config contenedor, Errores HTTP, Seguridad, Recomendaciones). - Reporte de anomalías persistentes — Tabla: mensaje o patrón, conteo, último visto, severidad, acción sugerida.
- Script listo para Cloud Shell —
scripts/cloudrun-full-diagnostic.shque ejecuta pasos 1–3 y escribe el reporte en stdout o en un archivo.
Cuándo usar este skill
- "Extraer estado completo del servicio y todo lo que está sucediendo"
- "Reportes ante anomalías persistentes"
- "Ejecutar comandos en la consola del deploy y Google Cloud"
- "Analizar por browser y ejecutar los comandos correctos para revisar y encontrar mejoras"
- "Diagnóstico completo panelin-calc Cloud Run"
Archivos de referencia
| Archivo | Uso |
|---|---|
| reference.md | Comandos one-liner, plantilla de reporte, heurísticas de anomalía |
| scripts/cloudrun-full-diagnostic.sh | Script único para Cloud Shell (REST + logging + gsutil + reporte) |