Cheatsheet — Spring Boot ops (Labs 11, 14)
Verificación post-deploy (orden)
#
Comando
Qué verifica
1
curl .../actuator/health
¿Proceso + DB UP?
2
POST /api/notes
¿Negocio + JDBC OK? (smoke test)
3
printenv | grep SPRING
¿Config real del proceso?
4
docker compose logs app
Evidencia de excepciones
java -Xms256m -Xmx512m -jar app.jar
SPRING_PROFILES_ACTIVE=prod java -jar app.jar
Variables de entorno clave (Lab 11-C)
SPRING_DATASOURCE_URL=jdbc:mysql://HOST:3306/DB? useSSL=false& allowPublicKeyRetrieval=true
SPRING_DATASOURCE_USERNAME=appuser
SPRING_DATASOURCE_PASSWORD=***
SPRING_PROFILES_ACTIVE=prod # perfil activo (dev/prod/test)
SERVER_PORT=8080
JAVA_TOOL_OPTIONS=-Xms128m -Xmx256m # flags JVM sin cambiar ENTRYPOINT
OK: "status":"UP" y db.status=UP
DB caída: db.status=DOWN o errores JDBC en logs
Nada en puerto: connection refused
Formatear JSON para lectura
curl -sS localhost:8080/actuator/health | python3 -m json.tool
curl -sS localhost:8080/actuator/health | jq .
Modelo de memoria JVM (Lab 11-D)
-Xms128m # heap inicial (arranca con esto)
-Xmx256m # heap máximo (techo, no puede crecer más)
-XX:+HeapDumpOnOutOfMemoryError # dump al OOM
-XX:HeapDumpPath=/var/log/myapp/heap.hprof
OS + buffers: ~200MB
MySQL: ~300MB
JVM heap (Xmx): 256MB
JVM overhead: ~100MB (stack + metaspace + buffers nativos)
Total: ~856MB → cabe en 1GB con margen
Memoria total JVM = heap + stack threads + metaspace + native buffers (siempre > Xmx)
HikariCP (pool de conexiones) — Lab 11-F
Pool mantiene N conexiones abiertas a MySQL
Si MySQL cae: pool detecta por timeout (~30s prod)
Si MySQL vuelve: pool reconecta automáticamente (sin restart de app)
"HikariPool - Connection is not available" = pool agotado
Anatomía de un log Spring Boot (Lab 11-E)
2026-08-03 16:00:05.123 INFO 1 --- [main] c.e.o.OpsLabApplication : Started
│ │ │ │ │
timestamp nivel PID thread clase
Nivel
Significado
Acción
INFO
operación normal
nada
WARN
algo no ideal
monitorear
ERROR
problema real
investigar
# Ranking de salud en 1 comando
grep -Eo ' ERROR|WARN|INFO' app.log | sort | uniq -c | sort -nr
# Mayoría INFO + pocos WARN + 0 ERROR = app sana
Diagnóstico diferencial (Lab 14)
Keyword en logs
Causa
Fix
Communications link failure
MySQL no corre
start mysql
Access denied for user
password incorrecto (1045)
sincronizar password
No space left on device
disco lleno
df -h, limpiar
OutOfMemoryError
heap JVM lleno
aumentar Xmx o fix leak
Address already in use
puerto ocupado
lsof, kill viejo
Too many connections
pool/max_connections
SHOW PROCESSLIST, ajustar
Connection timed out
red o firewall
verificar conectividad
Protocolo de diagnóstico (Lab 14)
1. Síntoma: curl -w "http=%{http_code}" URL
2. Health: curl actuator/health
3. Logs app: docker compose logs --tail=80 app | grep -iE "error|exception"
4. Logs DB: docker compose logs --tail=50 mysql
5. Diferencial: keyword → causa → fix específico
6. Fix: aplicar
7. Verificar: health UP + API funciona
8. Documentar: informe con timeline
cd ~ /Projects/java-linux-ops-lab/docker && docker compose up -d
curl -sS localhost:8080/actuator/health | python3 -m json.tool
curl -sS -X POST localhost:8080/api/notes -H ' Content-Type: application/json' \
-d ' {"title":"t","body":"b"}'