/ /

Gerente de Operaciones

Obtener mediciones de particiones de disco

Las métricas de disco proporcionan datos sobre IOPS, uso de disco y latencia de disco en las particiones de disco de los hosts que ejecutan MongoDB, los cuales son recogidos por las Automatizaciones. Debes ejecutar la Automatización de Ops Manager para recuperar las medidas de disco.

Nota

Para calcular algunas series de métricas, Ops Manager toma la tasa entre cada dos puntos adyacentes. Para estas series de métricas, el primer punto de datos tiene un valor nulo porque Ops Manager no puede calcular una tasa para el primer punto de datos dado el rango de tiempo de query.

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

Resource

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/disks/{PARTITION-NAME}/measurements

Parámetros de ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único de la proyecto que es el propietario del host.
ID DEL HOST	string	Identificador único del host que sirve el proceso MongoDB.
PARTITION-NAME	string	Nombre de la partición de disco en la que se almacena el proceso de MongoDB.

Parámetros de Solicitud Query

Parámetros únicos de query

Este endpoint acepta los siguientes parámetros de query para filtrar las mediciones retornadas:

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 como días, horas, minutos, segundos y milisegundos utilizando la siguiente notación:

P (para período) seguido de:

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

Por ejemplo:

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

punto

string

Duración en notación ISO 8601 que especifica el tiempo a retroceder en el pasado para recuperar mediciones.

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

Inicio

string

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

end

string

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

string

Mediciones a devolver. Si no se especifica m, se devuelven todas las mediciones.

Para especificar varios valores para m, debe repetir el parámetro m.

Por ejemplo:

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

Debe especificar medidas que sean válidas para el host. Ops Manager devuelve un error si alguna de las mediciones especificadas no es válida. Para las mediciones disponibles, consulte Tipos de medición.

Nota

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

Parámetros de query comunes

Este endpoint también acepta los parámetros de query comunes a todos los endpoints que devuelven una sola respuesta:

Nombre

Tipo

Descripción

predeterminado

Num. de pág.

entero

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

1

elementosPorPágina

entero

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

100

bonito

booleano

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

false

envelope

booleano

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

Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP o al código de estado. Para remediarlo, establezca "envelope" : true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de respuesta incluye:

Nombre	Descripción
`status`	Código de respuesta HTTP
`content`	Cuerpo de respuesta esperado

Para los endpoints que devuelven una lista de resultados, el objeto results es un sobre. Ops Manager agrega el campo status al cuerpo de la respuesta.

Ninguno

Parámetros del cuerpo de la solicitud

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

Respuesta

Nombre	Tipo	Descripción
databaseName	string	Base de datos a la que se aplica la medición. Solo se rellena para Obtener medidas de base de datos.
end	string	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC para el final del período que cubren las mediciones devueltas.
Granularidad	string	Duración en notación ISO 8601 que especifica el tamaño del intervalo que cubre cada punto de datos. Por ejemplo, `PT5M` especifica una granularidad de 5minutos.
ID del grupo	string	Identificador único del proyecto que posee el host.
hostId	string	Identificador único del host al que se refieren las mediciones.
medidas	objeto arreglo	Cada objeto en este arreglo representa una medición y los puntos de datos para esa medición.
measurements.dataPoints	objeto arreglo	Cada objeto representa un único punto de datos. Si no hay ningún punto de datos disponible para un momento en particular en el tiempo, este `value` se establece como `null`.
measurements.dataPoints.timestamp	string	Marca de tiempo en ISO 8601 formato de fecha y hora en UTC para el inicio del intervalo de tiempo que representa este punto de dato.
measurements.dataPoints.value	float	Valor de este punto.
measurements.name	string	Nombre de la medición. Los valores aceptados se dan en la página Tipos de medidas.
measurements.units	string	Cómo se cuantifica esta medición. 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 de disco que almacena la base de datos del proceso MongoDB. Solo se rellena para Obtener medidas de partición del disco.
processId	string	FQDN y puerto del proceso de MongoDB.
Inicio	string	Marca temporal en ISO 8601 formato de fecha y hora en UTC para el inicio del período que cubren las mediciones devueltas.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/hosts/{HOST-ID}/disks/{PARTITION-NAME}/measurements?granularity={TIME-INCREMENT}&period={PERIOD}"

Respuesta de ejemplo

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}

Respuesta del cuerpo

{
  "granularity": "{TIME-INCREMENT}",
  "groupId": "{PROJECT-ID}",
  "hostId": "{HOST-ID}",
  "links": [
  ],
  "measurements": [
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_IOPS_READ",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_IOPS_WRITE",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_IOPS_TOTAL",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_LATENCY_READ",
      "units": "MILLISECONDS"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_LATENCY_WRITE",
      "units": "MILLISECONDS"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_FREE",
      "units": "BYTES"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_USED",
      "units": "BYTES"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_PERCENT_FREE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [],
      "name": "DISK_PARTITION_SPACE_PERCENT_USED",
      "units": "PERCENT"
    }
  ],
  "partitionName": "{PARTITION-NAME}",
  "processId": "{MONGODB-PROCESS-FQDN}:{PORT}"
}

Volver

host

Database