返回集群级查询延迟
返回指定命名空间的集群级查询延迟测量值列表。
基本 URL： https://cloud.mongodb.com/api/public/v 1.0
Resource
GET /groups/{PROJECT-ID}/clusters/{hostClusterId}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements
请求路径参数
Parameter | 类型 | 说明 |
|---|---|---|
PROJECT-ID | 字符串 | （必需。） 唯一的 24-十六进制数字string ，用于标识包含命名空间的项目。 |
hostClusterId | 字符串 | （必需。） 包含命名空间的集群的唯一标识符。 |
clusterView | 字符串 | （必需。） 标识集群拓扑结构的名称。 值包括：
|
数据库名称 | 字符串 | （必需。） 标识数据库的名称。 |
collectionName | 字符串 | （必需。） 标识集合的名称。 |
请求查询参数
所有参数都是可选的。
名称 | 类型 | 说明 | 默认 |
|---|---|---|---|
pretty | 布尔 | 指示响应正文是否应采用 美观打印 格式。 | false |
envelope | 布尔 | 指示是否要将响应封装在信封中。 | false |
衡量标准 | 阵列 | 包含要为关联数据系列检索的指标的列表。 如果不指定此参数，此资源将返回所有查询延迟指标的数据系列。 | 所有 |
period | 字符串 | 以 ISO 的持续时间8601 表示法，指定检索过去多久的测量值。如果指定此值，则不能指定 示例，要请求最近36小时的数据，请包含以下查询参数： | |
开始 | 字符串 | ||
end | 字符串 |
衡量标准
衡量标准 | 说明 |
|---|---|
TOTAL_LATENCY | 表示集合中服务器操作总持续时间的速率（服务器操作总持续时间/集合间隔（秒））。 |
READS_LATENCY | 指示集合上的总组合读取操作持续时间的速率（总组合读取操作持续时间/以秒为单位的集合间隔）。 |
WRITES_LATENCY | 指示集合上组合写入操作的总持续时间的比率（组合写入操作的总持续时间/以秒为单位的集合间隔）。 |
COMMANDS_LATENCY | 指示集合上组合命令操作总持续时间的速率（组合命令操作总持续时间/以秒为单位的收集间隔）。 |
AVERAGE_TOTAL_OPS_LATENCY | 服务器操作总持续时间除以所有操作类型的服务器操作总数。 |
AVERAGE_READS_LATENCY | 读取操作持续时间除以读取操作计数。 |
AVERAGE_WRITES_LATENCY | 写入操作持续时间除以写入操作计数。 |
AVERAGE_COMMANDS_LATENCY | 命令操作持续时间除以命令操作计数。 |
TOTAL_OPS_P50_VALUE | 延迟直方图中第50个百分位数。 |
READS_P50_VALUE | 读取延迟直方图中第50个百分位数。 |
WRITES_P50_VALUE | 写入延迟直方图中的第50个百分位数。 |
COMMANDS_P50_VALUE | 命令延迟直方图中的第50个百分位数。 |
TOTAL_OPS_P95_VALUE | 延迟直方图中第95个百分位数。 |
READS_P95_VALUE | 读取延迟直方图中第95个百分位数。 |
WRITES_P95_VALUE | 写入延迟直方图中的第95个百分位数。 |
COMMANDS_P95_VALUE | 命令延迟直方图中的第95个百分位数。 |
TOTAL_OPS_P99_VALUE | 所有操作的延迟直方图中第99个百分位数。 |
READS_P99_VALUE | 读取延迟直方图中第99个百分位数。 |
WRITES_P99_VALUE | 写入延迟直方图中的第99个百分位数。 |
COMMANDS_P99_VALUE | 命令延迟直方图中的第99个百分位数。 |
TOTAL_OPS | 表示对集合执行的操作总数的比率（操作总数/收集间隔）。 |
READS_OPS | 表示对集合执行的读取操作次数的比率（读取操作数/集合间隔）。 |
WRITES_OPS | 表示对集合执行的写入操作次数的比率（写入操作数/集合间隔）。 |
COMMANDS_OPS | 表示对集合执行的命令操作次数的比率（命令操作/集合间隔）。 |
请求正文参数
此端点不使用 HTTP 请求正文参数。
响应
名称 | 类型 | 说明 |
|---|---|---|
collectionName | 字符串 | 标识集合的名称。 |
数据库名称 | 字符串 | 标识数据库的名称。 |
end | 字符串 | ISO8601 格式的时间戳 以 UTC 格式表示要检索测量值的时间段结束的日期和时间格式。 |
粒度 | 字符串 | 以 ISO8601 的持续时间 符号，指定每个数据点覆盖的区间大小。 示例， |
groupId | 字符串 | 唯一的 24-十六进制数字string ，用于标识包含命名空间的项目。 |
链接 | 对象数组 | 指向子资源和/或相关资源的一个或多个链接。 响应中的所有 |
测量 | 对象数组 | 该数组中的每个对象代表一个测量值以及该测量值的数据点。 |
measurements.dataPoints | 对象数组 | 每个对象代表一个数据点。 如果在特定时间点没有可用的数据点，则此 value将设置为null 。 |
measurements.dataPoints.timestamp | 字符串 | ISO8601 格式的时间戳 此数据点表示的时间间隔的开始日期和时间格式（以 UTC 为单位）。 |
measurements.dataPoints.value | float | 此数据点的值。 |
measurements.name | 字符串 | 测量的名称。 测量类型页面中给出了接受的值。 |
measurements.units | 字符串 | 如何量化此测量值。 |
processId | 字符串 | MongoDB 进程的FQDN和端口。 |
开始 | 字符串 | ISO8601 格式的时间戳 以 UTC 为单位的日期和时间格式，表示要检索测量值的时间段的开始时间。 |
请求示例
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}'
响应示例
响应标头
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}
响应体
{ "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" }