AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.

Atlas API 샤딩 인사이트 getShardMetricMeasurements

지정된 샤드 클러스터의 한 샤드에 대한 요청된 측정값의 시계열을 반환합니다.

Atlas API 하위 명령은 MongoDB Atlas 관리자 API 에서 자동으로 생성되며 관리자 API 에 대한 전체 커버리지를 제공합니다. 관리자 API 역량에는 자체 출시 수명 주기가 있으며, 이는 제공된 API 엔드포인트 문서 링크를 통해 확인할 수 있습니다.

The series average the readings of the shard's member processes selected by nodeType. Responds with a 404 only when no shard with the given replicaSetName exists in the cluster; a shard that exists but has no readings yet returns series of null data points. Each series carries one data point per granularity interval, starting at start and not passing end. A data point's value is null when MongoDB Cloud has no reading for that interval; this includes the first minutes after a cluster or shard is created, before its metrics are collected, so null must not be read as zero load. Set period, or set both start and end; when neither is set, the response covers the last hour. A request whose window and granularity would produce more than 1000 data points per series is rejected.

이 명령은 자동으로 생성되며 Atlas API 엔드포인트 https://www.mongodb.com/ko-kr/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustershardmetricmeasurements.와 1:1 에 해당합니다.

자세한 내용과 예시는 위에 링크된 참조 API 문서를 참조하세요.

명령 구문

atlas api shardingInsights getShardMetricMeasurements [options]
이름
유형
필수 사항
설명

--clusterName

문자열

true

클러스터를 식별하는 사람이 읽을 수 있는 라벨입니다.

--end

문자열

거짓

MongoDB 클라우드가 메트릭 보고를 중단하는 날짜 및 시간입니다. 이 매개변수는 UTC 단위의 ISO 8601 타임스탬프 형식으로 값을 표현합니다. 기간을 설정하지 않을 경우 이 매개변수를 포함하세요.

--envelope

envelope

거짓

애플리케이션이 응답을 엔벨로프 JSON 객체 로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스 할 수 없습니다. 이 문제를 해결하려면 쿼리 에서 envelope=true 를 설정하다 . 결과 목록을 반환하는 엔드포인트는 결과 객체 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.

--granularity

문자열

거짓

Interval between consecutive data points, in ISO 8601 duration format. If omitted, MongoDB Cloud chooses the resolution from the width of the window.

--groupId

문자열

true

프로젝트 식별하는 고유한 24-16진수 문자열입니다. [/groups](# 태그를 지정하다 /Projects/operation/listProjects) 엔드포인트를 사용하여 인증된 사용자가 액세스 할 수 있는 모든 프로젝트를 조회 .

참고: 그룹과 프로젝트는 동의어입니다. 그룹 ID는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 리소스 및 해당 엔드포인트는 그룹이라는 용어를 사용합니다.

-h, --help

거짓

샤드메트릭 측정값 가져오기에 대한 도움말

--m

m

거짓

One or more measurements to return. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the m parameter for each value.

--노드타입

문자열

거짓

샤드의 시리즈에 평균값이 계산되는 구성원들.

-o, --output

문자열

거짓

기본 설정 API 형식은 ["JSON", go- Template] 일 수 있습니다. 이 값의 기본값은 "JSON" 입니다.

--outputFile

문자열

거짓

API 출력을 쓰기 (write) 파일 입니다. 이 플래그는 엔드포인트의 출력이 바이너리(예: gzip)이고 명령이 파이프되지 않은 경우(예: Atlas 명령 > out.zip)에 필요합니다.

--period

문자열

거짓

Atlas가 메트릭을 보고하는 기간입니다. 이 매개변수는 UTC 단위의 ISO 8601 기간 형식으로 값을 표현합니다. 시작과 끝을 설정하지 않을 경우 이 매개변수를 포함하세요.

--pretty

거짓

응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.

--replicaSetName

문자열

true

샤드를 식별하는 사람이 읽을 수 있는 레이블로, 해당 샤드 구성원의 복제 세트 이름입니다.

--start

문자열

거짓

MongoDB Cloud가 측정항목 보고를 시작한 날짜 및 시간입니다. 이 매개변수는 UTC 단위의 ISO 8601 타임스탬프 형식으로 값을 표현합니다. 기간을 설정하지 않을 경우 이 매개변수를 포함하세요.

--version

문자열

거짓

Atlas API 엔드포인트 [options: "2025-03-12"]를 호출할 때 사용할 API 버전입니다. 사용자가 설정하다 하지 않은 경우 기본값은 최신 버전이거나 설정하다 경우 프로필의 api_version 구성 값입니다. 이 값의 기본값은 '2025-03-12'입니다.

이름
유형
필수 사항
설명

-P, --profile

문자열

거짓

구성 파일 에서 사용할 프로필의 이름입니다. Atlas CLI 의 프로필에 대해 학습 https://dochub.mongodb.org/core/atlas-cli-save-connection-settings를 참조하세요.

atlas api shardingInsights getShardMetricMeasurements --version 2025-03-12 --clusterName [clusterName] --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --replicaSetName atlas-12vorz-shard-0
이 페이지 평가하기

이 페이지의 내용