Problemas de instalación¶

Esta página describe los problemas más habituales durante la instalación de Ubuntu, Grafana, Prometheus y Node Exporter.

El objetivo no es únicamente aplicar comandos, sino aprender un procedimiento sistemático de diagnóstico:

Identificar el síntoma
        |
        v
Recopilar información
        |
        v
Consultar registros
        |
        v
Comprobar configuración
        |
        v
Aplicar una corrección
        |
        v
Validar el resultado
        |
        v
Documentar la solución

Advertencia: realiza las prácticas en el entorno de laboratorio. Antes de modificar una configuración, crea una copia de seguridad y verifica que el comando se ejecuta sobre el equipo correcto.

Objetivos¶

Al finalizar esta sesión, el alumno podrá:

Identificar los síntomas habituales de un problema de instalación.
Comprobar si un paquete está instalado correctamente.
Diagnosticar errores de apt.
Comprobar la arquitectura del sistema.
Verificar la existencia de usuarios, grupos y directorios.
Analizar errores de servicios gestionados por systemd.
Revisar los registros de instalación y ejecución.
Diagnosticar conflictos de puertos.
Validar configuraciones de Grafana y Prometheus.
Comprobar los binarios instalados.
Resolver problemas de permisos.
Restaurar configuraciones desde una copia de seguridad.
Documentar una incidencia técnica de forma reproducible.

Introducción¶

Una instalación puede fallar por diferentes motivos:

El sistema no tiene acceso a Internet.
El repositorio no está disponible.
La arquitectura descargada es incorrecta.
El paquete no es compatible con la versión de Ubuntu.
Ya existe una instalación anterior.
Un puerto está ocupado.
El usuario del servicio no existe.
La configuración contiene errores.
El servicio no tiene permisos suficientes.
Faltan dependencias.
El sistema de archivos está lleno.
El reloj del sistema es incorrecto.
El firewall bloquea la comunicación.
El fichero descargado está incompleto o corrupto.

El mensaje visible suele ser solo una parte del problema. Por ejemplo, este mensaje:

Job for prometheus.service failed because the control process exited with error code.

no explica necesariamente la causa. Para encontrarla hay que consultar:

systemctl status prometheus

y:

sudo journalctl -u prometheus -n 100 --no-pager

Procedimiento general de diagnóstico¶

Identificar el componente afectado¶

Determina qué elemento presenta el problema:

Ubuntu
APT
Grafana
Prometheus
Node Exporter
systemd
Red
Firewall
Permisos
Almacenamiento

Registrar el síntoma¶

Anota exactamente:

Qué comando se ejecutó.
Qué resultado se obtuvo.
Qué mensaje de error apareció.
Cuándo comenzó el problema.
Qué cambios se habían realizado antes.

Ejemplo:

Al ejecutar sudo systemctl start prometheus aparece un error.
El servicio no llega a estar activo.
El puerto 9090 no está en escucha.
El fichero prometheus.yml se modificó antes del fallo.

Recopilar información del sistema¶

hostnamectl

lsb_release -ds

uname -m

df -h

free -h

Comprobar el servicio¶

systemctl status nombre-del-servicio

systemctl is-active nombre-del-servicio

Consultar los registros¶

sudo journalctl -u nombre-del-servicio -n 100 --no-pager

Comprobar el proceso y el puerto¶

ps aux | grep "[n]ombre-del-proceso"

sudo ss -lntp

Validar la configuración¶

Utiliza la herramienta de validación específica cuando exista:

promtool check config /etc/prometheus/prometheus.yml

Aplicar la solución¶

Realiza un cambio cada vez. Después de cada cambio:

Comprueba el estado.
Revisa los registros.
Verifica el puerto.
Prueba el endpoint.
Documenta el resultado.

Información inicial del sistema¶

Consultar la versión de Ubuntu¶

lsb_release -a

También:

cat /etc/os-release

Consultar la arquitectura¶

uname -m

Resultados habituales:

x86_64

aarch64

La arquitectura debe coincidir con el paquete o binario descargado.

Consultar el kernel¶

uname -r

Consultar el nombre del equipo¶

hostnamectl

Consultar la fecha y la hora¶

date

Consultar la zona horaria¶

timedatectl

Comprobar el espacio disponible¶

df -h

Comprobar especialmente:

df -h /
df -h /var
df -h /tmp

Comprobar la memoria disponible¶

free -h

Comprobar la conectividad¶

ping -c 4 8.8.8.8

Comprobar la resolución DNS:

resolvectl query archive.ubuntu.com

Problemas con APT¶

APT es el sistema de gestión de paquetes utilizado en Ubuntu.

Actualizar la información de paquetes¶

sudo apt update

Actualizar los paquetes instalados¶

sudo apt upgrade

Comprobar si un paquete está instalado¶

dpkg -l | grep nombre-del-paquete

También:

apt policy nombre-del-paquete

Buscar un paquete¶

apt search nombre-del-paquete

Consultar los paquetes pendientes de configuración¶

sudo dpkg --audit

Reparar dependencias¶

sudo apt --fix-broken install

Configurar paquetes pendientes¶

sudo dpkg --configure -a

Limpiar la caché de paquetes¶

sudo apt clean

