/ /

/ /

Retornar latencia de query a nivel de host

Cloud Manager dejará de admitir la Automatización, la Copia de seguridad y la Supervisión para MongoDB 3.6 y 4.0 después del 30de agosto de 2024. Por favor actualiza tu implementación de MongoDB o migra a Atlas.

Devuelve una lista de mediciones de latencia de consultas a nivel de host para el espacio de nombres 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 la ruta de solicitud

Parameter	Tipo	Descripción
PROJECT-ID	string	(Obligatorio) Cadena 24de dígitos hexadecimales única que identifica el proyecto que contiene el espacio de nombres.
hostId	string	(Obligatorio.) Identificador único del host al que pertenecen las mediciones.
nombreDeBaseDeDatos	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 prettyprint formato.	`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	Duración en la notación ISO 8601, que especifica cuánto tiempo atrás en el pasado se recuperarán las mediciones. Si especificas este valor, no puedes especificar `start` y `end`. 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 del inicio del período para el que se recuperarán las mediciones. Si especifica,`start` también debe especificar;`end` no puede `period` especificar.
end	string	Marca de tiempo en el formato ISO 8601 de la fecha y hora en UTC del final del periodo para el que se deben recuperar las mediciones. Si se especifica `end`, también se debe especificar `start` y no se puede 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 recopilación (duración total combinada de la operación del servidor / intervalo de recopilació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 número 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 escritura realizadas en una colección (intervalo de operaciones de escritura / 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.
nombreDeBaseDeDatos	string	Nombre que identifica la base de datos.
end	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC para el final del periodo para el cual recuperar mediciones.
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	Cadena de dígitos hexadecimales 24única que identifica el proyecto que contiene el espacio de nombres.
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.
mediciones	objeto arreglo	Cada objeto de esta matriz representa una medición y los puntos de datos para esa medición.
mediciones.puntosdedatos	objeto arreglo	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.
measurements.dataPoints.value	float	Valor de este punto.
measurements.name	string	Nombre de la medición. Los valores aceptados se proporcionan en el Página Tipos de medición.
measurements.units	string	Cómo se cuantifica esta medición.
processId	string	FQDN y puerto del proceso MongoDB.
Inicio	string	Sello de tiempo en ISO 8601 formato de fecha y hora en UTC para el inicio del período para el cual se van a 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)