/ /

/ /

Gerente de Operaciones

Obtener tipos de medidas

Para recuperar el Lostipos de medición que se aplican a una medición específica sin devolver un documento grande emiten lo siguiente GET Comando con un valor de PT5M para granularity y period. Esto devuelve un documento con un solo punto de datos para cada medición.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/measurements

Parámetros de la ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único de la proyecto que posee el host.
ID DE HOST	string	Identificador único del host que sirve al proceso MongoDB.

Parámetros de consulta de solicitud

Parámetros de consulta únicos

Este punto final acepta los siguientes parámetros de consulta para filtrar las mediciones devueltas:

Nombre

Tipo

Descripción

granularity

Required

string

Duración en ISO 8601 notación que especifica el intervalo entre puntos de datos de medición.

La granularidad de la medición se puede expresar en días, horas, minutos, segundos y milisegundos utilizando la siguiente notación:

P (para el período) seguido de:

D por días (si se desea)
T por tiempo (después de días)
H durante horas
M por minutos
S por segundos

Por ejemplo:

Notación	Duración
`PT30S`	30 segundos
`P1T12H`	1 día, 12 horas
`PT0.5S`	500 milisegundos

período

string

Duration in ISO 8601 notation that specifies how far back in the past to retrieve measurements.

Por ejemplo, para solicitar las últimas 36 horas, incluye este parámetro de query: period=P1DT12H.

Inicio

string

Marca de tiempo en formato de fecha y hora ISO en 8601 UTC del inicio del período para el que se recuperarán las mediciones. Si especifica,start también debe end especificar.

end

string

Marca de tiempo en formato ISO 8601 de fecha y hora UTC para el final del período del que se recuperarán las mediciones. Si especifica,end también debe start especificar.

string

Medidas a devolver. Si no se especifica m, se devuelven todas las medidas.

To specify multiple values for m, you must repeat the m parameter.

Por ejemplo:

../measurements?m=CONNECTIONS&m=OPCOUNTER_CMD&m=OPCOUNTER_QUERY

Debe especificar medidas válidas para el host. Ops Manager devuelve un error si alguna medida especificada no es válida. Para conocer las medidas disponibles, consulte Tipos de medida.

Nota

Cada solicitud de medición debe incluir el parámetro de consulta period o los parámetros de consulta start y end.

Parámetros de consulta comunes

Este punto final también acepta los parámetros de consulta comunes a todos los puntos finales que devuelven una única respuesta:

Nombre

Tipo

Descripción

predeterminado

número de página

entero

Número de página (basado en el índice 1).

1

artículos por página

entero

Número de artículos a devolver por página, hasta un máximo de 500.

100

bonita

booleano

Indica si el cuerpo de la respuesta debe estar en formato prettyprint.

false

envolvente

booleano

Indica si se debe envolver o no la respuesta en un sobre.

Algunos clientes de API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionarlo, configure "envelope" : true en la consulta.

Para los puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:

Estado	Código de respuestaHTTP
envolvente	Cuerpo de respuesta esperado

Para los puntos finales que devuelven una lista de resultados, el objeto results es un sobre. Ops Manager añade el campo status al cuerpo de la respuesta.

Ninguno

Parámetros del cuerpo de la solicitud

Este punto final no utiliza parámetros del cuerpo de la solicitud HTTP.

Respuesta

Nombre	Tipo	Descripción
databaseName	string	Base de datos a la que se aplica la medición. Se completa únicamente para obtener mediciones de la base de datos.
end	string	Marca de tiempo en formato 8601 de fecha y hora ISO en UTC para el final del período que cubren las mediciones devueltas.
granularidad	string	Duration in ISO 8601 notation that specifies the size of the interval that each data point covers. Por ejemplo, `PT5M` especifica una granularidad de 5minutos.
ID de grupo	string	Identificador único del proyecto propietario del host.
ID de host	string	Unique identifier of the host to which the measurements pertain.
mediciones	matriz de objetos	Cada objeto de esta matriz representa una medición y los puntos de datos para esa medición.
mediciones.puntosdedatos	matriz de objetos	Cada objeto representa un único punto de datos. Si no hay ningún punto de datos disponible para un momento dado, este valor `value` se establece en `null`.
mediciones.puntosdedatos.marcadetiempo	string	Marca de tiempo en formato 8601 de fecha y hora ISO en UTC para el comienzo del intervalo de tiempo que representa este punto de datos.
mediciones.puntosdedatos.valor	float	Valor de este punto de datos.
mediciones.nombre	string	Nombre de la medición. Los valores aceptados se indican en la página "Tipos de medición".
medidas.unidades	string	Cómo se cuantifica esta medida. Las unidades aceptadas son: `PERCENT` `MILLISECONDS` `BYTES` `GIGABYTES` `BYTES_PER_SECOND` `MEGABYTES_PER_SECOND` `GIGABYTES_PER_HOUR` `SCALAR_PER_SECOND` `SCALAR`
partitionName	string	Nombre de la partición del disco que almacena la base de datos del proceso MongoDB. Se completa únicamente para obtener medidas de partición de disco.
processId	string	FQDN y puerto del proceso MongoDB.
Inicio	string	Marca de tiempo en formato ISO 8601 de fecha y hora en UTC para el comienzo del período que cubren las mediciones devueltas.

Ejemplo de solicitud

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/measurements?granularity=PT5M&period=PT5M"

Ejemplo de respuesta

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Cuerpo de respuesta

{
  "end": "2018-07-31T14:55:24Z",
  "granularity": "PT5M",
  "groupId": "{PROJECT-ID}",
  "hostId": "{HOST-ID}",
  "links": [
  ],
  "measurements": [
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": 0
        }
      ],
      "name": "CONNECTIONS",
      "units": "SCALAR"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "NETWORK_BYTES_IN",
      "units": "BYTES_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "NETWORK_BYTES_OUT",
      "units": "BYTES_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "NETWORK_NUM_REQUESTS",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_CMD",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_QUERY",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_UPDATE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_DELETE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_GETMORE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": null
        }
      ],
      "name": "OPCOUNTER_INSERT",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2018-07-31T14:55:24Z",
          "value": 0
        }
      ],
      "name": "LOGICAL_SIZE",
      "units": "BYTES"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_CHILDREN_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_CPU_CHILDREN_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_CHILDREN_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_NICE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_IOWAIT",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_IRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_SOFTIRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_GUEST",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_CPU_STEAL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_USER",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_KERNEL",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_NICE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_IOWAIT",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_IRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_SOFTIRQ",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_GUEST",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "SYSTEM_NORMALIZED_CPU_STEAL",
      "units": "PERCENT"
    }
  ],
  "processId": "{MONGODB-PROCESS-FQDN}:{PORT}",
  "start": "2018-07-31T14:55:24Z"
}

Volver

Tipos

Alertas