/ /

/ /

Retornar latencia de query a nivel de host

Devuelve una lista de mediciones de query latencia a nivel de host para el namespace especificado.

URL base: https://cloud.mongodb.com/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/hosts/{hostId}/{databaseName}/{collectionName}/collStats/measurements

Parámetros de ruta de solicitud

Parameter	Tipo	Descripción
PROJECT-ID	string	(Obligatorio). string única de 24dígitos hexadecimales que identifica el Proyecto que contiene el namespace.
hostId	string	(Obligatorio). Identificador único del host al que se refieren las mediciones.
databaseName	string	(Obligatorio). Nombre que identifica la base de datos.
Nombre de colección	string	(Obligatorio.) Nombre que identifica la colección.

Parámetros de Solicitud Query

Todos los parámetros son opcionales.

Nombre	Tipo	Descripción	predeterminado
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.	`false`
Métricas	arreglo	Lista que contiene las métricas a recuperar para las series de datos asociadas. Si no especifica este parámetro, este recurso devuelve la serie de datos para todas las métricas de latencia de query.	Todo
punto	string	ISO 8601 que especifica cuán lejos en el pasado se deben recuperar las mediciones. Si especifica este valor, no puede especificar `start` y `end`. Por ejemplo, para solicitar las últimas 36 horas, incluye este parámetro de query: `period=P1DT12H`.
Inicio	string	ISO 8601 para el inicio del período del cual se desea recuperar mediciones. Si especificas `start`, también debes especificar `end` y no puedes especificar `period`.
end	string	ISO 8601 para el final del período en el que se deben recuperar las mediciones. Si especificas `end` también debes especificar `start` y no puedes especificar `period`.

Parámetros del cuerpo de la solicitud

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

Métricas

Métrica	Descripción
`TOTAL_LATENCY`	Tasa que indica la duración total combinada de la operación del servidor en una colección (duración total combinada de la operación del servidor / intervalo de colección en segundos).
`READS_LATENCY`	Tasa que indica la duración total combinada de las operaciones de lectura en una colección (duración total combinada de operaciones de lectura / intervalo de colección en segundos).
`WRITES_LATENCY`	Tasa que indica la duración total combinada de las operaciones de guardado en una colección (duración total combinada de las operaciones de guardado / intervalo de colección en segundos).
`COMMANDS_LATENCY`	Tasa que indica la duración total combinada de la operación de comando en una colección (duración total combinada de la operación de comando / intervalo de colección en segundos).
`AVERAGE_TOTAL_OPS_LATENCY`	Duración total de la operación del servidor dividida por el recuento total de operaciones del servidor en todos los tipos de operación.
`AVERAGE_READS_LATENCY`	Duración de la operación de lectura dividida por el recuento de operaciones de lectura.
`AVERAGE_WRITES_LATENCY`	Duración de la operación de guardar dividida por el recuento de la operación de guardar.
`AVERAGE_COMMANDS_LATENCY`	Duración de la operación por comando dividida por el número de operaciones por comando.
`TOTAL_OPS_P50_VALUE`	50percentil en el histograma de latencia.
`READS_P50_VALUE`	50percentil en el histograma de latencia.
`WRITES_P50_VALUE`	50percentil en el histograma de latencia de escritura.
`COMMANDS_P50_VALUE`	50percentil en el histograma de latencia del comando .
`TOTAL_OPS_P95_VALUE`	95percentil en el histograma de latencia.
`READS_P95_VALUE`	95percentil en el histograma de latencia.
`WRITES_P95_VALUE`	95percentil en el histograma de latencia de escritura.
`COMMANDS_P95_VALUE`	95percentil en el histograma de latencia del comando .
`TOTAL_OPS_P99_VALUE`	99percentil en el histograma de latencia en todas las operaciones.
`READS_P99_VALUE`	99percentil en el histograma de latencia.
`WRITES_P99_VALUE`	99percentil en el histograma de latencia de escritura.
`COMMANDS_P99_VALUE`	99percentil en el histograma de latencia del comando .
`TOTAL_OPS`	Tasa que indica el número total de operaciones realizadas en una colección (total de operaciones/intervalo de colección).
`READS_OPS`	Tasa que indica el número de operaciones de lectura realizadas en una colección (operaciones de lectura / intervalo de colección).
`WRITES_OPS`	Tasa que indica el número de operaciones de guardado realizadas en una colección (operaciones de guardado / intervalo de colección).
`COMMANDS_OPS`	Tasa que indica el número de operaciones de comando realizadas en una colección (operaciones de comando/intervalo de colección).

Respuesta

