/ /

/ /

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

Cloud Manager는 2024년 8월 30일부터 더 이상 MongoDB 3.6 및 4.0에 대한 자동화, 백업 및 모니터링을 지원하지 않습니다. MongoDB 배포를 업그레이드하거나 Atlas로 마이그레이션하세요.

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

기본 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	부울	응답 본문이 pretty-print 형식이어야 하는지 여부를 나타냅니다.	`false`
envelope	부울	응답을 엔벨로프에 래핑할지 여부를 나타냅니다.	`false`
지표	배열	연결된 데이터 시리즈에 대해 검색할 지표가 포함된 목록입니다. 이 매개변수를 지정하지 않으면 이 리소스는 모든 쿼리 지연 시간 지표에 대한 데이터 시리즈를 반환합니다.	모두
period	문자열	ISO 8601 표기법의 기간으로, 과거로 돌아가 측정값을 조회 있는 시간을 지정합니다. 이 값을 지정하면 `start` 및 `end`을 지정할 수 없습니다. 예를 예시, 지난 36 시간을 요청 하려면 쿼리 매개변수 `period=P1DT12H` 를 포함합니다.
시작하기	문자열	측정값을 조회 기간의 시작 부분에 대한 ISO 8601 날짜 및 UTC의 시간 형식의 타임스탬프입니다. `start` 를 지정하는 경우 `end` 도 지정해야 하며 `period`은 지정할 수 없습니다.
end	문자열	측정값을 조회 할 기간의 마지막에 대한 UTC의 ISO 8601 날짜 및 시간 형식의 타임스탬프입니다. `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	문자열	측정값을 조회 할 기간의 마지막에 대한 UTC의 ISO 8601 날짜 및 시간 형식의 타임스탬프입니다.
세분성	문자열	각 데이터 점 포함하는 간격의 크기를 지정하는 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"
}

돌아가기

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

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