1개의 MongoDB 프로세스에서 1개의 데이터베이스에 대한 측정값 반환
지정된 프로젝트의 지정된 호스트에 대한 데이터베이스 한 개의 측정값을 반환합니다. MongoDB dbStats 명령 출력을 기반으로 데이터베이스의 디스크 저장 공간을 반환합니다. 일부 지표 시리즈를 계산하기 위해 Atlas는 인접한 두 점 사이의 비율을 계산합니다. 이러한 지표 시리즈의 경우, 쿼리 시간 범위에서 첫 번째 데이터 점에 대한 비율을 계산할 수 없기 때문에 첫 번째 데이터 점은 null 값을 갖습니다. Atlas는 20분마다 데이터베이스 지표를 조회하지만, 데이터베이스 성능을 최적화하기 위해 필요할 때 빈도를 줄입니다. 이 리소스를 사용하려면, 요청하는 서비스 계정 또는 API 키에 프로젝트 읽기 전용 역할이 있어야 합니다.
경로 매개변수
-
프로젝트 식별하는 고유한 24-16진수 문자열입니다. 인증된 사용자가 액세스 할 수 있는 모든 프로젝트를 조회 하려면 /groups 엔드포인트를 사용합니다.
참고: 그룹과 프로젝트는 동의어입니다. 그룹 ID는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 리소스 및 해당 엔드포인트는 그룹이라는 용어를 사용합니다.
형식은
^([a-f0-9]{24})$패턴 과 일치해야 합니다. -
지정된 MongoDB 프로세스가 제공하는 데이터베이스를 식별하는 사람이 읽을 수 있는 레이블입니다.
-
MongoDB 프로세스를 제공하는 호스트 이름과 인터넷 할당 번호 관리 기관(Assigned Numbers Authority, IANA) 포트의 조합입니다. 호스트는 MongoDB 프로세스(
mongod또는mongos)를 실행하는 호스트의 호스트 이름, 전체 주소 도메인 이름(Fully Qualified Domain Name, FQDN) 또는 인터넷 프로토콜 주소(IPv4 또는 IPv6)여야 합니다. 포트는 MongoDB 프로세스가 요청을 수신하는 IANA 포트여야 합니다.형식은
^([0-9]{1,3}\.){3}[0-9]{1,3}|([0-9a-f]{1,4}\:){7}([0-9a-f]{1,4})|(([a-z0-9]+\.){1,10}[a-z]+)?(\:[0-9]{4,5})$패턴 과 일치해야 합니다.
쿼리 매개변수
-
애플리케이션이 응답을
envelopeJSON 객체로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 결과 목록을 반환하는 엔드포인트는 결과 객체를 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.기본값은
false입니다. -
응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.
기본값은
false입니다.Prettyprint -
이 MongoDB 프로세스에 대해 요청할 하나 이상의 측정 유형입니다. 생략하면 리소스는 모든 측정값을 반환합니다.
m에 여러 값을 지정하려면 각 값에 대해m매개변수를 반복합니다. 지정된 호스팅에 적용되는 측정값을 지정합니다. 유효하지 않은 측정값을 지정한 경우 MongoDB Cloud에서 오류를 반환합니다.최소
1개,10개 이하의 요소입니다. 값은DATABASE_AVERAGE_OBJECT_SIZE,DATABASE_COLLECTION_COUNT,DATABASE_DATA_SIZE,DATABASE_STORAGE_SIZE,DATABASE_INDEX_SIZE,DATABASE_INDEX_COUNT,DATABASE_EXTENT_COUNT,DATABASE_OBJECT_COUNT또는DATABASE_VIEW_COUNT입니다. -
Atlas가 측정항목을 보고하는 간격을 지정하는 기간입니다. 이 매개변수는 UTC 단위의 ISO 8601 기간 형식으로 값을 표현합니다.
-
Atlas가 메트릭을 보고하는 기간입니다. 이 매개변수는 UTC 단위의 ISO 8601 기간 형식으로 값을 표현합니다. 시작과 끝을 설정하지 않을 경우 이 매개변수를 포함하세요.
-
MongoDB Cloud가 측정항목 보고를 시작한 날짜 및 시간입니다. 이 매개변수는 UTC 단위의 ISO 8601 타임스탬프 형식으로 값을 표현합니다. 기간을 설정하지 않을 경우 이 매개변수를 포함하세요.
-
MongoDB 클라우드가 메트릭 보고를 중단하는 날짜 및 시간입니다. 이 매개변수는 UTC 단위의 ISO 8601 타임스탬프 형식으로 값을 표현합니다. 기간을 설정하지 않을 경우 이 매개변수를 포함하세요.
atlas api monitoringAndLogs getGroupProcessDatabaseMeasurements --helpimport (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20231001001/admin"
)
func main() {
ctx := context.Background()
clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")
// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))
if err != nil {
log.Fatalf("Error: %v", err)
}
params = &sdk.GetGroupProcessDatabaseMeasurementsApiParams{}
sdkResp, httpResp, err := client.MonitoringandLogsApi.
GetGroupProcessDatabaseMeasurementsWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2023-10-01+json" \
-X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements?pretty=true"curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2023-10-01+json" \
-X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements?pretty=true"{
"databaseName": "string",
"end": "2025-05-04T09:42:00Z",
"granularity": "PT1M",
"groupId": "32b6e34b3d91647abb20e7b8",
"hostId": "mongodb.example.com:27017",
"links": [
{
"href": "https://cloud.mongodb.com/api/atlas",
"rel": "self"
}
],
"measurements": [
{
"dataPoints": [
{
"timestamp": "2025-05-04T09:42:00Z",
"value": 42.0
}
],
"name": "string",
"units": "BYTES"
}
],
"partitionName": "string",
"processId": "mongodb.example.com:27017",
"start": "2025-05-04T09:42:00Z"
}{
"error": 401,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Unauthorized",
"errorCode": "NOT_ORG_GROUP_CREATOR"
}{
"error": 403,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Forbidden",
"errorCode": "CANNOT_CHANGE_GROUP_NAME"
}{
"error": 404,
"detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
"reason": "Not Found",
"errorCode": "RESOURCE_NOT_FOUND"
}{
"error": 500,
"detail": "(This is just an example, the exception may not be related to this endpoint)",
"reason": "Internal Server Error",
"errorCode": "UNEXPECTED_ERROR"
}