AWS DocumentDB¶
AWS DocumentDB의 표시 지표에는 읽기 및 쓰기 처리량, 쿼리 지연, 확장성 등이 포함됩니다.
구성¶
Func 설치¶
Guance 통합 - 확장 - 호스팅 버전 Func를 여는 것을 권장합니다: 모든 사전 조건이 자동으로 설치됩니다. 스크립트 설치를 계속하세요
직접 Func를 배포하는 경우 Func 직접 배포를 참고하세요
설치 스크립트¶
안내: 요구 사항을 충족하는 AWS AK를 미리 준비하세요(간단하게 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다)
호스팅 버전 개설 스크립트¶
- Guance 콘솔에 로그인합니다
- [통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보를 설정한 경우 이 단계를 건너뜁니다
- [테스트]를 클릭합니다. 테스트가 성공하면 [저장]을 클릭합니다. 테스트가 실패하면 관련 설정이 올바른지 확인한 뒤 다시 테스트합니다
- [클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭하여 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지의 [통합] 버튼을 클릭한 뒤
미설치목록에서AWS DocumentDB를 찾아 [설치] 버튼을 클릭하면 설치 화면이 나타나며, 설치를 진행하면 됩니다
수동 개설 스크립트¶
-
Func 콘솔에 로그인한 뒤 [스크립트 마켓]을 클릭하여 Guance 스크립트 마켓으로 들어가
integration_aws_documentdb를 검색합니다 -
[설치]를 클릭한 뒤 해당 매개변수를 입력합니다: AWS AK ID, AK Secret 및 계정명
-
[배포 시작 스크립트]를 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다 -
활성화 후에는 「관리 / 자동 트리거 설정」에서 해당 자동 트리거 구성을 확인할 수 있습니다. [실행]을 클릭하면 주기 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다
검증¶
- 「관리 / 자동 트리거 설정」에서 해당 작업에 대응하는 자동 트리거 구성이 존재하는지 확인하고, 동시에 해당 작업 기록과 로그를 확인하여 이상이 있는지 점검합니다
- Guance의 「인프라 / 사용자 정의」에서 자산 정보가 존재하는지 확인합니다
- Guance의 「지표」에서 해당 모니터링 데이터가 있는지 확인합니다
지표¶
AWS-클라우드 모니터링을 구성하면 기본 지표 세트는 다음과 같습니다. 구성 방식으로 더 많은 지표를 수집할 수 있습니다 AWS 클라우드 모니터링 지표 상세
| 지표 | 설명 |
|---|---|
CPUUtilization |
인스턴스가 사용하는 CPU 비율입니다. |
FreeableMemory |
랜덤 액세스 메모리의 사용 가능한 양입니다(바이트 단위). |
FreeLocalStorage |
이 지표는 각 인스턴스에서 임시 테이블과 로그에 사용할 수 있는 스토리지 양을 보고합니다. 이 값은 인스턴스 클래스에 따라 다릅니다. 인스턴스에 더 큰 인스턴스 클래스를 선택하면 사용할 수 있는 스토리지 양을 늘릴 수 있습니다. |
SwapUsage |
인스턴스에서 사용 중인 스왑 공간의 크기입니다. |
DatabaseConnections |
1분 단위로 인스턴스에서 열린 연결 수입니다. |
DatabaseConnectionsMax |
1분 동안 인스턴스에서 열린 최대 데이터베이스 연결 수입니다. |
DatabaseCursors |
1분 단위로 인스턴스에서 열린 커서 수입니다. |
DatabaseCursorsMax |
1분 동안 인스턴스에서 열린 최대 커서 수입니다. |
DatabaseCursorsTimedOut |
1분 동안 시간 초과된 커서 수입니다. |
LowMemThrottleQueueDepth |
사용 가능한 메모리가 부족하여 제한된 요청의 큐 깊이이며, 빈도는 1분입니다. |
LowMemThrottleMaxQueueDepth |
1분 동안 사용 가능한 메모리 부족으로 인해 제한된 요청의 최대 큐 깊이입니다. |
LowMemNumOperationsThrottled |
1분 동안 사용 가능한 메모리 부족으로 인해 제한된 요청 수입니다. |
ReadThroughput |
초당 디스크에서 읽은 평균 바이트 수입니다. |
WriteThroughput |
초당 디스크에 기록된 평균 바이트 수입니다. |
ReadIOPS |
초당 평균 디스크 읽기 I/O 작업 수입니다. Amazon DocumentDB는 읽기와 쓰기 IOPS를 각각 1분마다 보고합니다. |
NetworkThroughput |
Amazon DocumentDB 클러스터의 각 인스턴스가 클라이언트로부터 수신하고 클라이언트로 전송하는 네트워크 처리량이며, 단위는 초당 바이트 수입니다. 이 처리량에는 클러스터의 인스턴스와 클러스터 볼륨 간 네트워크 트래픽은 포함되지 않습니다. |
NetworkReceiveThroughput |
클러스터의 각 인스턴스가 클라이언트로부터 수신하는 네트워크 처리량이며, 단위는 초당 바이트 수입니다. 이 처리량에는 클러스터의 인스턴스와 클러스터 볼륨 간 네트워크 트래픽은 포함되지 않습니다. |
NetworkTransmitThroughput |
클러스터의 각 인스턴스가 클라이언트로 전송하는 네트워크 처리량이며, 단위는 초당 바이트 수입니다. 이 처리량에는 클러스터의 인스턴스와 클러스터 볼륨 간 네트워크 트래픽은 포함되지 않습니다. |
WriteIOPS |
초당 평균 디스크 쓰기 I/O 작업 수입니다. 클러스터 수준에서 사용할 때 WriteIOPs는 클러스터의 모든 인스턴스에서 평가됩니다. 읽기와 쓰기 IOPS는 각각 1분마다 보고됩니다. |
ReadLatency |
각 디스크 I/O 작업에 필요한 평균 시간입니다. |
WriteLatency |
각 디스크 I/O 작업에 필요한 평균 시간입니다(밀리초 단위). |
DBInstanceReplicaLag |
주 인스턴스에서 복제본 인스턴스로 업데이트를 복제할 때의 총 지연량입니다(밀리초 단위). |
OpcountersQuery |
1분 동안 실행된 쿼리 수입니다. |
OpcountersCommand |
1분 동안 실행된 명령 수입니다. |
OpcountersDelete |
1분 동안 실행된 삭제 작업 수입니다. |
OpcountersGetmore |
1분 동안 발행된 get more 수입니다. |
OpcountersInsert |
1분 동안 실행된 삽입 작업 수입니다. |
OpcountersUpdate |
1분 동안 실행된 업데이트 작업 수입니다. |
DocumentsDeleted |
1분 동안 삭제된 문서 수입니다. |
DocumentsInserted |
1분 동안 삽입된 문서 수입니다. |
DocumentsReturned |
1분 동안 반환된 문서 수입니다. |
DocumentsUpdated |
1분 동안 업데이트된 문서 수입니다. |
TTLDeletedDocuments |
TTLMonitor가 1분 동안 삭제한 문서 수입니다. |
IndexBufferCacheHitRatio |
캐시가 제공한 인덱스 요청의 비율입니다. 인덱스, 컬렉션 또는 데이터베이스를 삭제한 후 이 지표가 100%보다 큰 값으로 순간적으로 표시될 수 있습니다. 이는 60초 후 자동으로 수정됩니다. 이 제한은 future 패치 업데이트에서 수정될 예정입니다. |
BufferCacheHitRatio |
버퍼 캐시가 제공한 요청의 비율입니다. |
DiskQueueDepth |
분산 스토리지 볼륨의 동시 쓰기 요청 수입니다. |
EngineUptime |
인스턴스가 실행된 시간 길이입니다(초 단위). |
객체¶
수집된 AWS DocumentDB 객체 데이터 구조이며, 「인프라-사용자 정의」에서 객체 데이터를 볼 수 있습니다
{
"measurement": "aws_documentdb",
"tags": {
"AvailabilityZone" : "cn-north-1a",
"CACertificateIdentifier" : "rds-ca-2019",
"DBClusterIdentifier" : "docdb-2023-06",
"DBInstanceArn" : "arn:aws-cn:rds:cn-north-1:",
"DBInstanceClass" : "db.t3.medium",
"DBInstanceIdentifier" : "docdb-2023-07",
"DBInstanceStatus" : "available",
"DbiResourceId" : "db-CKJQ",
"Engine" : "docdb",
"EngineVersion" : "3.6.0",
"KmsKeyId" : "arn:aws-cn:kms:cn-north-1:",
"cloud_provider" : "aws",
"name" : "docdb-2023-07"
},
"fields": {
"DBSubnetGroup": "{}",
"Endpoint": "{\"Address\": \".docdb.cn-north-1.amazonaws.com.cn\", \"HostedZoneId\": \"Z010911BG9\", \"Port\": 27017}",
"InstanceCreateTime": "2023-07-28T05:45:10.004000Z",
"PendingModifiedValues": "{}",
"PubliclyAccessible": "False",
"StatusInfos": "{}",
"VpcSecurityGroups": "[{\"Status\": \"active\", \"VpcSecurityGroupId\": \"sg-08895f59\"}]",
"message": "{인스턴스 json 정보}"
}
}
주의:
tags,fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다