Consultar los registros de APT¶

sudo less /var/log/apt/history.log

sudo less /var/log/apt/term.log

Error: no se puede localizar el paquete¶

Mensaje habitual:

E: Unable to locate package nombre-del-paquete

Comprobaciones:

sudo apt update

apt-cache policy nombre-del-paquete

grep -R "^deb " /etc/apt/sources.list /etc/apt/sources.list.d/ \
  2>/dev/null

Posibles causas:

No se ha ejecutado apt update.
El nombre del paquete es incorrecto.
El repositorio no está configurado.
El repositorio no corresponde a la versión de Ubuntu.
No existe una conexión a Internet.
La arquitectura no está disponible.

Error de bloqueo de APT¶

Mensaje habitual:

Could not get lock /var/lib/dpkg/lock-frontend

Comprueba si hay otro proceso de APT ejecutándose:

ps aux | grep -E "[a]pt|[d]pkg"

Comprueba quién utiliza el fichero:

sudo lsof /var/lib/dpkg/lock-frontend

No elimines manualmente los ficheros de bloqueo mientras exista un proceso de APT activo.

Error de configuración incompleta¶

Ejecuta:

sudo dpkg --configure -a

Después:

sudo apt --fix-broken install

Error de firma o repositorio no válido¶

Revisa:

sudo apt update

Consulta:

grep -R "deb " /etc/apt/sources.list.d/ \
  2>/dev/null

Comprueba:

La URL del repositorio.
La versión de Ubuntu.
La clave de firma.
La fecha y hora del sistema.
La compatibilidad del repositorio.

No desactives la verificación de firmas como solución permanente.

Problemas al instalar Grafana¶

Comprobar si Grafana está instalado¶

dpkg -l | grep grafana

apt policy grafana

Localizar el ejecutable¶

command -v grafana-server

Buscarlo en rutas habituales:

sudo find /usr /opt -type f \
  -name "grafana-server" \
  -executable 2>/dev/null

Comprobar el servicio¶

systemctl status grafana-server

systemctl is-active grafana-server

Comprobar la unidad¶

systemctl cat grafana-server

Consultar la configuración¶

La ruta habitual es:

/etc/grafana/grafana.ini

Comprobar que existe:

sudo test -f /etc/grafana/grafana.ini \
  && echo "Configuración encontrada"

Consultar la configuración de red:

sudo grep -n -E \
  "http_addr|http_port|domain|root_url" \
  /etc/grafana/grafana.ini

Comprobar el puerto de Grafana¶

sudo ss -lntp | grep ':3000'

Comprobar la interfaz web¶

curl -I http://localhost:3000

Una respuesta 200 OK o 302 Found puede indicar que Grafana responde correctamente.

Consultar los registros¶

sudo journalctl -u grafana-server -n 100 --no-pager

Seguir los registros en tiempo real:

sudo journalctl -u grafana-server -f

Error: el puerto 3000 está ocupado¶

Comprueba el proceso:

sudo ss -lntp | grep ':3000'

También:

sudo lsof -iTCP:3000 -sTCP:LISTEN

Consulta el PID:

ps -fp PID

Posibles causas:

Existe otra instancia de Grafana.
Otra aplicación utiliza el puerto.
Grafana se ha iniciado dos veces.
Una instalación antigua continúa activa.

Error: Grafana no puede escribir en sus directorios¶

Consulta los permisos:

sudo ls -ld /var/lib/grafana

sudo ls -ld /var/log/grafana

sudo ls -l /etc/grafana/grafana.ini

Consulta el usuario del servicio:

systemctl show grafana-server \
  -p User \
  -p Group

Corrige el propietario únicamente si sabes cuál debe ser:

sudo chown -R grafana:grafana /var/lib/grafana

sudo chown -R grafana:grafana /var/log/grafana

Después:

sudo systemctl restart grafana-server

Error: Grafana no inicia después de modificar `grafana.ini`¶

Crea una copia antes de editar:

sudo cp /etc/grafana/grafana.ini \
  /etc/grafana/grafana.ini.bak

Consulta los registros:

sudo journalctl -u grafana-server -n 100 --no-pager

Si la configuración anterior era válida:

sudo cp /etc/grafana/grafana.ini.bak \
  /etc/grafana/grafana.ini

Reinicia:

sudo systemctl restart grafana-server

Problemas al instalar Prometheus¶

Comprobar si Prometheus está instalado¶

dpkg -l | grep prometheus

Si se instaló manualmente:

command -v prometheus

sudo find /usr /opt -type f \
  -name "prometheus" \
  -executable 2>/dev/null

Comprobar `promtool`¶

command -v promtool

promtool --version

Comprobar el servicio¶

systemctl status prometheus

systemctl is-active prometheus

Consultar la unidad¶

systemctl cat prometheus

Consultar el comando de inicio:

systemctl show prometheus \
  -p ExecStart

Consultar el proceso¶

ps aux | grep "[p]rometheus"

Consultar el fichero de configuración¶

La ruta habitual es:

/etc/prometheus/prometheus.yml

Comprobar que existe:

sudo test -f /etc/prometheus/prometheus.yml \
  && echo "Configuración encontrada"

Validar la configuración¶

