1개의 MongoDB 프로세스에 대해 측정값 반환
지정된 프로젝트의 지정된 호스팅에 대한 프로세스당 디스크, 파티션 또는 호스팅 측정값을 반환합니다. 반환되는 값은 다음 중 한 개일 수 있습니다.
- MongoDB 프로세스에 사용되는 디스크 파티션의 I/O 작업 처리량
- 파티션 실행 및 서비스 요청 시간의 백분율
- MongoDB 프로세스에 사용되는 디스크 파티션의 작업 유형별 지연 시간
- MongoDB 프로세스에 사용되는 디스크 파티션의 사용 가능한 디스크 공간과 사용된 디스크 공간의 양
- 호스트에 대한 측정값(예: CPU 사용량 또는 I/O 작업 수)
이 리소스 사용하려면 요청하는 서비스 계정 또는 API 키에 프로젝트 읽기 전용 역할 있어야 합니다.
경로 매개변수
-
프로젝트 식별하는 고유한 24-16진수 문자열입니다. 인증된 사용자가 액세스 할 수 있는 모든 프로젝트를 조회 하려면 /groups 엔드포인트를 사용합니다.
참고: 그룹과 프로젝트는 동의어입니다. 그룹 ID는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 리소스 및 해당 엔드포인트는 그룹이라는 용어를 사용합니다.
형식은
^([a-f0-9]{24})$패턴 과 일치해야 합니다. -
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개 이하의 요소입니다. 값은ASSERT_MSG,ASSERT_REGULAR,ASSERT_USER,ASSERT_WARNING,BACKGROUND_FLUSH_AVG,CACHE_BYTES_READ_INTO,CACHE_BYTES_WRITTEN_FROM,CACHE_DIRTY_BYTES,CACHE_USED_BYTES,CACHE_FILL_RATIO,DIRTY_FILL_RATIO,COMPUTED_MEMORY,CONNECTIONS,CURSORS_TOTAL_OPEN,CURSORS_TOTAL_TIMED_OUT,DB_DATA_SIZE_TOTAL,DB_STORAGE_TOTAL,DOCUMENT_METRICS_DELETED,DOCUMENT_METRICS_INSERTED,DOCUMENT_METRICS_RETURNED,DOCUMENT_METRICS_UPDATED,EXTRA_INFO_PAGE_FAULTS,FTS_DISK_UTILIZATION,FTS_MEMORY_MAPPED,FTS_MEMORY_RESIDENT,FTS_MEMORY_VIRTUAL,FTS_PROCESS_CPU_KERNEL,FTS_PROCESS_CPU_USER,FTS_PROCESS_NORMALIZED_CPU_KERNEL,FTS_PROCESS_NORMALIZED_CPU_USER,GLOBAL_ACCESSES_NOT_IN_MEMORY,GLOBAL_LOCK_CURRENT_QUEUE_READERS,GLOBAL_LOCK_CURRENT_QUEUE_TOTAL,GLOBAL_LOCK_CURRENT_QUEUE_WRITERS,GLOBAL_PAGE_FAULT_EXCEPTIONS_THROWN,INDEX_COUNTERS_BTREE_ACCESSES,INDEX_COUNTERS_BTREE_HITS,INDEX_COUNTERS_BTREE_MISS_RATIO,INDEX_COUNTERS_BTREE_MISSES,JOURNALING_COMMITS_IN_WRITE_LOCK,JOURNALING_MB,JOURNALING_WRITE_DATA_FILES_MB,MAX_PROCESS_CPU_CHILDREN_KERNEL,MAX_PROCESS_CPU_CHILDREN_USER,MAX_PROCESS_CPU_KERNEL,MAX_PROCESS_CPU_USER,MAX_PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL,MAX_PROCESS_NORMALIZED_CPU_CHILDREN_USER,MAX_PROCESS_NORMALIZED_CPU_KERNEL,MAX_PROCESS_NORMALIZED_CPU_USER,MAX_SWAP_USAGE_FREE,MAX_SWAP_USAGE_USED,MAX_SYSTEM_CPU_GUEST,MAX_SYSTEM_CPU_IOWAIT,MAX_SYSTEM_CPU_IRQ,MAX_SYSTEM_CPU_KERNEL,MAX_SYSTEM_CPU_SOFTIRQ,MAX_SYSTEM_CPU_STEAL,MAX_SYSTEM_CPU_USER,MAX_SYSTEM_MEMORY_AVAILABLE,MAX_SYSTEM_MEMORY_FREE,MAX_SYSTEM_MEMORY_USED,MAX_SYSTEM_NETWORK_IN,MAX_SYSTEM_NETWORK_OUT,MAX_SYSTEM_NORMALIZED_CPU_GUEST,MAX_SYSTEM_NORMALIZED_CPU_IOWAIT,MAX_SYSTEM_NORMALIZED_CPU_IRQ,MAX_SYSTEM_NORMALIZED_CPU_KERNEL,MAX_SYSTEM_NORMALIZED_CPU_NICE,MAX_SYSTEM_NORMALIZED_CPU_SOFTIRQ,MAX_SYSTEM_NORMALIZED_CPU_STEAL,MAX_SYSTEM_NORMALIZED_CPU_USER,MEMORY_MAPPED,MEMORY_RESIDENT,MEMORY_VIRTUAL,NETWORK_BYTES_IN,NETWORK_BYTES_OUT,NETWORK_NUM_REQUESTS,OP_EXECUTION_TIME_COMMANDS,OP_EXECUTION_TIME_READS,OP_EXECUTION_TIME_WRITES,OPCOUNTER_CMD,OPCOUNTER_DELETE,OPCOUNTER_TTL_DELETED,OPCOUNTER_GETMORE,OPCOUNTER_INSERT,OPCOUNTER_QUERY,OPCOUNTER_REPL_CMD,OPCOUNTER_REPL_DELETE,OPCOUNTER_REPL_INSERT,OPCOUNTER_REPL_UPDATE,OPCOUNTER_UPDATE,OPERATIONS_SCAN_AND_ORDER,OPERATIONS_QUERIES_KILLED,OPLOG_MASTER_LAG_TIME_DIFF,OPLOG_MASTER_TIME,OPLOG_RATE_GB_PER_HOUR,OPLOG_SLAVE_LAG_MASTER_TIME,OPLOG_REPLICATION_LAG,PROCESS_CPU_CHILDREN_KERNEL,PROCESS_CPU_CHILDREN_USER,PROCESS_CPU_KERNEL,PROCESS_CPU_USER,PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL,PROCESS_NORMALIZED_CPU_CHILDREN_USER,PROCESS_NORMALIZED_CPU_KERNEL,PROCESS_NORMALIZED_CPU_USER,QUERY_EXECUTOR_SCANNED,QUERY_EXECUTOR_SCANNED_OBJECTS,QUERY_TARGETING_SCANNED_OBJECTS_PER_RETURNED,QUERY_TARGETING_SCANNED_PER_RETURNED,RESTARTS_IN_LAST_HOUR,SWAP_USAGE_FREE,SWAP_USAGE_USED,SYSTEM_CPU_GUEST,SYSTEM_CPU_IOWAIT,SYSTEM_CPU_IRQ,SYSTEM_CPU_KERNEL,SYSTEM_CPU_NICE,SYSTEM_CPU_SOFTIRQ,SYSTEM_CPU_STEAL,SYSTEM_CPU_USER,SYSTEM_MEMORY_AVAILABLE,SYSTEM_MEMORY_FREE,SYSTEM_MEMORY_USED,SYSTEM_NETWORK_IN,SYSTEM_NETWORK_OUT,SYSTEM_NORMALIZED_CPU_GUEST,SYSTEM_NORMALIZED_CPU_IOWAIT,SYSTEM_NORMALIZED_CPU_IRQ,SYSTEM_NORMALIZED_CPU_KERNEL,SYSTEM_NORMALIZED_CPU_NICE,SYSTEM_NORMALIZED_CPU_SOFTIRQ,SYSTEM_NORMALIZED_CPU_STEAL,SYSTEM_NORMALIZED_CPU_USER,TICKETS_AVAILABLE_READS,TICKETS_AVAILABLE_WRITE,OPERATION_THROTTLING_REJECTED_OPERATIONS, 또는QUERY_SPILL_TO_DISK_DURING_SORT. -
Atlas가 메트릭을 보고하는 기간입니다. 이 매개변수는 UTC 단위의 ISO 8601 기간 형식으로 값을 표현합니다. 시작과 끝을 설정하지 않을 경우 이 매개변수를 포함하세요.
-
Atlas가 측정항목을 보고하는 간격을 지정하는 기간입니다. 이 매개변수는 UTC 단위의 ISO 8601 기간 형식으로 값을 표현합니다.
-
MongoDB Cloud가 측정항목 보고를 시작한 날짜 및 시간입니다. 이 매개변수는 UTC 단위의 ISO 8601 타임스탬프 형식으로 값을 표현합니다. 기간을 설정하지 않을 경우 이 매개변수를 포함하세요.
-
MongoDB 클라우드가 메트릭 보고를 중단하는 날짜 및 시간입니다. 이 매개변수는 UTC 단위의 ISO 8601 타임스탬프 형식으로 값을 표현합니다. 기간을 설정하지 않을 경우 이 매개변수를 포함하세요.
atlas api monitoringAndLogs getGroupProcessMeasurements --helpimport (
"os"
"context"
"log"
sdk "go.mongodb.org/atlas-sdk/v20240530001/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.GetGroupProcessMeasurementsApiParams{}
sdkResp, httpResp, err := client.MonitoringandLogsApi.
GetGroupProcessMeasurementsWithParams(ctx, params).
Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
--header "Accept: application/vnd.atlas.2024-05-30+json" \
-X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/processes/{processId}/measurements?pretty=true"curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
--digest --include \
--header "Accept: application/vnd.atlas.2024-05-30+json" \
-X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/processes/{processId}/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"
}