Nombre	Tipo	Descripción
Nombre de colección	string	Nombre que identifica la colección.
databaseName	string	Nombre que identifica la base de datos.
end	string	ISO 8601 para el final del periodo del que recuperar mediciones.
Granularidad	string	ISO 8601 que especifica el tamaño del intervalo que abarca cada punto. Por ejemplo, `PT5M` especifica una granularidad de 5minutos.
ID del grupo	string	string única de 24dígitos hexadecimales que identifica el Proyecto que contiene el namespace.
enlaces	objeto arreglo	Uno o más enlaces a subrecursos y/o recursos relacionados. Todos los `links` arreglos en las respuestas incluyen al menos un enlace llamado `self`. Las relaciones entre URLs se explican en la Especificación de Enlaces Web.
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	ISO 8601 para el inicio del intervalo de tiempo que representa este punto de datos.
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.
processId	string	FQDN y puerto del proceso de MongoDB.
Inicio	string	ISO 8601 para el inicio del periodo para el que se deben recuperar las mediciones.

Solicitud de ejemplo

curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \
 --header 'Accept: application/json' \
 --include \
 --request GET 'https://{CLOUD-MANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/hosts/{hostId}/{databaseName}/{collectionName}/collStats/measurements?pretty=true&period={period}'

Respuesta de ejemplo

Encabezado de respuesta

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

{
  "collectionName": {collectionName},
  "databaseName": "{datbaseName}",
  "end": "2024-03-21T13:49:25Z",
  "granularity": "PT10M",
  "groupId": "{PROJECT-ID}",
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/hosts/{hostId}/{databaseName}/collectionName/collStats/measurements?period={period}",
      "rel": "self"
    },
    {
      "href": "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}",
      "rel": "https://cloud.mongodb.com/group"
    }
  ],
  "measurements": [
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-22T20:26:17Z",
          "value": null
        },
        {
          "timestamp": "2024-03-22T20:31:29Z",
          "value": 0.003203013395002018
        },
        {
          "timestamp": "2024-03-22T20:41:29Z",
          "value": 0.0016666722222407407
        }
      ],
      "name": "READS_OPS",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 115.25475560992174
        }
      ],
      "name": "READS_LATENCY",
      "units": "MICROSECONDS_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 229.8723404255319
        }
      ],
      "name": "AVERAGE_READS_LATENCY",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 98.5945945945946
        }
      ],
      "name": "READS_P50_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 174.54545454545456
        }
      ],
      "name": "READS_P95_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 244.36363636363637
        }
      ],
      "name": "READS_P99_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-22T20:26:17Z",
          "value": null
        },
        {
          "timestamp": "2024-03-22T20:31:29Z",
          "value": 0.0
        },
        {
          "timestamp": "2024-03-22T20:41:29Z",
          "value": 0.0
        }
      ],
      "name": "WRITES_OPS",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 0.0
        }
      ],
      "name": "WRITES_LATENCY",
      "units": "MICROSECONDS_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "AVERAGE_WRITES_LATENCY",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "WRITES_P50_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "WRITES_P95_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "WRITES_P99_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-22T20:26:17Z",
          "value": null
        },
        {
          "timestamp": "2024-03-22T20:31:29Z",
          "value": 0.0
        },
        {
          "timestamp": "2024-03-22T20:41:29Z",
          "value": 0.0
        }
      ],
      "name": "COMMANDS_OPS",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 0.0
        }
      ],
      "name": "COMMANDS_LATENCY",
      "units": "MICROSECONDS_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "AVERAGE_COMMANDS_LATENCY",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "COMMANDS_P50_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "COMMANDS_P95_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": null
        }
      ],
      "name": "COMMANDS_P99_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 0.5013859231457166
        }
      ],
      "name": "TOTAL_OPS",
      "units": "SCALAR_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 115.25475560992174
        }
      ],
      "name": "TOTAL_LATENCY",
      "units": "MICROSECONDS_PER_SECOND"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 229.8723404255319
        }
      ],
      "name": "AVERAGE_TOTAL_OPS_LATENCY",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 98.5945945945946
        }
      ],
      "name": "TOTAL_OPS_P50_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 174.54545454545456
        }
      ],
      "name": "TOTAL_OPS_P95_VALUE",
      "units": "MICROSECONDS"
    },
    {
      "dataPoints": [
        {
          "timestamp": "2024-03-21T13:40:02Z",
          "value": null
        },
        {
          "timestamp": "2024-03-21T13:49:25Z",
          "value": 244.36363636363637
        }
      ],
      "name": "TOTAL_OPS_P99_VALUE",
      "units": "MICROSECONDS"
    }
  ],
  "processId": "{MONGODB-PROCESS-FQDN}:{PORT}",
  "start": "2024-03-21T13:40:02Z"
}

Volver

Devolver namespace clasificados (clúster)

Devolver Namespaces Clasificados (host)