Sesion 6 P2 - Observabilidad Basica
Este documento sirve como guia de trabajo para alumnos sobre la sesion de observabilidad basica en una arquitectura de microservicios.
No reemplaza los README de cada modulo. Se usa como apoyo practico para esta fase del curso.
Objetivo
Poder responder preguntas como:
- que servicio recibio la peticion
- que servicio llamo a otro servicio
- que request fallo
- cuando entro en accion el Circuit Breaker
- que instancia respondio
Flujo esperado:
flowchart LR
subgraph Servicios
G["gateway:8080"]
A["auth-ms:8080"]
C["catalogo-ms:8080"]
P["producto-ms:8080"]
end
subgraph Recolección
Pro["Prometheus"]
Pt["Promtail"]
end
subgraph Almacenamiento
L["Loki"]
end
subgraph Visualización
Gr["Grafana"]
end
G -->|"/actuator/prometheus"| Pro
A -->|"/actuator/prometheus"| Pro
C -->|"/actuator/prometheus"| Pro
P -->|"/actuator/prometheus"| Pro
G -->|"logs"| Pt
A -->|"logs"| Pt
C -->|"logs"| Pt
P -->|"logs"| Pt
Pro --> L
Pt --> L
L --> Gr
Pro --> Gr
Evidencias esperadas
Al finalizar, el alumno debe poder mostrar:
GET /actuator/healthGET /actuator/metricsGET /actuator/metrics/http.server.requestsGET /actuator/metrics/system.cpu.usageGET /actuator/metrics/jvm.memory.usedGET /actuator/circuitbreakersGET /actuator/circuitbreakereventsGET /api/v1/producto/instanciaGET /api/v1/catalogo/instanciaGET /api/v1/productos/detalle/1
Cambios implementados en esta sesion
1. Actuator estandarizado en DEV
Se configuraron estos endpoints en:
infra/config-repo/producto-dev.ymlinfra/config-repo/catalogo-dev.ymlinfra/config-repo/gateway-dev.yml
Configuracion usada:
management:
endpoints:
web:
exposure:
include: health,info,metrics,circuitbreakers,circuitbreakerevents
endpoint:
health:
show-details: always
Nota:
circuitbreakersycircuitbreakereventstienen mas sentido enproducto, porque ahi esta Resilience4j.- En
gatewayycatalogo, lo importante para clase eshealth,infoymetrics.
2. Endpoint /instancia estandarizado
Se ajustaron los endpoints de:
productocatalogo
Respuesta esperada:
{
"servicio": "producto",
"instancia": "9091",
"host": "DESKTOP-01",
"traceId": "0f4d3f7e-7c1e-4bdb-9f18-2d6e615d9d43"
}
Y para catalogo:
{
"servicio": "catalogo",
"instancia": "8081",
"host": "DESKTOP-01",
"traceId": "0f4d3f7e-7c1e-4bdb-9f18-2d6e615d9d43"
}
Esto ayuda a validar:
- registro en Eureka
- ruteo por Gateway
- balanceo entre instancias
- reconocimiento real de quien respondio
- correlacion de la peticion actual con logs
3. Logs de trazabilidad simple
Se agregaron logs didacticos para que el alumno vea el recorrido entre servicios.
En producto:
[PRODUCTO] Buscando detalle de producto con ID: 1
[PRODUCTO] Consultando categoriaId=1 en catalogo
En catalogo:
[CATALOGO] Buscando categoria id=1
Cuando el Circuit Breaker activa fallback en producto:
[PRODUCTO] Fallback activado para producto ID 1. Motivo: ...
4. Propagacion de X-Trace-ID
Ya existian filtros de correlacion en producto y catalogo.
En esta sesion se completo la trazabilidad agregando:
- un filtro global en
gatewaypara crear o reutilizarX-Trace-ID - una configuracion Feign en
productopara reenviarX-Trace-IDhaciacatalogo
Con eso, el mismo identificador puede viajar en la ruta:
Cliente -> Gateway -> Producto -> Catalogo
Esto permite relacionar logs de varios servicios sobre una misma peticion.
Archivos trabajados
infra/config-repo/producto-dev.ymlinfra/config-repo/catalogo-dev.ymlinfra/config-repo/gateway-dev.ymlinfra/gateway/src/main/resources/logback-spring.xmlinfra/gateway/src/main/java/com/upeu/gateway/filter/TraceIdGlobalFilter.javaservices/producto-ms/src/main/resources/logback-spring.xmlservices/catalogo-ms/src/main/resources/logback-spring.xmlservices/producto-ms/src/main/java/com/upeu/producto/config/FeignTraceConfig.javaservices/producto-ms/src/main/java/com/upeu/producto/controller/GatewayInstanciasController.javaservices/catalogo-ms/src/main/java/com/upeu/catalogo/controller/GatewayInstanciasController.javaservices/producto-ms/src/main/java/com/upeu/producto/service/impl/ProductoServiceImpl.javaservices/catalogo-ms/src/main/java/com/upeu/catalogo/service/impl/CategoriaServiceImpl.java
Practica guiada para alumnos
Paso 1. Levantar infraestructura
Levantar:
- config
- eureka
- gateway
Paso 2. Levantar microservicios
Levantar:
- catalogo
- producto
Paso 3. Verificar salud del sistema
Probar:
http://localhost:8090/actuator/health
http://localhost:9092/actuator/health
http://localhost:8082/actuator/health
Paso 3.1. Verificar metricas base
Primero listar metricas disponibles:
http://localhost:8090/actuator/metrics
http://localhost:9092/actuator/metrics
http://localhost:8082/actuator/metrics
Luego consultar metricas especificas:
http://localhost:8090/actuator/metrics/http.server.requests
http://localhost:9092/actuator/metrics/http.server.requests
http://localhost:8082/actuator/metrics/http.server.requests
http://localhost:9092/actuator/metrics/system.cpu.usage
http://localhost:9092/actuator/metrics/jvm.memory.used
Interpretacion basica:
http.server.requests: cantidad y comportamiento de requests HTTPsystem.cpu.usage: uso actual de CPU del proceso/sistemajvm.memory.used: memoria usada por la JVM
Paso 4. Verificar instancia de cada servicio
Probar:
http://localhost:9092/api/v1/producto/instancia
http://localhost:8082/api/v1/catalogo/instancia
http://localhost:8090/api/v1/producto/instancia
http://localhost:8090/api/v1/catalogo/instancia
Paso 5. Verificar detalle con Feign
Probar:
http://localhost:9092/api/v1/productos/detalle/1
http://localhost:8090/api/v1/productos/detalle/1
El alumno debe revisar los logs y confirmar:
productorecibio la peticionproductollamo acatalogocatalogoatendio la consulta
Donde ver los logs en DEV:
- en la consola donde se ejecuto cada servicio con
mvn spring-boot:run - en archivos locales generados por cada servicio:
infra/gateway/logs/gateway.logservices/producto-ms/logs/producto.logservices/catalogo-ms/logs/catalogo.log
Paso 6. Verificar Circuit Breaker
- Detener
catalogo. - Repetir:
http://localhost:9092/api/v1/productos/detalle/1
-
Revisar:
-
respuesta con
categoria: null - logs de fallback
- endpoint
/actuator/circuitbreakers - endpoint
/actuator/circuitbreakerevents
Endpoints utiles para esta validacion:
http://localhost:9092/actuator/circuitbreakers
http://localhost:9092/actuator/circuitbreakerevents
http://localhost:9092/actuator/metrics/http.server.requests
http://localhost:9092/actuator/metrics/system.cpu.usage
http://localhost:9092/actuator/metrics/jvm.memory.used
Preguntas para el alumno
- Que diferencia hay entre
healthymetrics? - Que evidencia muestra que
productollamo acatalogo? - Para que sirve
X-Trace-ID? - Que cambia en la respuesta cuando falla
catalogo? - Como sabes que se activo el fallback?
- Que metrica consultarias para verificar invocaciones HTTP del endpoint?
Cierre de la fase manual
La fase manual de observabilidad se considera cerrada cuando el alumno puede demostrar, sin herramientas externas de centralizacion, estas capacidades:
- revisar salud del servicio con
health - consultar metricas base con
metrics - seguir una peticion entre
gateway,productoycatalogo - identificar
traceId,servicio,instanciayhost - detectar visualmente cuando entra el fallback del Circuit Breaker
- recuperar logs desde consola o archivo en entorno
dev
En esta etapa, la observabilidad es:
- manual
- humana
- basada en Actuator, logs y archivos locales
Todavia no incluye:
- dashboards centralizados
- consulta unificada de logs
- alertas
- trazas distribuidas completas
Checklist de evaluacion
Para cerrar esta fase, el alumno debe presentar evidencia de:
GET /actuator/healthengateway,productoycatalogoGET /actuator/metricsy al menos una metrica especifica comohttp.server.requestsGET /api/v1/producto/instanciayGET /api/v1/catalogo/instancia- una peticion
GET /api/v1/productos/detalle/1con logs correlacionados - recuperacion de logs desde consola o desde archivo local
Si se desea evaluacion completa de resiliencia, adicionalmente debe presentar:
- evidencia del fallback cuando
catalogono esta disponible - consulta de
GET /actuator/circuitbreakers - consulta de
GET /actuator/circuitbreakerevents
Siguiente paso recomendado
Despues de esta sesion, el siguiente bloque natural es:
- observabilidad con herramientas
- centralizacion de metricas con Prometheus
- centralizacion de logs con Loki
- visualizacion unificada con Grafana
- multiples instancias para demostrar balanceo con evidencia visual
Si el curso prioriza seguridad, entonces el siguiente salto puede ser:
- Spring Security
- JWT
- proteccion del Gateway