클러스터 수준 쿼리 지연 시간 반환
Cloud Manager는 2024년 8월 30일부터 더 이상 MongoDB 3.6 및 4.0에 대한 자동화, 백업 및 모니터링을 지원하지 않습니다. MongoDB 배포를 업그레이드하거나 Atlas로 마이그레이션하세요.
- Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.
- 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.
지정된 네임스페이스에 대한 클러스터 수준 쿼리 지연 시간 측정값 목록을 반환합니다.
기본 URL: https://cloud.mongodb.com/api/public/v1.0
Resource
GET /groups/{PROJECT-ID}/clusters/{hostClusterId}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements
요청 경로 매개변수
Parameter | 유형 | 설명 |
|---|---|---|
프로젝트 ID | 문자열 | (필수 사항) 네임스페이스가 포함된 프로젝트를 식별하는 고유한 24-16진수 string 입니다. |
hostClusterId | 문자열 | (필수 사항) 네임스페이스를 포함하는 클러스터의 고유 식별자입니다. |
clusterView | 문자열 | (필수 사항) 클러스터 토폴로지를 식별하는 이름입니다. 값에는 다음이 포함됩니다.
|
databaseName | 문자열 | (필수 사항) 데이터베이스를 식별하는 이름입니다. |
collectionName | 문자열 | (필수 사항) 컬렉션을 식별하는 이름입니다. |
요청 쿼리 매개변수
모든 매개변수는 선택 사항입니다.
이름 | 유형 | 설명 | 기본값 |
|---|---|---|---|
pretty | 부울 | false | |
envelope | 부울 | 응답을 엔벨로프에 래핑할지 여부를 나타냅니다. | false |
지표 | 배열 | 연결된 데이터 시리즈에 대해 검색할 지표가 포함된 목록입니다. 이 매개변수를 지정하지 않으면 이 리소스는 모든 쿼리 지연 시간 지표에 대한 데이터 시리즈를 반환합니다. | 모두 |
period | 문자열 | ISO 기간 8601 측정값을 검색하기 위해 과거로 얼마나 되돌아가는지를 지정하는 표기법입니다. 이 값을 지정하면 예를 예시, 지난 36 시간을 요청 하려면 쿼리 매개변수 | |
시작하기 | 문자열 | ISO 의 타임스탬프 측정값을 검색할 기간의 시작에 대한UTC의 날짜 및 시간 8601 형식입니다. start 를 지정하는 경우 end 도 지정해야 하며 period 은 지정할 수 없습니다. | |
end | 문자열 | ISO 8601 의 타임스탬프 측정값을 검색할 기간의 마지막 날짜에 대한 UTC 의 날짜 및 시간 형식입니다. end 를 지정하는 경우 start 도 지정해야 하며 period 는 지정할 수 없습니다. |
지표
메트릭 | 설명 |
|---|---|
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 | 문자열 | 컬렉션 을 식별하는 이름입니다. |
databaseName | 문자열 | 데이터베이스를 식별하는 이름입니다. |
end | 문자열 | ISO 8601 의 타임스탬프 측정값을 검색할 기간의 마지막 날짜에 대한 UTC 의 날짜 및 시간 형식입니다. |
세분성 | 문자열 | ISO 기간 8601 각 데이터 포인트가 포함하는 간격의 크기를 지정하는 표기법입니다. 예를 예시 |
groupId | 문자열 | 네임스페이스가 포함된 프로젝트를 식별하는 고유한 24-16진수 string 입니다. |
링크 | 객체 배열 | 하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 |
측정값 | 객체 배열 | 이 배열의 각 객체는 측정값과 해당 측정값에 대한 데이터 점을 나타냅니다. |
measures.dataPoints | 객체 배열 | 각 객체는 단일 데이터 점을 나타냅니다. 특정 시점에 사용할 수 있는 데이터 점이 없는 경우 이 value 는 null 로 설정됩니다. |
measures.dataPoints.timestamp | 문자열 | ISO 8601 의 타임스탬프 이 데이터 포인트가 나타내는 시간 간격의 시작 부분에 대한 UTC 의 날짜 및 시간 형식입니다. |
measures.dataPoints.value | float | 이 데이터 점의 값입니다. |
measures.name | 문자열 | 측정값의 이름입니다. 허용되는 값은 측정 유형 페이지에 나와 있습니다. |
measures.units | 문자열 | 이 측정값을 수량화하는 방법입니다. |
processId | 문자열 | MongoDB 프로세스의 FQDN 및 포트입니다. |
시작하기 | 문자열 | ISO 8601 의 타임스탬프 측정값을 검색할 기간의 시작에 대한 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" }