Conoce tus puertos

localhost:9090Guía del puerto de la interfaz web de Prometheus

Actualizado el 25 oct 2026

localhost:9090

Puerto de la interfaz web de Prometheus

Abrir localhost:9090

Accede a la interfaz de consultas y a la API HTTP de Prometheus en el puerto 9090

Localhost:9090 es el puerto por defecto de Prometheus, el sistema de monitorización y base de datos de series temporales de código abierto. Si lo abres en el navegador verás la interfaz web de Prometheus: la página de consultas PromQL con gráficas, y las páginas Targets, Alerts y Status. El mismo puerto sirve la API HTTP (/api/v1/query) y las métricas del propio Prometheus en /metrics.

El 9090 tiene otros inquilinos conocidos: Cockpit, la consola web de servidores Linux que incluyen Fedora y las distribuciones de la familia RHEL, y la consola de administración del servidor XMPP Openfire. Si buscabas el panel de OpenClaw, las versiones actuales de OpenClaw lo sirven en el puerto 18789 por defecto, no en el 9090.

Acceder a localhost:9090 desde otros dispositivos

Usa un túnel de Pinggy para compartir tu interfaz de Prometheus sin complicaciones:

SSH CLI
Mac / Linux Windows Powershell Windows CMD

Esto expone la interfaz al instante. Aviso: Prometheus no pide inicio de sesión por defecto, así que cualquiera con la URL puede lanzar consultas y leer todas las métricas que recoges. Añade autenticación básica al túnel con ssh -p 443 -R0:localhost:9090 -t free.pinggy.io b:username:password, o define basic_auth_users en un --web.config.file de Prometheus.

Servicios y programas que usan el puerto 9090

Prometheus y monitorización

  • Prometheus: interfaz web, API HTTP y métricas propias, por defecto --web.listen-address=":9090"
  • Pushgateway: componente de Prometheus para trabajos de corta duración, con el 9091 como puerto por defecto (Alertmanager usa el 9093 y los exportadores empiezan en el 9100)

Administración de servidores y otras aplicaciones

  • Cockpit: consola web de servidores Linux, escucha en el 9090 mediante cockpit.socket
  • Openfire: consola de administración del servidor XMPP en el 9090 (HTTP) y el 9091 (HTTPS)

¿Buscas OpenClaw? Su pasarela (que conecta aplicaciones de mensajería como Telegram o Discord con el LLM) y su panel usan el puerto 18789 por defecto. Solo escucha en el 9090 si la arrancas con openclaw gateway --port 9090 o defines gateway.port en su configuración (o la variable de entorno OPENCLAW_GATEWAY_PORT); si no, abre http://127.0.0.1:18789/ o ejecuta openclaw dashboard.

Cómo resolver problemas con localhost:9090

Paso 1: comprueba que Prometheus está en marcha

Acción: arráncalo con ./prometheus --config.file=prometheus.yml, revisa systemctl status prometheus si lo instalaste con un paquete, o ejecútalo en Docker con docker run -p 9090:9090 prom/prometheus.

Paso 2: mira quién ocupa el puerto

Acción: ejecuta lsof -i :9090 (macOS/Linux) o netstat -ano | findstr :9090 (Windows). En Fedora o RHEL, muchas veces la respuesta es systemd con cockpit.socket, no Prometheus.

Paso 3: prueba la conexión

Acción: curl http://localhost:9090/-/healthy debería devolver Prometheus Server is Healthy. y curl http://localhost:9090/-/ready devuelve Prometheus Server is Ready. cuando ya puede atender consultas.

Problemas habituales y sus soluciones

Estos son los fallos típicos con localhost:9090 y cómo resolverlos:

Error «Connection Refused»

Problema: no consigues llegar a la interfaz de Prometheus.

Solución: asegúrate de que Prometheus terminó de arrancar sin errores de configuración. En Docker hay que publicar el puerto con -p 9090:9090, y un --web.listen-address personalizado saca la interfaz del 9090.

Error «bind: address already in use»

Problema: Prometheus se cierra al arrancar porque Cockpit u otra instancia de Prometheus ya ocupa el 9090. No cambia de puerto por su cuenta.

Solución: usa lsof -i :9090 para ver quién lo ocupa. Arranca Prometheus con --web.listen-address=":9095" o mueve Cockpit con sudo systemctl edit cockpit.socket. Evita el 9091, que es de Pushgateway (y de la consola HTTPS de Openfire).

Resumen

  • Qué es: localhost:9090 es el puerto por defecto de la interfaz web y la API HTTP de Prometheus, y también el de las consolas de administración de Cockpit y Openfire.
  • Resolución de problemas: si el 9090 está ocupado, Prometheus falla con «address already in use» en lugar de cambiar de puerto. Localiza al responsable con lsof -i :9090 y mueve uno de los servicios con --web.listen-address.

Comandos rápidos

# Ejecutar Prometheus en el puerto 9090
docker run -p 9090:9090 prom/prometheus

# Comprobar que está sano
curl http://localhost:9090/-/healthy

# Comprobar qué se está ejecutando en el 9090
lsof -i :9090