GET /metrics/data
Obtiene los datos almacenados en el sistema relativos a las métricas que se están monitorizando.
GET /metrics/data.json | Obtiene los datos almacenados en el sistema de todas las métricas que se están monitorizando. En sistemas con un número de métricas alto, se desaconseja ejecutar este endpoint sin parámetros ya que el volumen de datos puede ser muy elevado. |
GET /metrics/data.json?lapse=hour | Obtiene los datos almacenados en el sistema de todas las métricas que se están monitorizando en la última hora. |
GET /metrics /data/12.json GET /metrics/data.json?id=12 |
Obtiene los datos almacenados correspondientes a la métrica con id=12 |
GET /metrics /data/12.json?lapse=week GET /metrics /data/12.json?lapse=week_0 |
Obtiene los valores de la última semana de la métrica cuyo con id 12. |
GET /metrics /data/12.json?lapse=hour GET /metrics /data/12.json?lapse=hour_0 |
Obtiene los valores de la última hora de la métrica cuyo con id 12. |
Periodos
El periodo se indica con el parámetro lapse y en caso de no indicarse se devolverán todos los valores de la métrica. Los diferentes periodos que hay son:
Nombre | Descripción |
---|---|
year | Obtiene los valores del año actual |
month | Obtiene los valores del mes |
week | Obtiene los valores de la semana actual |
today | Obtiene los valores de hoy |
hour | Obtiene los valores de la hora actual |
minute | Obtiene los valores del minuto actual |
year_[n] | Siendo n un valor entero e indica los valores de hace n años (y los 365 días siguientes) |
month_[n] | Siendo n un valor entero e indica los valores de hace n meses (y los 30 días siguientes) |
week_[n] | Siendo n un valor entero e indica los valores de hace n semanas (y los 7 días siguientes) |
day_[n] | Siendo n un valor entero e indica los valores de hace n días (y las 24 horas siguientes) |
hour_[n] | Siendo n un valor entero e indica los valores de hace n horas (y los 60 minutos siguientes) |
minute_[n] | Siendo n un valor entero e indica los valores de hace n minutos (y los 60 segundos siguientes) |
Códigos de respuesta
Código | Descripción |
---|---|
200 | Resultado correcto |
400 | Error en la petición. |
401 | Error de autenticación. |
403 | Error por falta de permisos. |
500 | Error interno del servidor |
Valor devuelto
Devuelve un vector de datos codificado en json.
Los campos se corresponden con los nombres de los items de la métrica y los valores para cada momento.
Ejemplos
root@cnm-devel2:/var/www/html/onm/api/inc# curl -ki -H "Authorization: 7a4efe58b01e7975efcbbbd421b95eba" "https://localhost/onm/api/1.0/metrics/data/1530.json?lapse=hour"
HTTP/1.1 200 OK
Date: Mon, 03 Mar 2014 13:15:46 GMT
Server: Apache/2.2.16 (Debian) PHP/5.3.3-7 with Suhosin-Patch proxy_html/3.0.1 mod_ssl/2.2.16 OpenSSL/0.9.8o mod_perl/2.0.4 Perl/v5.10.1
X-Powered-By: PHP/5.3.3-7
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Pragma: no-cache
:
Vary: Accept-Encoding
Content-Length: 774
Content-Type: text/html; charset=utf-8
{"label":["memAvailReal.0","memTotalReal.0"],"data":[{"t":139385279,"v":["1.6838789333e+05","2.0614040000e+06"]},{"t":139385280,"v":["1.6838789333e+05","2.0614040000e+06"]},{"t":139385310,"v":["1.6478112000e+05","2.0614040000e+06"]},{"t":139385340,"v":["1.6148586667e+05","2.0614040000e+06"]},{"t":139385370,"v":["1.5496760000e+05","2.0614040000e+06"]},{"t":139385400,"v":["1.2838408000e+05","2.0614040000e+06"]},{"t":139385430,"v":["1.3931682667e+05","2.0614040000e+06"]},{"t":139385460,"v":["1.3729805333e+05","2.0614040000e+06"]},{"t":139385490,"v":["1.6909468000e+05","2.0614040000e+06"]},{"t":139385520,"v":["1.4842090667e+05","2.0614040000e+06"]},{"t":139385550,"v":["1.4470797333e+05","2.0614040000e+06"]},{"t":139385580,"v":["1.0709568000e+05","2.0614040000e+06"]}]}