# Observabilidad y debugging

Lab de K8s 10 · Laboratorios de Kubernetes · Sistemas Operativos
Page: https://alfonsocampodonico.com/classes/operating-systems/kubernetes-10-observability?lang=es
Code: https://github.com/AlfonsoCampodonico/k8s-labs/tree/main/labs/10-observability (`gh repo clone AlfonsoCampodonico/k8s-labs`)

> Los clústeres en producción fallan de maneras creativas. Leer logs, eventos y métricas no es opcional; tener una rutina de triage disciplinada tampoco. Este lab arma esa rutina.

> **Tiempo estimado:** 4 horas.
> **Requisitos previos:** labs 01 y 08.

Los clústeres en producción fallan de maneras creativas. Leer logs, eventos y
métricas no es opcional; tener una rutina de triage disciplinada
tampoco. Este lab arma esa rutina.

## Objetivos de aprendizaje

1. Usar `kubectl describe`, `kubectl events` y `kubectl logs` en un
   orden razonado para hacer el triage de un pod que falla.
2. Usar `kubectl debug` para enganchar un contenedor efímero a un pod, a un
   nodo o a una copia del pod con herramientas extra.
3. Leer métricas del clúster desde `metrics.k8s.io` y `kubectl top`.
4. Armar un "playbook de triage" de una página que puedas usar cuando estés de guardia.

## Contexto

### El orden de triage que funciona

1. `kubectl get pod -o wide` — ¿en qué fase está? ¿en qué nodo?
2. `kubectl describe pod` — ¿qué dicen los Events? *No te saltees este paso*.
3. `kubectl logs --previous` — ¿qué dijo el último contenedor antes
   de morir?
4. `kubectl get events --sort-by=.lastTimestamp` — eventos de todo el clúster
   en orden temporal. Muchas veces un evento cercano es la causa.
5. `kubectl top pods` — acá se ve la presión de CPU/memoria.
6. `kubectl debug` — cuando necesitás herramientas que la imagen no trae.

### Contenedores efímeros

`kubectl debug pod/foo -it --image=busybox:1.36 --target=foo` agrega un
contenedor al pod que comparte los namespaces del objetivo. Usá `--image=nicolaka/netshoot`
para tener el kit completo de debugging de red. Usá `--copy-to=foo-debug --share-processes`
para debuggear una *copia* del pod (no es destructivo; el original sigue
corriendo).

El debugging a nivel nodo es parecido: `kubectl debug node/<node>` te deja
en un pod con el filesystem raíz del nodo montado en `/host`.

## Recorrido guiado

### 1. Instalá metrics-server (reutiliza el manifiesto del lab 08)

```bash
kubectl apply -f ../08-health-resources/manifests/metrics-server.yaml
```

### 2. Hacé el triage de un pod roto

```bash
kubectl apply -f manifests/broken-pod.yaml
kubectl get pod broken
kubectl describe pod broken
kubectl logs pod/broken --previous
kubectl get events --sort-by=.lastTimestamp | tail -n 20
```

Leé cada salida con atención; el bug se puede descubrir solo con
`describe`.

### 3. `kubectl debug` sobre un pod distroless

```bash
kubectl apply -f manifests/distroless-pod.yaml
kubectl debug -it pod/distroless --image=nicolaka/netshoot --target=app -- bash
# adentro:
nslookup kubernetes.default
ss -tnp
```

### 4. Shell a nivel nodo

```bash
kubectl debug node/k8s-labs-worker --image=busybox:1.36 -it -- chroot /host
# ahora sos root en el contenedor del nodo de kind
```

## Desafíos

### C1. Arreglá este pod

Aplicá `manifests/challenge-broken.yaml`. Tiene un tag de imagen equivocado
y una liveness probe demasiado agresiva. Arreglá las dos cosas sin borrar el
Deployment, y hacé explícita la configuración agregando la clave `GREETING`
a `app-cfg`. El verificador chequea que el pod esté Running+Ready y que
`observedGeneration >= 2`.

### C2. Escribí un playbook de triage

Creá un ConfigMap llamado `triage-playbook` en `lab-10` con la clave
`playbook.md`, cuyo contenido sea tu propio checklist numerado de una página para
responder a una alerta "pod is CrashLoopBackOff". El verificador solo
chequea que el objeto exista y que su clave no esté vacía — el contenido lo
corrige el docente.

### C3. Métricas

Instalá metrics-server (si todavía no lo hiciste) y corré
`kubectl top pods -n lab-10`. El verificador chequea que
`metrics.k8s.io` esté disponible y que al menos un pod reporte uso.

## Verificación

```bash
make verify LAB=10
```

## Lecturas recomendadas

- Documentación de Kubernetes: [*Debugging pods*](https://kubernetes.io/docs/tasks/debug/debug-application/debug-pods/).
- Netshoot — [nicolaka/netshoot](https://github.com/nicolaka/netshoot).
- Brendan Gregg, [*Systems Performance*](https://www.brendangregg.com/systems-performance-2nd-edition-book.html) — sobre todo el capítulo 2.


## Correrlo

Con Docker, kind y kubectl instalados, corré los targets de `make` desde la
raíz del repositorio; para los comandos del recorrido, que usan rutas
relativas al lab, primero `cd labs/10-observability`:

```sh
./bin/preflight.sh
make cluster
make lab LAB=10
make verify LAB=10
```
