> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Métricas del servidor

> Inspeccionar memorias de proceso de GOWA, límites de contenedores, uso de disco, tiempo de actividad y cuenta de dispositivos.

`GET /app/metrics` devuelve una instantánea JSON para monitorear el servidor GOWA. La ruta utiliza la autenticación configurada por el servidor y no requiere `X-Device-Id` o un dispositivo registrado.

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" "$GOWA_URL/app/metrics"
```

La respuesta utiliza el sobre normal `code`, `message`, y `results`.

Establezca la URL del servidor y las credenciales antes de ejecutar los ejemplos de curl. Utilice la URL pública HTTPS para un servidor remoto e incluya `APP_BASE_PATH` cuando esté configurado.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Resultados de nivel superior

| Campo | Comenzando |
| - | - |
| `version` | Versión fuente de GOWA. |
| `session_store` | `sqlite` o `postgres`, seleccionado de la URI de la base de datos de sesión configurada. |
| `devices.total` | Dispositivos registrados. |
| `devices.logged_in` | Dispositivos con sesión de WhatsApp. |
| `devices.connected` | Dispositivos conectados a WhatsApp. |
| `system` | Procesos, memoria, carpeta y instantánea del sistema de archivos. |

Las cuentas de inicio de sesión y conexiones miden diferentes estados. Una sesión almacenada puede permanecer conectada mientras su dispositivo está desconectado.

## Campos del sistema

| Campo bajo `results.system` | Comenzando |
| - | - |
| `started_at` | RFC 3339 tiempo registrado durante la inicialización del proceso. |
| `uptime_seconds` | Segundos transcurridos desde ese tiempo, incluyendo la inicialización. |
| `go_version` | Ir a la versión de tiempo de ejecución. |
| `cpu_seconds` | Tiempo acumulado de CPU de proceso en segundos, incluyendo tiempo de usuario y sistema. Esto no es uso de CPU. |
| `memory.heap_alloc_bytes` | Asignado Go bytes del montón. |
| `memory.runtime_sys_bytes` | Bytes obtenidos por el tiempo de ejecución Go del sistema operativo. |
| `memory.process_rss_bytes` | Procesar memoria residente de Linux `/proc`. |
| `memory.container_bytes` | Memoria usada por el grupo de contenedores. |
| `memory.container_limit_bytes` | Límite de memoria del contenedor. `null` puede significar ilimitado o no disponible. |
| `memory.goroutines` | Número actual de goroutinas. |
| `memory.gc_cycles` | Ciclos de recolección de basura completados. |
| `folders.media.bytes` y `.files` | El tamaño y el recuento de entradas para el árbol de medios configurado. |
| `folders.storages.bytes` y `.files` | Tamaño y contador de entradas para el árbol de almacenamiento configurado. |
| `filesystem.total_bytes` | Capacidad total del sistema de archivos que contiene el directorio de almacenamiento. |
| `filesystem.free_bytes` | Espacio disponible en ese sistema de archivos. |

> [!NOTE]
>
> Trata métricas nulables como desconocidas en lugar de cero. El tiempo de CPU y la memoria residente en el proceso dependen de Linux `/proc`. La memoria del contenedor usa el montaje estándar `/sys/fs/cgroup`, probando cgroup v2 antes de v1. Estos campos pueden ser `null` en otras plataformas o cuando los archivos relevantes no están disponibles.

Las medidas de la carpeta se almacenan en caché por un minuto. Son el mejor esfuerzo y omiten entradas ilegibles. Los objetivos de los enlaces simbólicos de directorios no son recorridos. Los bytes de la carpeta no incluyen una base de datos remota de PostgreSQL, y no son un reemplazo para la medición de espacio libre del sistema de archivos.

## Encuesta la instantánea

Encuesta en un intervalo apropiado para su sistema de monitoreo. Compara los valores acumulados `cpu_seconds` a través de instantáneas para calcular el uso de CPU sobre un intervalo. Cuenta para reiniciar el proceso comprobando `started_at` antes de calcular los deltas.

Usa `/app/info` para funcionalidades habilitadas, ruta base y límites de medios. Usa `/app/metrics` para el uso de recursos. Ambos puntos finales funcionan antes de que exista un dispositivo.


## Related topics

- [Mejores prácticas de producción](https://gowa-docs.mintlify.site/es/advanced/best-practices.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/es/index.md)
- [Obtener métricas de salud del servidor](https://gowa-docs.mintlify.site/es/api-reference/app/obtener-métricas-de-salud-del-servidor.md)
- [Obtener metadatos del servidor](https://gowa-docs.mintlify.site/es/api-reference/app/obtener-metadatos-del-servidor.md)
- [Servidor MCP](https://gowa-docs.mintlify.site/es/integrations/mcp.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.