ovahubConsultar métricas del servidor
/api/v1/servers/:id/metrics
Consulta las métricas almacenadas del servidor. latest es el informe más reciente; samples contiene puntos históricos con una estructura diferente.
Los nombres de campos, los tipos y el código de la API se mantienen iguales en todos los idiomas.
Ejemplo de petición
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/metrics?period=24hr" \
-H "Authorization: Bearer $TOVAHUB_TOKEN"Solo ejemplos. Esta página no envía peticiones.
Respuesta ilustrativa
{
"period": "24hr",
"serverStatus": "running",
"metrics": {
"online": false,
"reportingMode": 1,
"reportInterval": 60,
"lastReportedAt": null,
"lastSampledAt": null,
"bootChangedAt": null,
"shutdownAt": null
},
"latest": null,
"samples": []
}Parámetros
idRuta · Obligatoriostring
ID del recurso: 24 caracteres hexadecimales. Use el ID de la plataforma devuelto por el endpoint de listado correspondiente, no el ID de instancia del proveedor.
periodConsulta · Opcional"1hr" | "24hr" | "7d"
El valor predeterminado es 24hr.
Respuesta
Estado HTTP 200
Consulta las métricas guardadas del host, el informe más reciente y las muestras históricas.
periodstring ('1hr' | '24hr' | '7d')Período histórico solicitado.
serverStatusstringEstado guardado del servidor, normalizado.
metricsobjectMetadatos de actividad del monitoreo.
metrics.onlinebooleanIndica si los informes recientes muestran que el agente está en línea.
metrics.reportingModenumberModo de envío de informes configurado actualmente; el valor predeterminado es uno.
metrics.reportIntervalnumberIntervalo esperado entre informes, en segundos.
metrics.lastReportedAtstring (ISO 8601) | nullMarca de tiempo de recepción del último informe.
metrics.lastSampledAtstring (ISO 8601) | nullMarca de tiempo de la última muestra.
metrics.bootChangedAtstring (ISO 8601) | nullÚltimo cambio de arranque detectado.
metrics.shutdownAtstring (ISO 8601) | nullÚltimo apagado notificado.
latestobject | nullÚltimo informe guardado de métricas o apagado, o null si aún no hay informes. Sus campos difieren de los de las muestras históricas.
latest.version1Versión del formato del informe.
latest.kind"metrics" | "shutdown"Tipo de informe.
latest.bootIdstring (UUID)Identificador del arranque informado.
latest.intervalnumberIntervalo de muestreo en segundos, entre 5 y 300.
latest.uptimenumberTiempo de actividad en segundos.
latest.sampledAtnumber (optional)Marca de tiempo de la muestra del cliente, en milisegundos desde la época Unix.
latest.cpunumber | nullUso de CPU entre 0 y 100 por ciento, o null si no está disponible.
latest.memoryUsednumberMemoria usada en bytes.
latest.memoryTotalnumberMemoria total en bytes.
latest.swapUsednumberEspacio de intercambio usado en bytes.
latest.swapTotalnumberEspacio de intercambio total en bytes.
latest.diskReadnumber | nullVelocidad de lectura del disco en bytes por segundo.
latest.diskWritenumber | nullVelocidad de escritura del disco en bytes por segundo.
latest.netInnumber | nullVelocidad de recepción de red en bytes por segundo.
latest.netOutnumber | nullVelocidad de transmisión de red en bytes por segundo.
latest.disksobject[]Hasta 32 discos montados con mount (cadena), total (bytes) y used (bytes).
samplesarrayHasta 600 puntos históricos ordenados por tiempo. Los valores numéricos son promedios por intervalo; low y high conservan los mínimos y máximos de cada métrica.
samples[].atstring (ISO 8601)Marca de tiempo de la muestra histórica.
samples[].cpunumber | nullPorcentaje de uso de CPU, o null si no está disponible.
samples[].memoryUsednumber | nullCapacidad en bytes, o null si no está disponible.
samples[].memoryTotalnumber | nullCapacidad en bytes, o null si no está disponible.
samples[].swapUsednumber | nullCapacidad en bytes, o null si no está disponible.
samples[].swapTotalnumber | nullCapacidad en bytes, o null si no está disponible.
samples[].diskReadnumber | nullVelocidad de transferencia en bytes por segundo, o null si no está disponible.
samples[].diskWritenumber | nullVelocidad de transferencia en bytes por segundo, o null si no está disponible.
samples[].netInnumber | nullVelocidad de transferencia en bytes por segundo, o null si no está disponible.
samples[].netOutnumber | nullVelocidad de transferencia en bytes por segundo, o null si no está disponible.
samples[].uptimenumber | nullTiempo de actividad en segundos, o null si no está disponible.
samples[].disksarrayDiscos montados: {mount: string, used: number, total: number}. Las capacidades se expresan en bytes.
samples[].lowobjectValores mínimos por métrica, con los mismos diez nombres de métricas numéricas como claves.
samples[].highobjectValores máximos por métrica, con los mismos diez nombres de métricas numéricas como claves.