텐센트 클라우드 MongoDB¶
스크립트 마켓의「Guance 클라우드 동기화」시리즈 스크립트 패키지를 사용해 클라우드 모니터링 및 클라우드 자산 데이터를Guance로 동기화
설정¶
Func 설치¶
Guance 통합 - 확장 - 호스팅 버전 Func 개통을 권장합니다: 모든 사전 조건이 자동으로 설치되니 스크립트 설치를 계속 진행하세요
직접 Func를 배포하는 경우 직접 Func 배포를 참고하세요
스크립트 활성화¶
참고: 요구 사항을 충족하는 Tencent Cloud AK를 미리 준비하세요(간단히 하려면 전체 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다)
호스팅 버전에서 스크립트 활성화¶
- Guance 콘솔에 로그인합니다
- 【통합】 메뉴를 클릭하고 【클라우드 계정 관리】를 선택합니다
- 【클라우드 계정 추가】를 클릭하고 【Tencent Cloud】를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보를 이미 설정했다면 이 단계를 건너뜁니다
- 【테스트】를 클릭하고, 테스트에 성공하면 【저장】을 클릭합니다. 테스트에 실패하면 관련 구성 정보가 올바른지 확인한 뒤 다시 테스트합니다
- 【클라우드 계정 관리】 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지의 【통합】 버튼을 클릭한 뒤
미설치목록에서텐센트 클라우드 MongoDB를 찾아 【설치】 버튼을 클릭하면 설치 화면이 열리고, 설치를 진행하면 됩니다
수동으로 스크립트 활성화¶
-
Func 콘솔에 로그인하고 【스크립트 마켓】을 클릭해 Guance 스크립트 마켓으로 들어간 뒤
integration_tencentcloud_mongodb를 검색합니다 -
【설치】를 클릭한 뒤, Tencent Cloud AK, SK 및 계정 이름에 해당하는 매개변수를 입력합니다
-
【배포 후 스크립트 시작】을 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다 -
활성화한 후에는 「관리 / 자동 트리거 구성」에서 해당 자동 트리거 구성을 확인할 수 있습니다. 【실행】을 클릭하면 주기 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다
확인¶
- 「관리 / 자동 트리거 구성」에서 해당 작업의 자동 트리거 구성이 존재하는지 확인하고, 동시에 해당 작업 기록과 로그를 확인해 이상 여부를 점검합니다
- Guance의 「기본 인프라 / 사용자 정의」에서 자산 정보가 있는지 확인합니다
- Guance의 「지표」에서 해당 모니터링 데이터가 있는지 확인합니다
지표¶
Tencent Cloud-Cloud Monitor를 구성하면 기본 지표 세트는 다음과 같습니다. 구성 방식으로 더 많은 지표를 수집할 수 있습니다. Tencent Cloud Cloud Monitor 지표 상세
요청 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
Inserts_sum |
쓰기 요청 횟수 | 단위 시간 내 쓰기 횟수 | 회 | target(인스턴스 ID) |
Reads_sum |
읽기 요청 횟수 | 단위 시간 내 읽기 횟수 | 회 | target(인스턴스 ID) |
Updates_sum |
업데이트 요청 횟수 | 단위 시간 내 업데이트 횟수 | 회 | target(인스턴스 ID) |
Deletes_sum |
삭제 요청 횟수 | 단위 시간 내 삭제 횟수 | 회 | target(인스턴스 ID) |
Counts_sum |
count 요청 횟수 | 단위 시간 내 count 횟수 | 회 | target(인스턴스 ID) |
Success_sum |
성공 요청 횟수 | 단위 시간 내 성공 요청 횟수 | 회 | target(인스턴스 ID) |
Commands_sum |
command 요청 횟수 | 단위 시간 내 command 요청 횟수 | 회 | target(인스턴스 ID) |
Qps_sum |
초당 요청 횟수 | 초당 작업 수, CRUD 작업 포함 | 회/초 | target(인스턴스 ID) |
CountPerSecond_sum |
초당 count 요청 횟수 | 초당 count 요청 횟수 | 회/초 | target(인스턴스 ID) |
DeletePerSecond_sum |
초당 delete 요청 횟수 | 초당 delete 요청 횟수 | 회/초 | target(인스턴스 ID) |
InsertPerSecond_sum |
초당 insert 요청 횟수 | 초당 insert 요청 횟수 | 회/초 | target(인스턴스 ID) |
ReadPerSecond_sum |
초당 read 요청 횟수 | 초당 read 요청 횟수 | 회/초 | target(인스턴스 ID) |
UpdatePerSecond_sum |
초당 update 요청 횟수 | 초당 update 요청 횟수 | 회/초 | target(인스턴스 ID) |
지연 요청 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
Delay10_sum |
지연이 10 - 50밀리초인 요청 횟수 | 단위 시간 내 성공 요청의 지연이 10ms - 50ms인 횟수 | 회 | target(인스턴스 ID) |
Delay50_sum |
지연이 50 - 100밀리초인 요청 횟수 | 단위 시간 내 성공 요청의 지연이 50ms - 100ms인 횟수 | 회 | target(인스턴스 ID) |
Delay100_sum |
지연이 100밀리초 이상인 요청 횟수 | 단위 시간 내 성공 요청의 지연이 100ms 이상인 횟수 | 회 | target(인스턴스 ID) |
AvgAllRequestDelay_sum |
모든 요청 평균 지연 | 모든 요청 평균 지연 | ms | target(인스턴스 ID) |
연결 수 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
ClusterConn_max |
클러스터 연결 수 | 클러스터 총 연결 수, 현재 클러스터 proxy가 받은 연결 수 | 회 | target(인스턴스 ID) |
Connper_max |
연결 사용률 | 현재 클러스터의 연결 수와 클러스터 총 연결 설정의 비율 | % | target(인스턴스 ID) |
시스템 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
ClusterDiskusage |
디스크 사용률 | 클러스터의 현재 실제 저장 공간 사용량과 총 용량 설정의 비율 | % | target(인스턴스 ID) |
유입·유출 트래픽 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
ClusterNetin |
유입 트래픽 | 클러스터 네트워크 유입 트래픽 | Bytes | target(인스턴스 ID) |
ClusterNetout |
유출 트래픽 | 클러스터 네트워크 유출 트래픽 | Bytes | target(인스턴스 ID) |
MongoDB 복제 세트¶
1. 시스템 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
ReplicaDiskusage |
디스크 사용률 | 복제 세트 용량 사용률 | % | target(복제 세트 ID) |
2. 주종 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
SlaveDelay |
주종 지연 | 주종의 단위 시간당 평균 지연 | 초 | target(복제 세트 ID) |
Oplogreservedtime |
oplog 보존 시간 | oplog 기록에서 마지막 작업과 첫 작업 시간의 차이 | 시간 | target(복제 세트 ID) |
3. Cache 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
CacheDirty |
Cache 더티 데이터 비율 | 현재 메모리 Cache의 더티 데이터 비율 | % | target(복제 세트 ID) |
CacheUsed |
Cache 사용 비율 | 현재 Cache 사용 비율 | % | target(복제 세트 ID) |
HitRatio |
Cache 적중률 | 현재 Cache 적중률 | % | target(복제 세트 ID) |
Mongo 노드¶
1. 시스템 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
CpuUsage |
CPU 사용률 | CPU 사용률 | % | target(노드 ID) |
MemUsage |
메모리 사용률 | 메모리 사용률 | % | target(노드 ID) |
NetIn |
네트워크 유입 트래픽 | 네트워크 유입 트래픽 | MB/s | target(노드 ID) |
NetOut |
네트워크 유출 트래픽 | 네트워크 유출 트래픽 | MB/s | target(노드 ID) |
Disk |
노드 디스크 사용량 | 노드 디스크 사용량 | MB | target(노드 ID) |
Conn |
연결 수 | 연결 수 | 회 | target(노드 ID) |
ActiveSession |
활성 session 수량 | 활성 session 수량 | 회 | target(노드 ID) |
NodeOplogReservedTime |
Oplog 보존 시간 | 노드 oplog 보존 시간 | - | target(노드 ID) |
NodeHitRatio |
Cache 적중률 | Cache 적중률 | % | target(노드 ID) |
NodeCacheUsed |
Cache 사용 비율 | Cache 메모리가 전체 메모리에서 차지하는 비율 | % | target(노드 ID) |
NodeSlavedelay |
주종 지연 | 자식 노드 지연 | s | target(노드 ID) |
Diskusage |
노드 디스크 사용률 | 노드 디스크 사용률 | % | target(노드 ID) |
Ioread |
디스크 읽기 횟수 | 디스크 읽기 IOPS | 회/초 | target(노드 ID) |
Iowrite |
디스크 쓰기 횟수 | 디스크 쓰기 IOPS | 회/초 | target(노드 ID) |
NodeCacheDirty |
Cache 더티 데이터 비율 | Cache의 더티 데이터 비율 | % | target(노드 ID) |
2. 읽기·쓰기 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
Qr |
Read 요청 대기열의 개수 | Read 요청 대기열의 개수 | 개 | target(노드 ID) |
Qw |
Write 요청 대기열의 개수 | Write 요청 대기열의 개수 | 개 | target(노드 ID) |
Ar |
WT 엔진의 ActiveRead | Read 요청 활성 개수 | 개 | target(노드 ID) |
Aw |
WT 엔진 ActiveWrite | Write 요청 활성 개수 | 개 | target(노드 ID) |
3. 지연 및 요청 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
NodeAvgAllRequestDelay |
모든 요청 평균 지연 | 노드의 모든 요청 평균 지연 | ms | target(노드 ID) |
NodeDelay100 |
노드 지연이 100밀리초를 초과한 요청 수 | 노드 지연이 100밀리초를 초과한 요청 수 | 회 | target(노드 ID) |
NodeDelay10 |
노드 지연이 10-50밀리초인 요청 수 | 노드 지연이 10-50밀리초인 요청 수 | 회 | target(노드 ID) |
NodeDelay50 |
노드 지연이 50-100밀리초인 요청 수 | 노드 지연이 50-100밀리초인 요청 수 | 회 | target(노드 ID) |
NodeSuccessPerSecond |
노드 초당 요청 성공 수 | 노드 초당 요청 성공 수 | 회/초 | target(노드 ID) |
NodeCountPerSecond |
노드 초당 count 요청 횟수 | 노드 초당 count 요청 횟수 | 회/초 | target(노드 ID) |
NodeDeletePerSecond |
노드 초당 delete 요청 횟수 | 노드 초당 delete 요청 횟수 | 회/초 | target(노드 ID) |
NodeInsertPerSecond |
노드 초당 insert 요청 횟수 | 노드 초당 insert 요청 횟수 | 회/초 | target(노드 ID) |
NodeReadPerSecond |
노드 초당 read 요청 횟수 | 노드 초당 read 요청 횟수 | 회/초 | target(노드 ID) |
NodeUpdatePerSecond |
노드 초당 update 요청 횟수 | 노드 초당 update 요청 횟수 | 회/초 | target(노드 ID) |
SuccessPerSecond |
총 요청 | 노드 초당 요청 성공 수 | 회/초 | target(노드 ID) |
4. TTL 인덱스 유형¶
| 지표 영문명 | 지표 한글명 | 의미 | 단위 | 차원 |
|---|---|---|---|---|
TtlDeleted |
TTL 삭제된 데이터 개수 | TTL 삭제된 데이터 개수 | 개 | target(노드 ID) |
TtlPass |
TTL 동작 횟수 | TTL 동작 횟수 | 개 | target(노드 ID) |
객체¶
수집된 Tencent Cloud MongoDB 객체 데이터 구조로, 「기본 인프라-사용자 정의」에서 객체 데이터를 볼 수 있습니다
{
"measurement": "tencentcloud_mongodb",
"tags": {
"ClusterType" : "0",
"InstanceId" : "cmxxxx",
"InstanceName": "test_01",
"InstanceType": "1",
"MongoVersion": "MONxxxx",
"NetType" : "1",
"PayMode" : "0",
"ProjectId" : "0",
"RegionId" : "ap-nanjing",
"Status" : "2",
"VpcId" : "vpc-nf6xxxxx",
"Zone" : "ap-nanjing-1",
"name" : "cmxxxx"
},
"fields": {
"CloneInstances" : "[]",
"CreateTime" : "2022-08-24 13:54:00",
"DeadLine" : "2072-08-24 13:54:00",
"ReadonlyInstances": "[]",
"RelatedInstance" : "{인스턴스 JSON 데이터}",
"ReplicaSets" : "{인스턴스 JSON 데이터}",
"StandbyInstances" : "[]",
"message" : "{인스턴스 JSON 데이터}",
}
}
로그¶
느린 쿼리 통계¶
전제 조건¶
참고 1: 이 스크립트의 코드 실행은 MongoDB 인스턴스 객체 수집에 의존하므로, MongoDB의 사용자 정의 객체 수집이 구성되지 않으면 느린 로그 스크립트는 느린 로그 데이터를 수집할 수 없습니다
설치 스크립트¶
이전 단계에 더해, 해당 MongoDB 느린 쿼리 통계 로그 수집 스크립트를 하나 더 설치해야 합니다
「관리 / 스크립트 마켓」에서 해당 스크립트 패키지를 클릭해 설치합니다:
- 「Guance 통합(텐센트 클라우드-MongoDB 느린 쿼리 로그 수집) 」(ID:
integration_tencentcloud_mongodb_slowlog)
데이터가 정상적으로 동기화된 후, Guance의 「로그」에서 데이터를 확인할 수 있습니다.
보고되는 데이터 예시는 다음과 같습니다:
{
"measurement": "tencentcloud_mongodb_slow_log",
"tags": {
},
"fields": {
"Slowlog": "느린 로그 상세",
"message": "{인스턴스 JSON 데이터}"
}
}
주의:
tags와fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다참고 1:
tags값은 사용자 정의 객체로 보완됩니다참고 2:
fields.message는 JSON 직렬화 후의 문자열입니다참고 3:
fields.Slowlog는 모든 느린 쿼리 상세 기록의 각 항목입니다