Docs Menu
Docs Home
/
MongoDB Cloud Manager
/
API
/
리소스
/
측정 및 경고
/
쿼리 지연 시간

호스트 수준 쿼리 지연 시간 반환

이 페이지의 내용

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

지정된 네임스페이스 에 대한 호스트 수준 쿼리 지연 시간 측정값 목록을 반환합니다.

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

Resource

GET /groups/{PROJECT-ID}/hosts/{hostId}/{databaseName}/{collectionName}/collStats/measurements

요청 경로 매개변수

Parameter
유형
설명
프로젝트 ID
문자열
(필수 사항) 네임스페이스가 포함된 프로젝트를 식별하는 고유한 24-16진수 string 입니다.
hostId
문자열
(필수 사항) 측정값이 속한 호스트의 고유 식별자입니다.
databaseName
문자열
(필수 사항) 데이터베이스를 식별하는 이름입니다.
collectionName
문자열
(필수 사항) 컬렉션을 식별하는 이름입니다.

요청 쿼리 매개변수

모든 매개변수는 선택 사항입니다.

이름
유형
설명
기본값
pretty
부울
응답 본문이 프리티프린트 에 있어야 하는지 여부를 나타냅니다. 형식.
false
envelope
부울
응답을 엔벨로프에 래핑할지 여부를 나타냅니다.
false
지표
배열
연결된 데이터 시리즈에 대해 검색할 지표가 포함된 목록입니다. 이 매개변수를 지정하지 않으면 이 리소스는 모든 쿼리 지연 시간 지표에 대한 데이터 시리즈를 반환합니다.
모두
period
문자열

ISO 기간 8601 측정값을 검색하기 위해 과거로 얼마나 되돌아가는지를 지정하는 표기법입니다. 이 값을 지정하면 start 및 end 을 지정할 수 없습니다.

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

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

요청 본문 매개변수

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

지표

메트릭
설명
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
컬렉션에서 수행된 명령 연산의 수(명령 연산/컬렉션 간격)를 나타내는 비율입니다.

응답

이름
유형
설명
collectionName
문자열
컬렉션 을 식별하는 이름입니다.
databaseName
문자열
데이터베이스를 식별하는 이름입니다.
end
문자열
ISO 8601 의 타임스탬프 측정값을 검색할 기간의 마지막 날짜에 대한 UTC 의 날짜 및 시간 형식입니다.
세분성
문자열

ISO 기간 8601 각 데이터 포인트가 포함하는 간격의 크기를 지정하는 표기법입니다.

예를 예시PT5M 은 5분 세분성을 지정합니다.

groupId
문자열
네임스페이스가 포함된 프로젝트를 식별하는 고유한 24-16진수 string 입니다.
링크
객체 배열

하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 links 배열에는 self 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.

측정값
객체 배열
이 배열의 각 객체는 측정값과 해당 측정값에 대한 데이터 점을 나타냅니다.
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}/hosts/{hostId}/{databaseName}/{collectionName}/collStats/measurements?pretty=true&period={period}'

응답 예시

응답 헤더

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}

응답 본문

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

돌아가기

순위 네임스페이스 반환(클러스터)

다음

순위 네임스페이스 반환(호스트)