/ /

/ /

Devolver la latencia de las queries a nivel de clúster

Cloud Manager dejará de ofrecer compatibilidad con automatización, copias de seguridad y monitorización para MongoDB 3.6 y 4.0 a partir del 30de agosto de 2024. Por favor, Actualice su implementación de MongoDB o migre a Atlas.

Devuelve una lista de mediciones de latencia de consultas a nivel de clúster para el espacio de nombres especificado.

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

Resource

GET /groups/{PROJECT-ID}/clusters/{hostClusterId}/{clusterView}/{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.
Id. del clúster del host	string	(Obligatorio) Identificador único del clúster que contiene el espacio de nombres.
Vista de clúster	string	(Obligatorio) Nombre que identifica la topología del clúster. Los valores incluyen: `PRIMARY` `SECONDARY` `INDIVIDUAL_PROCESS`
nombreDeBaseDeDatos	string	(Obligatorio.) Nombre que identifica la base de datos.
nombreDeColección	string	(Obligatorio.) Nombre que identifica la colección.

Parámetros de consulta de solicitud

Todos los parámetros son opcionales.

Nombre	Tipo	Descripción	predeterminado
bonita	booleano	Indica si el cuerpo de la respuesta debe estar en formato prettyprint. formato.	`false`
envolvente	booleano	Indica si se debe envolver o no la respuesta en un sobre.	`false`
Métricas	arreglo	Lista que contiene las métricas que se recuperarán para la serie de datos asociada. Si no se especifica este parámetro, este recurso devuelve la serie de datos para todas las métricas de latencia de consulta.	Todo
período	string	Duración en notación ISO 8601 que especifica la antigüedad de las mediciones. Si se especifica este valor, no se pueden especificar `start` `end`ni. 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 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`.

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 la operación de lectura en una recopilación (duración total combinada de la operación de lectura / intervalo de recopilación en segundos).
`WRITES_LATENCY`	Tasa que indica la duración total combinada de la operación de escritura en una colección (duración total combinada de la operación de escritura / intervalo de colección en segundos).
`COMMANDS_LATENCY`	Tasa que indica la duración total combinada de la operación de comando en una recopilación (duración total combinada de la operación de comando / intervalo de recopilació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 escritura dividida por el número de operaciones de escritura.
`AVERAGE_COMMANDS_LATENCY`	Duración de la operación de comando dividida por el número de operaciones de comando.
`TOTAL_OPS_P50_VALUE`	50Percentil en el histograma de latencia.
`READS_P50_VALUE`	50Percentil en el histograma de latencia de lectura.
`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 de lectura.
`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 de lectura.
`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 sobre 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 (intervalo de operaciones de lectura / 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 (intervalo de operaciones de comando / colección).

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
nombreDeColecció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 de grupo	string	Cadena de dígitos hexadecimales 24única que identifica el proyecto que contiene el espacio de nombres.
enlaces	matriz de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
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 medida. Los valores aceptados se dan en el Página detipos de medición.
medidas.unidades	string	Cómo se cuantifica esta medida.
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 para el cual se recuperarán las mediciones.

Ejemplo de solicitud

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}/clusters/{hostClusterId}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements?pretty=true&period={period}'

Ejemplo de respuesta

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}

Cuerpo de respuesta

{
  "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": "notApplicable",
  "start": "2024-03-21T13:40:02Z"
}

Volver

Unpin

Devolver espacios de nombres clasificados (clúster)