데이터베이스 측정값 가져오기

이 페이지의 내용

Resource

요청 경로 매개변수
요청 쿼리 매개변수
요청 본문 매개변수
응답
요청 예시
응답 예시
응답 헤더
응답 본문

MongoDB Ops Manager v6.0 는 2025 1월에 EOL됩니다. 가능한 한 빨리 상위 MongoDB Ops Manager 버전으로 업그레이드하세요.

데이터베이스 측정은 데이터베이스 성능 및 저장에 대한 통계를 제공합니다. 모니터링은 dbStats 명령을 통해 데이터베이스 측정값을 수집합니다.

참고

일부 메트릭 계열을 계산하기 위해 Ops Manager는 인접한 두 점 사이의 비율을 취합니다. 이러한 메트릭 계열의 경우 Ops Manager가 쿼리 시간 범위에서 첫 번째 데이터 요소에 대한 비율을 계산할 수 없기 때문에 첫 번째 데이터 요소는 null 값을 갖습니다.

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/hosts/{HOST-ID}/databases/{DATABASE-NAME}/measurements

요청 경로 매개변수

이름	유형	설명
프로젝트 ID	문자열	호스트를 소유한 프로젝트 의 고유 식별자입니다.
HOST-ID	문자열	MongoDB 프로세스를 제공하는 호스트의 고유 식별자입니다.
데이터베이스-NAME	문자열	MongoDB 프로세스가 저장되는 데이터베이스의 고유 식별자입니다.

요청 쿼리 매개변수

고유 쿼리 매개변수

이 엔드포인트는 반환된 측정값을 필터링하기 위해 다음 쿼리 매개변수를 허용합니다.

이름

유형

설명

granularity

Required

문자열

ISO 기간 8601 측정 데이터 포인트 사이의 간격을 지정하는 표기법입니다.

측정 단위는 다음 표기법을 사용하여 일, 시간, 분, 초 및 밀리초로 표현할 수 있습니다.

P ( 마침표) 뒤에 다음을 입력합니다.

D 며칠 동안 (원하는 경우)
T for time (after 일)
H 몇 시간 동안
M for 분
S 초 동안

예를 들면 다음과 같습니다.

표기법	기간
`PT30S`	30초
`P1T12H`	1일 12시간
`PT0.5S`	500밀리초

period

문자열

ISO 기간 8601 측정값을 검색하기 위해 과거로 얼마나 되돌아가는지를 지정하는 표기법입니다.

예를 예시, 지난 36 시간을 요청 하려면 쿼리 매개변수 period=P1DT12H 를 포함합니다.

시작하기

문자열

ISO 의 타임스탬프 측정값을 검색할 기간의 시작에 대한UTC의 날짜 및 시간 8601 형식입니다. start 를 지정하는 경우 end 도 지정해야 합니다.

end

문자열

ISO 8601 의 타임스탬프 측정값을 검색할 기간의 마지막 날짜에 대한 UTC 의 날짜 및 시간 형식입니다. end 를 지정하는 경우 start 도 지정해야 합니다.

문자열

반환할 측정값입니다. m 을(를) 지정하지 않으면 모든 측정값이 반환됩니다.

m 에 여러 값을 지정하려면 m 매개변수를 반복해야 합니다.

예를 들면 다음과 같습니다.

../measurements?m=CONNECTIONS&m=OPCOUNTER_CMD&m=OPCOUNTER_QUERY

호스팅하다 에 유효한 측정값을 지정해야 합니다. 지정된 측정값이 유효하지 않은 경우 MongoDB Ops Manager 에서 오류를 반환합니다. 사용 가능한 측정값은 측정 유형을 참조하세요.

참고

각 측정 요청에는 period 쿼리 매개변수 또는 start 및 end 쿼리 매개변수가 모두 포함되어야 합니다.

일반 쿼리 매개변수

이 엔드포인트는 또한 단일 응답을 반환하는 모든 엔드포인트에 공통된 쿼리 매개변수를 허용합니다.

이름

유형

설명

기본값

pageNum

integer

페이지 번호(1-인덱스 기준)입니다.

1

itemsPerPage

integer

페이지당 반환할 항목 수. 최대 500개까지 가능합니다.

100

pretty

부울

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

false

envelope

부울

응답을 엔벨로프에 래핑할지 여부를 나타냅니다.

일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 "envelope" : true 을(를) 설정합니다.