promtool check config \
  /etc/prometheus/prometheus.yml

Si hay reglas:

promtool check rules \
  /etc/prometheus/rules/*.yml

Error de sintaxis en `prometheus.yml`¶

Ejemplo de mensaje:

yaml: line 15: did not find expected key

Consulta la línea indicada:

sudo nl -ba /etc/prometheus/prometheus.yml \
  | sed -n '10,20p'

El comando:

Muestra los números de línea.
Permite revisar el contexto del error.
Facilita localizar espacios o sangrías incorrectas.

Comprobar la sangría YAML¶

Incorrecto:

scrape_configs:
- job_name: node_exporter
  static_configs:
    - targets:
      - localhost:9100

Correcto:

scrape_configs:
  - job_name: node_exporter
    static_configs:
      - targets:
          - localhost:9100

Error: el puerto 9090 está ocupado¶

sudo ss -lntp | grep ':9090'

sudo lsof -iTCP:9090 -sTCP:LISTEN

Consulta el proceso:

ps -fp PID

Error: Prometheus no puede escribir los datos¶

Consulta:

sudo ls -ld /var/lib/prometheus

df -h /var/lib/prometheus

systemctl show prometheus \
  -p User \
  -p Group

Corrige el propietario si corresponde:

sudo chown -R prometheus:prometheus \
  /var/lib/prometheus

Error: falta el directorio de datos¶

sudo mkdir -p /var/lib/prometheus

Después asigna el propietario adecuado:

sudo chown prometheus:prometheus \
  /var/lib/prometheus

Error: Prometheus no encuentra el fichero de configuración¶

Consulta la unidad:

systemctl show prometheus \
  -p ExecStart

Busca el parámetro:

--config.file=

Comprueba la ruta:

sudo ls -l /etc/prometheus/prometheus.yml

Error: Prometheus arranca, pero no tiene targets¶

Consulta la configuración:

sudo grep -n -A 10 -B 2 \
  "scrape_configs" \
  /etc/prometheus/prometheus.yml

Comprueba la API:

curl -s http://localhost:9090/api/v1/targets \
  | jq

Comprueba la métrica:

up

Problemas al instalar Node Exporter¶

Comprobar el ejecutable¶

command -v node_exporter

Buscarlo:

sudo find /usr /opt -type f \
  -name "node_exporter" \
  -executable 2>/dev/null

Comprobar la arquitectura¶

uname -m

Una arquitectura incorrecta puede producir errores como:

cannot execute binary file

Consultar la versión¶

node_exporter --version

Comprobar el servicio¶

systemctl status node_exporter

systemctl is-active node_exporter

Consultar la unidad¶

systemctl cat node_exporter

Consultar los parámetros de ejecución¶

systemctl show node_exporter \
  -p ExecStart

Comprobar el puerto¶

sudo ss -lntp | grep ':9100'

Comprobar las métricas¶

curl -I http://localhost:9100/metrics

curl -s http://localhost:9100/metrics | head

Error: unidad no encontrada¶

Mensaje habitual:

Unit node_exporter.service could not be found.

Comprueba:

systemctl list-unit-files | grep node

Busca ficheros de unidad:

sudo find /etc/systemd /lib/systemd /usr/lib/systemd \
  -name "*node*exporter*.service" \
  2>/dev/null

Si se ha creado una unidad nueva:

sudo systemctl daemon-reload

Después:

sudo systemctl enable --now node_exporter

Error: el servicio se inicia y se detiene¶

Consulta:

sudo journalctl -u node_exporter \
  -n 100 \
  --no-pager

Consulta el proceso:

ps aux | grep "[n]ode_exporter"

Posibles causas:

El binario no es ejecutable.
La arquitectura es incorrecta.
El puerto está ocupado.
El usuario no tiene permisos.
Existe un parámetro incorrecto.
La unidad contiene una ruta equivocada.

Dar permiso de ejecución¶

sudo chmod +x /usr/local/bin/node_exporter

Comprueba:

ls -l /usr/local/bin/node_exporter

Problemas con el usuario del servicio¶

Comprueba si existe:

getent passwd node_exporter

Comprueba el grupo:

getent group node_exporter

Consulta la unidad:

systemctl cat node_exporter

Si la unidad utiliza un usuario inexistente, el servicio no podrá iniciarse correctamente.

Problemas con `systemd`¶

Consultar el estado¶

systemctl status nombre-del-servicio

Consultar el código de salida¶

systemctl show nombre-del-servicio \
  -p Result \
  -p ExecMainStatus \
  -p ExecMainCode

Consultar el motivo de un fallo¶

sudo journalctl -u nombre-del-servicio \
  -b \
  --no-pager

Consultar solo los errores¶

sudo journalctl -u nombre-del-servicio \
  -p err \
  --no-pager

Recargar las unidades¶

sudo systemctl daemon-reload

Reiniciar un servicio¶

sudo systemctl restart nombre-del-servicio

Activar un servicio al arrancar¶

sudo systemctl enable nombre-del-servicio

Activar e iniciar¶

sudo systemctl enable --now nombre-del-servicio

Consultar servicios fallidos¶

systemctl --failed

Comprobar la sintaxis de una unidad¶

systemd-analyze verify \
  /etc/systemd/system/node_exporter.service

Problemas de permisos¶

Consultar permisos¶

ls -l fichero

stat fichero

Consultar el propietario de una ruta¶

sudo stat /var/lib/prometheus

Comprobar acceso como usuario del servicio¶

Por ejemplo:

sudo -u prometheus test -r \
  /etc/prometheus/prometheus.yml \
  && echo "Puede leer el fichero"

Comprobar escritura:

sudo -u prometheus test -w \
  /var/lib/prometheus \
  && echo "Puede escribir en el directorio"

Consultar permisos de todos los directorios de una ruta¶

namei -l /etc/prometheus/prometheus.yml

Este comando ayuda a comprobar los permisos de cada directorio intermedio.

Cambiar propietario¶

sudo chown prometheus:prometheus \
  /etc/prometheus/prometheus.yml

Cambiar permisos de un fichero de configuración¶

sudo chmod 640 \
  /etc/prometheus/prometheus.yml

Cambiar permisos de un ejecutable¶

sudo chmod 755 \
  /usr/local/bin/node_exporter

No utilices:

sudo chmod -R 777 /etc

Esta práctica es insegura y puede dañar el sistema.

Problemas de red y DNS¶

Consultar interfaces¶

ip addr

Consultar rutas¶

ip route

Probar conectividad IP¶

ping -c 4 8.8.8.8

Probar resolución DNS¶

resolvectl query archive.ubuntu.com

Consultar el estado de DNS¶

resolvectl status

Probar una conexión HTTP¶

curl -I https://example.com

Diagnosticar una descarga¶

curl -v -L -o /tmp/fichero.tar.gz URL

Comprobar el tamaño descargado¶

ls -lh /tmp/fichero.tar.gz

Comprobar el tipo de fichero¶

file /tmp/fichero.tar.gz

Si se esperaba un archivo comprimido y file muestra HTML, probablemente se descargó una página de error en lugar del archivo.

Problemas con descargas y binarios¶

Comprobar la integridad mediante SHA-256¶

sha256sum fichero.tar.gz

Compara el resultado con la suma publicada por el proyecto.

Extraer un archivo comprimido¶

tar -xzf fichero.tar.gz

Consultar su contenido antes de extraerlo:

tar -tzf fichero.tar.gz

Error de formato de archivo¶

Si aparece:

gzip: stdin: not in gzip format

Comprueba:

file fichero.tar.gz

Posibles causas:

La URL no apunta al archivo correcto.
Se descargó una página HTML.
La descarga está incompleta.
El archivo utiliza otro formato.
El archivo está corrupto.

Error de arquitectura¶

Comprueba:

uname -m

Comprueba el binario:

file /usr/local/bin/node_exporter

La arquitectura del binario debe ser compatible con el sistema.

Error de ejecución¶

Si aparece:

Permission denied

Comprueba:

ls -l /usr/local/bin/node_exporter

Concede permiso solo si corresponde:

sudo chmod +x /usr/local/bin/node_exporter

Si aparece:

Exec format error

comprueba la arquitectura:

file /usr/local/bin/node_exporter
uname -m

Problemas de puertos¶

Mostrar puertos en escucha¶

sudo ss -lntp

Comprobar Grafana¶

sudo ss -lntp | grep ':3000'

Comprobar Prometheus¶

sudo ss -lntp | grep ':9090'

Comprobar Node Exporter¶

sudo ss -lntp | grep ':9100'

Identificar un proceso¶

sudo lsof -iTCP:3000 -sTCP:LISTEN

Interpretar las direcciones de escucha¶

Ejemplo:

127.0.0.1:3000

Solo acepta conexiones locales.

Ejemplo:

0.0.0.0:3000

Acepta conexiones IPv4 desde las interfaces disponibles, sujeto al firewall.

Ejemplo:

[::]:3000

Escucha en IPv6, según la configuración del sistema.

Cambiar un puerto¶

Antes de cambiarlo:

Crea una copia de seguridad.
Consulta la documentación del servicio.
Comprueba que el nuevo puerto está libre.
Modifica la configuración correcta.
Reinicia el servicio.
Comprueba el nuevo endpoint.
Actualiza Prometheus, Grafana o el firewall si es necesario.

Problemas del firewall¶

Consultar UFW¶

sudo ufw status verbose

Consultar las reglas numeradas¶

sudo ufw status numbered

Permitir Grafana en una red de laboratorio¶

sudo ufw allow from 192.168.1.0/24 \
  to any port 3000 \
  proto tcp

Permitir Prometheus en una red de laboratorio¶

sudo ufw allow from 192.168.1.0/24 \
  to any port 9090 \
  proto tcp

Permitir Node Exporter desde un servidor Prometheus¶

sudo ufw allow from DIRECCION_IP_PROMETHEUS \
  to any port 9100 \
  proto tcp

Comprobar una regla¶

sudo ufw status numbered

No abras los puertos a cualquier origen sin una justificación:

sudo ufw allow 9100/tcp

Esta regla puede exponer Node Exporter a más equipos de los necesarios.

Problemas de espacio en disco¶

Consultar espacio disponible¶

df -h

Buscar directorios grandes¶

sudo du -h --max-depth=1 /var \
  | sort -h

Consultar datos de Prometheus¶

sudo du -sh /var/lib/prometheus

Consultar datos de Grafana¶

sudo du -sh /var/lib/grafana

Buscar ficheros grandes¶

sudo find /var -type f \
  -size +500M \
  -printf "%s %p\n" \
  2>/dev/null \
  | sort -n

Revisar registros¶

sudo journalctl --disk-usage

Reducir registros antiguos del journal¶

Solo en el entorno de laboratorio y siguiendo la política de retención:

sudo journalctl --vacuum-time=7d

No elimines datos de Prometheus o Grafana sin comprender sus consecuencias.

Problemas de fecha y certificados¶

Una fecha incorrecta puede provocar errores al descargar paquetes o validar certificados.

Consultar fecha¶

date

Consultar sincronización¶

timedatectl

Activar sincronización NTP¶

sudo timedatectl set-ntp true

Consultar el estado de sincronización¶

timedatectl show-timesync \
  --all

Problemas posteriores a una reinstalación¶

Detectar instalaciones duplicadas¶

dpkg -l | grep -E \
  "grafana|prometheus|node-exporter"

Buscar procesos duplicados:

ps aux | grep -E \
  "[g]rafana|[p]rometheus|[n]ode_exporter"

Buscar unidades duplicadas:

systemctl list-unit-files \
  | grep -E \
  "grafana|prometheus|node_exporter"

Detectar configuraciones antiguas¶

sudo find /etc /opt /usr/local \
  -iname "*grafana*" \
  -o -iname "*prometheus*" \
  -o -iname "*node_exporter*" \
  2>/dev/null

Revisar puertos duplicados¶

sudo ss -lntp \
  | grep -E ':(3000|9090|9100)\b'

No borrar inmediatamente¶

Antes de eliminar una instalación anterior:

Identifica el servicio activo.
Comprueba la configuración utilizada.
Haz una copia de seguridad.
Documenta la instalación antigua.
Comprueba qué procesos dependen de ella.
Detén el servicio de forma controlada.
Elimina únicamente los ficheros necesarios.

Sesión práctica 1: diagnóstico inicial¶

Objetivo¶

Recopilar información antes de modificar el sistema.

Preparación¶

mkdir -p ~/laboratorio/problemas-instalacion
cd ~/laboratorio/problemas-instalacion

Generar un informe inicial¶

{
  echo "===== INFORME INICIAL ====="
  echo "Fecha: $(date)"
  echo "Equipo: $(hostname)"
  echo

  echo "===== SISTEMA ====="
  hostnamectl
  echo
  lsb_release -ds
  uname -m
  uname -r
  echo

  echo "===== ESPACIO ====="
  df -h
  echo

  echo "===== MEMORIA ====="
  free -h
  echo

  echo "===== RED ====="
  ip addr
  ip route
  echo

  echo "===== SERVICIOS ====="
  for service in grafana-server prometheus node_exporter; do
    echo "--- $service ---"
    systemctl is-active "$service" 2>/dev/null || true
    systemctl is-enabled "$service" 2>/dev/null || true
  done

  echo
  echo "===== PUERTOS ====="
  sudo ss -lntp
} | tee informe-inicial.txt

Preguntas de análisis¶

¿Qué versión de Ubuntu está instalada?
¿Qué arquitectura utiliza el equipo?
¿Hay espacio suficiente?
¿Qué servicios están instalados?
¿Qué servicios están activos?
¿Qué puertos están en escucha?
¿Existe algún conflicto evidente?

Sesión práctica 2: diagnosticar una instalación de Prometheus¶

Objetivo¶

Determinar por qué Prometheus no inicia.

Comprobar el estado¶

systemctl status prometheus

Consultar el registro¶

sudo journalctl -u prometheus \
  -n 100 \
  --no-pager

Consultar la unidad¶

systemctl cat prometheus

Comprobar la configuración¶

sudo ls -l /etc/prometheus/prometheus.yml

Validar el fichero¶

promtool check config \
  /etc/prometheus/prometheus.yml

Comprobar los permisos¶

sudo stat /etc/prometheus/prometheus.yml

sudo stat /var/lib/prometheus

Comprobar el espacio¶

df -h /var/lib/prometheus

Comprobar el puerto¶

sudo ss -lntp | grep ':9090'

Procedimiento de recuperación¶

Si el problema está en la configuración:

sudo cp /etc/prometheus/prometheus.yml \
  /etc/prometheus/prometheus.yml.bak

Restaura una copia válida:

sudo cp /etc/prometheus/prometheus.yml.bak \
  /etc/prometheus/prometheus.yml

Valida:

promtool check config \
  /etc/prometheus/prometheus.yml

Reinicia:

sudo systemctl restart prometheus

Comprueba:

systemctl is-active prometheus

curl http://localhost:9090/-/healthy

Sesión práctica 3: diagnosticar un conflicto de puertos¶

Objetivo¶

Identificar qué proceso utiliza un puerto necesario.

Comprobar el puerto de Grafana¶

sudo ss -lntp | grep ':3000'

Identificar el proceso¶

sudo lsof -iTCP:3000 -sTCP:LISTEN

Consultar el PID¶

ps -fp PID

Sustituye PID por el valor real.

Consultar el servicio¶

systemctl status grafana-server

Consultar los procesos relacionados¶

ps aux | grep "[g]rafana"

Preguntas de análisis¶

¿Qué proceso ocupa el puerto?
¿A qué usuario pertenece?
¿Lo gestiona systemd?
¿Existe más de una instalación?
¿Qué solución sería más segura?
¿Es preferible cambiar el puerto o detener el proceso duplicado?

Sesión práctica 4: simular un problema de permisos¶

Objetivo¶

Observar cómo un permiso incorrecto impide iniciar un servicio.

Realiza esta actividad únicamente en una máquina virtual o entorno de laboratorio.

Crear una copia de la configuración¶

sudo cp /etc/prometheus/prometheus.yml \
  /etc/prometheus/prometheus.yml.practica

Consultar los permisos iniciales¶

sudo stat /etc/prometheus/prometheus.yml

Aplicar una modificación controlada¶

sudo chmod 600 /etc/prometheus/prometheus.yml

Comprueba si el usuario del servicio puede leerlo:

sudo -u prometheus test -r \
  /etc/prometheus/prometheus.yml \
  && echo "Puede leerlo" \
  || echo "No puede leerlo"

Consultar el servicio¶

sudo systemctl restart prometheus

systemctl status prometheus

Restaurar permisos adecuados¶

sudo chmod 640 /etc/prometheus/prometheus.yml

Si es necesario:

sudo chown prometheus:prometheus \
  /etc/prometheus/prometheus.yml

Validar y reiniciar¶

promtool check config \
  /etc/prometheus/prometheus.yml

sudo systemctl restart prometheus

Preguntas de análisis¶

¿Qué permisos tenía inicialmente el fichero?
¿Qué usuario ejecuta Prometheus?
¿Podía leer el fichero después del cambio?
¿Qué mensaje apareció en los registros?
¿Qué permisos permiten el funcionamiento correcto?

Sesión práctica 5: diagnosticar una descarga incorrecta¶

Objetivo¶

Comprobar si un archivo descargado corresponde realmente al formato esperado.

Crear un fichero de prueba¶

cd ~/laboratorio/problemas-instalacion

Consultar el tipo de archivo¶

file fichero-descargado.tar.gz

Consultar el tamaño¶

ls -lh fichero-descargado.tar.gz

Consultar el contenido¶

tar -tzf fichero-descargado.tar.gz

Comprobar la suma¶

sha256sum fichero-descargado.tar.gz

Interpretar los resultados¶

Si file muestra:

HTML document

en lugar de:

gzip compressed data

la descarga probablemente no corresponde al archivo esperado.

Repetir una descarga de forma controlada¶

curl -fL \
  -o fichero.tar.gz \
  URL_DEL_ARCHIVO

La opción -f hace que curl falle ante errores HTTP.

Después:

file fichero.tar.gz

tar -tzf fichero.tar.gz

Sesión práctica 6: diagnosticar Node Exporter¶

Objetivo¶

Comprobar el flujo completo entre Node Exporter y Prometheus.

Comprobar el servicio¶

systemctl is-active node_exporter

Comprobar el puerto¶

sudo ss -lntp | grep ':9100'

Comprobar el endpoint¶

curl -I http://localhost:9100/metrics

Comprobar las métricas¶

curl -s http://localhost:9100/metrics | head -20

Consultar Prometheus¶

curl -s http://localhost:9090/api/v1/targets \
  | jq

Ejecutar PromQL¶

up{job="node_exporter"}

Interpretar el resultado¶

Comprobación	Resultado esperado
Servicio	`active`
Puerto `9100`	En escucha
Endpoint `/metrics`	Responde
Target de Prometheus	`UP`
Consulta `up`	Valor `1`

Sesión práctica 7: elaborar un informe de incidencia¶

Objetivo¶

Documentar un problema de instalación de principio a fin.

Situación¶

Prometheus no inicia después de modificar su configuración.

Recopilar información¶

systemctl status prometheus

sudo journalctl -u prometheus \
  -n 100 \
  --no-pager

promtool check config \
  /etc/prometheus/prometheus.yml

Crear una copia del estado actual¶

sudo cp /etc/prometheus/prometheus.yml \
  "/var/backups/prometheus.yml.$(date +%F-%H%M%S)"

Resolver el problema¶

Aplica la corrección necesaria y valida de nuevo:

promtool check config \
  /etc/prometheus/prometheus.yml

Reiniciar el servicio¶

sudo systemctl restart prometheus

Validar el resultado¶

systemctl is-active prometheus

curl http://localhost:9090/-/healthy

Completar el informe¶

Título:

Fecha:

Alumno:

Equipo:

Componente afectado:

Síntoma:

Cambio realizado antes del fallo:

Estado inicial:

Mensaje de error:

Comando de validación:

Causa identificada:

Copia de seguridad:

Corrección aplicada:

Resultado posterior:

Evidencias:

Método de recuperación recomendado¶

Detener los cambios¶

No realices varios cambios simultáneos. Si modificas cinco elementos a la vez, será más difícil identificar cuál solucionó o causó el problema.

Recuperar la última configuración válida¶

sudo cp fichero.bak fichero

Validar¶

promtool check config fichero

Recargar o reiniciar¶

sudo systemctl daemon-reload

sudo systemctl restart nombre-del-servicio

Comprobar el estado¶

systemctl is-active nombre-del-servicio

Comprobar el endpoint¶

curl -I URL

Revisar los registros posteriores¶

sudo journalctl -u nombre-del-servicio \
  --since "5 minutes ago" \
  --no-pager

Lista de comprobación de Grafana¶

[ ] El paquete está instalado.
[ ] El ejecutable existe.
[ ] El usuario grafana existe.
[ ] La unidad grafana-server existe.
[ ] El fichero grafana.ini existe.
[ ] Los directorios de datos existen.
[ ] Los permisos son correctos.
[ ] El servicio está activo.
[ ] El puerto 3000 está en escucha.
[ ] Grafana responde por HTTP.
[ ] Los registros no muestran errores críticos.
[ ] La fuente de datos de Prometheus funciona.

Lista de comprobación de Prometheus¶

[ ] El paquete o binario está instalado.
[ ] promtool está disponible.
[ ] El usuario prometheus existe.
[ ] El fichero prometheus.yml existe.
[ ] El directorio de datos existe.
[ ] Los permisos son correctos.
[ ] La configuración es válida.
[ ] La unidad systemd existe.
[ ] El servicio está activo.
[ ] El puerto 9090 está en escucha.
[ ] El endpoint de salud responde.
[ ] Los targets aparecen en la interfaz.
[ ] La consulta up devuelve resultados.

Lista de comprobación de Node Exporter¶

[ ] El binario existe.
[ ] El binario es ejecutable.
[ ] La arquitectura es compatible.
[ ] El usuario del servicio existe.
[ ] La unidad systemd existe.
[ ] El servicio está activo.
[ ] El puerto 9100 está en escucha.
[ ] El endpoint /metrics responde.
[ ] Se exponen métricas node_*.
[ ] Prometheus puede acceder al endpoint.
[ ] El target aparece como UP.

Comandos de diagnóstico rápido¶

Estado general¶

hostnamectl
lsb_release -ds
uname -m
df -h
free -h

Servicios¶

systemctl --failed
systemctl is-active grafana-server
systemctl is-active prometheus
systemctl is-active node_exporter

Puertos¶

sudo ss -lntp | grep -E ':(3000|9090|9100)\b'

Procesos¶

ps aux | grep -E \
  "[g]rafana|[p]rometheus|[n]ode_exporter"

Registros¶

sudo journalctl -u grafana-server -n 50 --no-pager
sudo journalctl -u prometheus -n 50 --no-pager
sudo journalctl -u node_exporter -n 50 --no-pager

Endpoints¶

curl -I http://localhost:3000
curl http://localhost:9090/-/healthy
curl -I http://localhost:9100/metrics

Configuración¶

promtool check config \
  /etc/prometheus/prometheus.yml

Buenas prácticas¶

Crea una copia de seguridad antes de modificar una configuración.
Valida los ficheros antes de reiniciar los servicios.
Comprueba siempre la versión y la arquitectura.
Lee los registros antes de buscar una solución.
Cambia un único elemento cada vez.
No elimines ficheros de bloqueo de APT mientras haya procesos activos.
No utilices permisos 777 como solución general.
No descargues binarios de fuentes desconocidas.
Comprueba la suma de verificación de los archivos.
Limita los puertos mediante el firewall.
No expongas Node Exporter públicamente sin necesidad.
Comprueba el espacio disponible antes de instalar.
Documenta las rutas reales si difieren de las habituales.
Conserva una copia de las configuraciones válidas.
No borres los datos de Prometheus o Grafana sin autorización.
Utiliza systemctl cat para entender cómo se inicia un servicio.
Utiliza promtool antes de reiniciar Prometheus.
Verifica la solución desde el punto de vista del cliente.
Conserva evidencias de las comprobaciones.

Tabla de síntomas y comprobaciones¶

Síntoma	Primera comprobación	Comprobación adicional
El paquete no se encuentra	`sudo apt update`	Revisar repositorios
APT está bloqueado	`ps aux \\| grep apt`	`lsof` sobre el lock
Grafana no inicia	`systemctl status grafana-server`	`journalctl`
Prometheus no inicia	`promtool check config`	`journalctl`
Node Exporter no inicia	`systemctl status node_exporter`	Arquitectura y permisos
Puerto ocupado	`sudo ss -lntp`	`lsof`
Endpoint no responde	`curl -v URL`	Servicio y firewall
Target `DOWN`	`up` y API de targets	Endpoint del exporter
Disco lleno	`df -h`	`du`
Permiso denegado	`stat` y `namei`	Usuario del servicio
Binario no ejecutable	`file` y `ls -l`	Arquitectura y permisos
Configuración inválida	Herramienta de validación	Copia de seguridad

Puntos clave¶

Un error de instalación debe investigarse de forma sistemática.
El mensaje visible no siempre contiene la causa real.
systemctl status muestra el estado general de un servicio.
journalctl muestra los registros de systemd.
ss permite comprobar puertos en escucha.
curl permite verificar endpoints HTTP.
promtool check config valida la configuración de Prometheus.
La arquitectura del binario debe coincidir con la arquitectura del sistema.
Los permisos deben permitir al usuario del servicio leer o escribir lo necesario.
Un puerto ocupado puede impedir que un servicio se inicie.
Un servicio activo no garantiza que su endpoint funcione correctamente.
La conectividad debe comprobarse desde el equipo que realiza la conexión.
Las copias de seguridad permiten recuperar una configuración válida.
APT no debe manipularse mientras otro proceso de paquetes está activo.
No se deben utilizar permisos excesivamente amplios como solución rápida.
Los cambios deben aplicarse uno a uno.
Toda incidencia debe documentar el síntoma, la causa, la solución y la validación.
El objetivo del diagnóstico es obtener una solución reproducible.

Preguntas de comprobación¶

¿Qué pasos seguirías ante un servicio que no inicia?
¿Qué comando permite consultar los registros de un servicio?
¿Qué comando permite comprobar si el puerto 9090 está ocupado?
¿Qué herramienta permite validar prometheus.yml?
¿Qué diferencia existe entre systemctl status y journalctl?
¿Qué puede provocar el error Unable to locate package?
¿Qué debes comprobar si aparece Exec format error?
¿Qué información proporciona uname -m?
¿Cómo comprobarías que el usuario prometheus puede leer su configuración?
¿Qué comando permite verificar el endpoint de Node Exporter?
¿Qué puede significar que un servicio esté activo pero no tenga ningún puerto en escucha?
¿Qué causas pueden producir un Connection refused?
¿Por qué no se debe eliminar manualmente un fichero de bloqueo de APT?
¿Qué pasos realizarías antes de modificar grafana.ini?
¿Cómo comprobarías si una descarga es realmente un archivo comprimido?
¿Qué diferencia existe entre 127.0.0.1:3000 y 0.0.0.0:3000?
¿Qué comprobarías si Prometheus muestra un target como DOWN?
¿Qué riesgos tiene utilizar chmod -R 777?
¿Qué información debe incluir un informe de incidencia?
¿Por qué es importante cambiar una sola cosa cada vez durante el diagnóstico?

Problemas de instalación¶

Objetivos¶

Introducción¶

Procedimiento general de diagnóstico¶

Identificar el componente afectado¶

Registrar el síntoma¶

Recopilar información del sistema¶

Comprobar el servicio¶

Consultar los registros¶

Comprobar el proceso y el puerto¶

Validar la configuración¶

Aplicar la solución¶

Información inicial del sistema¶

Consultar la versión de Ubuntu¶

Consultar la arquitectura¶

Consultar el kernel¶

Consultar el nombre del equipo¶

Consultar la fecha y la hora¶

Consultar la zona horaria¶

Comprobar el espacio disponible¶

Comprobar la memoria disponible¶

Comprobar la conectividad¶

Problemas con APT¶

Actualizar la información de paquetes¶

Actualizar los paquetes instalados¶

Comprobar si un paquete está instalado¶

Buscar un paquete¶

Consultar los paquetes pendientes de configuración¶

Reparar dependencias¶

Configurar paquetes pendientes¶

Limpiar la caché de paquetes¶

Consultar los registros de APT¶

Error: no se puede localizar el paquete¶

Error de bloqueo de APT¶

Error de configuración incompleta¶

Error de firma o repositorio no válido¶

Problemas al instalar Grafana¶

Comprobar si Grafana está instalado¶

Localizar el ejecutable¶

Comprobar el servicio¶

Comprobar la unidad¶

Consultar la configuración¶

Comprobar el puerto de Grafana¶

Comprobar la interfaz web¶

Consultar los registros¶

Error: el puerto 3000 está ocupado¶

Error: Grafana no puede escribir en sus directorios¶

Error: Grafana no inicia después de modificar grafana.ini¶

Problemas al instalar Prometheus¶

Comprobar si Prometheus está instalado¶

Comprobar promtool¶

Comprobar el servicio¶

Consultar la unidad¶

Consultar el proceso¶

Consultar el fichero de configuración¶

Validar la configuración¶

Error de sintaxis en prometheus.yml¶

Comprobar la sangría YAML¶

Error: el puerto 9090 está ocupado¶

Error: Prometheus no puede escribir los datos¶

Error: falta el directorio de datos¶

Error: Prometheus no encuentra el fichero de configuración¶

Error: Prometheus arranca, pero no tiene targets¶

Problemas al instalar Node Exporter¶

Comprobar el ejecutable¶

Comprobar la arquitectura¶

Consultar la versión¶

Comprobar el servicio¶

Consultar la unidad¶

Consultar los parámetros de ejecución¶

Comprobar el puerto¶

Comprobar las métricas¶

Error: unidad no encontrada¶

Error: el servicio se inicia y se detiene¶

Dar permiso de ejecución¶

Problemas con el usuario del servicio¶

Problemas con systemd¶

Consultar el estado¶

Consultar el código de salida¶

Consultar el motivo de un fallo¶

Error: Grafana no inicia después de modificar `grafana.ini`¶

Comprobar `promtool`¶

Error de sintaxis en `prometheus.yml`¶

Problemas con `systemd`¶