하나의 결과를 반환하는 엔드포인트의 경우 응답 본문에는 다음이 포함됩니다.

상태	HTTP 응답 코드
envelope	예상되는 응답 본문

결과 목록을 반환하는 엔드포인트의 경우 results 객체는 엔벨로프입니다. Ops Manager가 응답 본문에 status 필드를 추가합니다.

none

요청 본문 매개변수

이 엔드포인트는 HTTP 요청 본문 매개변수를 사용하지 않습니다.

응답

이름	유형	설명
databaseName	문자열	측정값이 적용되는 데이터베이스입니다. 데이터베이스 측정 값 가져오기에 대해서만 채워집니다.
end	문자열	ISO 8601 의 타임스탬프 반환된 측정값이 포함하는 기간의 마지막 날짜에 대해 UTC 의 날짜 및 시간 형식입니다.
세분성	문자열	ISO 기간 8601 각 데이터 포인트가 포함하는 간격의 크기를 지정하는 표기법입니다. 예를 예시`PT5M` 은 5분 세분성을 지정합니다.
groupId	문자열	호스트를 소유한 프로젝트의 고유 식별자입니다.
hostId	문자열	측정값이 속한 호스트의 고유 식별자입니다.
측정값	객체 배열	이 배열의 각 객체는 측정값과 해당 측정값에 대한 데이터 점을 나타냅니다.
measures.dataPoints	객체 배열	각 객체는 단일 데이터 점을 나타냅니다. 특정 시점에 사용할 수 있는 데이터 점이 없는 경우 이 `value` 는 `null` 로 설정됩니다.
measures.dataPoints.timestamp	문자열	ISO 8601 의 타임스탬프 이 데이터 포인트가 나타내는 시간 간격의 시작 부분에 대한 UTC 의 날짜 및 시간 형식입니다.
measures.dataPoints.value	float	이 데이터 점의 값입니다.
measures.name	문자열	측정값의 이름입니다. 허용되는 값은 측정 유형 페이지에 나와 있습니다.
measures.units	문자열	이 측정값을 수량화하는 방법입니다. 허용되는 단위는 다음과 같습니다. `PERCENT` `MILLISECONDS` `BYTES` `GIGABYTES` `BYTES_PER_SECOND` `MEGABYTES_PER_SECOND` `GIGABYTES_PER_HOUR` `SCALAR_PER_SECOND` `SCALAR`
partitionName	문자열	MongoDB 프로세스 데이터베이스를 저장하는 디스크 파티션의 이름입니다. 디스크 파티션 측정 값 가져오기에 대해서만 채워집니다.
processId	문자열	MongoDB 프로세스의 FQDN 및 포트입니다.
시작하기	문자열	ISO 8601 의 타임스탬프 반환된 측정값이 포함하는 기간의 시작 부분에 대해 UTC 의 날짜 및 시간 형식입니다.

요청 예시

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
 --header "Accept: application/json" \
 --include \
 --request GET "https://<ops-manager-host>/api/public/v1.0/groups/{PROJECT-ID}/hosts/fd5b59188dc13ad142493/databases/markets/measurements?granularity={TIME-INCREMENT}&period={PERIOD}"

응답 예시

응답 헤더

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

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}

응답 본문

{
  "databaseName": "markets",
  "end": "2016-08-11T21:08:40Z",
  "granularity": "{TIME-INCREMENT}",
  "groupId": "{PROJECT-ID}",
  "hostId": "fd5b59188dc13ad142493",
  "links": [],
  "measurements": [{
      "dataPoints": [],
      "name": "DATABASE_WRITE_LOCK_PERCENTAGE",
      "units": "PERCENT"
    },
    {
      "dataPoints": [{
        "timestamp": "2016-08-11T21:08:40Z",
        "value": 51.780589415213704
      }],
      "name": "DATABASE_AVERAGE_OBJECT_SIZE",
      "units": "BYTES"
    },
    {
      "dataPoints": [{
        "timestamp": "2016-08-11T21:08:40Z",
        "value": 32405.0
      }],
      "name": "DATABASE_OBJECT_COUNT",
      "units": "SCALAR"
    }
  ],
  "processId": "{MONGODB-PROCESS-FQDN}:{PORT}",
  "start": "2016-08-11T21:08:40Z"
}

돌아가기

디스크 파티션 측정값 가져오기

측정 유형 가져오기