콘텐츠로 이동

AWS RDS PostgreSQL

사용 스크립트 마켓의 「Guance 클라우드 동기화」 시리즈 스크립트 패키지로 클라우드 모니터링과 클라우드 자산 데이터를 Guance로 동기화합니다

구성

Func 설치

Guance 통합 - 확장 - 호스팅 버전 Func를 사용하는 것을 권장합니다. 모든 사전 조건이 자동으로 설치되므로, 바로 스크립트 설치를 진행하면 됩니다

직접 Func를 배포하는 경우 Func 직접 배포를 참고하세요

스크립트 설치

안내: 요구 사항에 맞는 Amazon AK를 미리 준비해 주세요. (간단히 하려면 전역 읽기 전용 권한 ReadOnlyAccess를 직접 부여해도 됩니다)

호스팅 버전 스크립트 활성화

  1. Guance 콘솔에 로그인합니다
  2. [통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
  3. [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보가 이미 설정되어 있다면 이 단계를 건너뜁니다
  4. [테스트]를 클릭하고, 테스트에 성공하면 [저장]을 클릭합니다. 테스트에 실패하면 관련 설정이 올바른지 확인한 뒤 다시 테스트합니다
  5. [클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 이동합니다
  6. 클라우드 계정 상세 페이지에서 [통합] 버튼을 클릭한 뒤 미설치 목록에서 AWS RDS PostgreSQL을 찾아 [설치] 버튼을 클릭하고, 나타나는 설치 화면에서 설치합니다. 설치 화면에서 [설치] 버튼을 다시 클릭해 설치를 완료합니다.

수동 스크립트 활성화

  1. Func 콘솔에 로그인한 뒤 [스크립트 마켓]을 클릭하여 Guance 스크립트 마켓으로 들어가고, integration_aws_rds_postgresql을 검색합니다

  2. [설치]를 클릭한 뒤 다음 파라미터를 입력합니다. AWS AK ID, AK Secret, 계정명.

  3. [배포 시작 스크립트]를 클릭하면 시스템이 자동으로 Startup 스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다.

  4. 활성화 후에는 [관리 / 자동 트리거 설정]에서 해당 자동 트리거 구성을 확인할 수 있습니다. [실행]을 클릭하면 예약 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다.

검증

  1. [관리 / 자동 트리거 설정]에서 해당 작업에 대한 자동 트리거 구성이 존재하는지 확인하고, 작업 기록과 로그를 확인하여 이상 여부를 점검합니다
  2. Guance의 [인프라 - 리소스 디렉터리]에서 자산 정보가 존재하는지 확인합니다
  3. Guance의 [지표]에서 해당 모니터링 데이터가 있는지 확인합니다

지표

Amazon 클라우드 모니터링을 구성하면 설정을 통해 더 많은 지표를 수집할 수 있습니다. Amazon CloudWatch 지표 상세

Amazon RDS의 Amazon CloudWatch 지표

Amazon CloudWatch의 AWS/RDS 네임스페이스에는 다음 인스턴스 수준 지표가 포함됩니다.

참고: Amazon RDS 콘솔은 Amazon CloudWatch로 전송되는 단위와 다른 단위로 지표를 표시할 수 있습니다. 예를 들어 Amazon RDS 콘솔은 어떤 지표를 메가바이트(MB)로 표시하면서, Amazon CloudWatch에는 바이트 단위로 전송할 수 있습니다.

지표 콘솔 이름 설명 단위
BinLogDiskUsage Binary log disk usage (MB) 이진 로그가 차지하는 디스크 공간의 크기입니다. MySQL 및 MariaDB 인스턴스(읽기 전용 복제본 포함)에서 자동 백업이 활성화되어 있으면 이진 로그가 생성됩니다. 바이트
BurstBalance Burst balance (percent) 사용 가능한 범용 SSD(GP2) 버스트 버킷 I/O 크레딧의 백분율입니다. 백분율
CheckpointLag Checkpoint lag (milliseconds) 가장 최근 체크포인트 이후의 시간입니다. RDS for PostgreSQL에만 적용됩니다. 밀리초
ConnectionAttempts Connection Attempts (Count) [Connection Attempts (count)] 성공 여부와 관계없이 인스턴스에 연결을 시도한 횟수입니다. 카운트
CPUUtilization CPU utilization (percent) CPU 사용률입니다. 백분율
CPUCreditUsage CPU credit usage (count) (T2 인스턴스) 인스턴스가 CPU 사용률을 유지하기 위해 소비한 CPU 크레딧 수입니다. CPU 크레딧 1개는 vCPU 1개가 100% 사용률로 1분 동안 실행되거나, 이에 상응하는 vCPU 사용률과 시간의 조합과 같습니다. 예를 들어, vCPU 1개를 50% 사용률로 2분간 실행하거나, vCPU 2개를 25% 사용률로 2분간 실행할 수 있습니다. CPU 크레딧 지표는 5분마다만 제공됩니다. 5분보다 긴 기간을 지정하는 경우 Average가 아니라 Sum 통계를 사용하세요. 크레딧(vCPU 분)
CPUCreditBalance CPU credit balance (count) (T2 인스턴스) 인스턴스 시작 이후 누적된 CPU 크레딧 수입니다. T2 Standard의 경우 CPUCreditBalance에는 누적된 시작 크레딧 수도 포함됩니다. 크레딧을 얻으면 크레딧 잔액에 누적되며, 크레딧을 사용하면 잔액에서 차감됩니다. 크레딧 잔액에는 인스턴스 크기에 따라 결정되는 최대값이 있습니다. 이 제한에 도달하면 새로 얻은 크레딧은 모두 버려집니다. T2 Standard의 시작 크레딧은 이 제한에 포함되지 않습니다. 인스턴스는 CPUCreditBalance의 크레딧을 사용하여 기준 CPU 사용률 이상으로 버스트할 수 있습니다. 인스턴스가 실행되는 동안 CPUCreditBalance의 크레딧은 만료되지 않습니다. 인스턴스가 중지되면 CPUCreditBalance는 유지되지 않으며 누적된 모든 크레딧이 손실됩니다. CPU 크레딧 지표는 5분마다만 제공됩니다. 시작 크레딧은 Amazon EC2와 동일한 방식으로 Amazon RDS에서 작동합니다. 자세한 내용은 Linux 인스턴스를 위한 Amazon Elastic Compute Cloud 사용 설명서시작 크레딧을 참조하세요. 크레딧(vCPU 분)
DatabaseConnections Database connections (count) 데이터베이스 인스턴스에 연결된 클라이언트 네트워크 연결 수입니다. 데이터베이스 세션 수는 지표 값보다 높을 수 있는데, 이는 지표 값에 다음이 포함되지 않기 때문입니다. 더 이상 네트워크 연결이 없지만 데이터베이스가 아직 정리하지 않은 세션 데이터베이스 엔진이 자체 목적을 위해 생성한 세션 데이터베이스 엔진의 병렬 실행 기능이 생성한 세션 데이터베이스 엔진 작업 스케줄러가 생성한 세션 Amazon RDS 연결 카운트
DiskQueueDepth Queue depth (count) 디스크에 대한 액세스를 기다리는 미완료 I/O(읽기/쓰기 요청)의 수입니다. 카운트
EBSByteBalance% EBS byte balance (percent) RDS 데이터베이스 버스트 버킷에 남아 있는 처리량 크레딧의 비율입니다. 이 지표는 기본 모니터링에서만 사용할 수 있습니다. 이 지표 값은 데이터베이스 파일이 있는 볼륨뿐 아니라 루트 볼륨을 포함한 모든 볼륨의 처리량과 IOPS를 기반으로 합니다. 이 지표를 지원하는 인스턴스 크기를 찾으려면 Amazon EC2 사용 설명서( Linux 인스턴스용 )기본적으로 최적화된 EBS 표에서 별표(*)가 표시된 인스턴스 크기를 참조하세요. Sum 통계는 이 지표에 적용되지 않습니다. 백분율
EBSIOBalance% EBS IO balance (percent) RDS 데이터베이스 버스트 버킷에 남아 있는 I/O 크레딧의 비율입니다. 이 지표는 기본 모니터링에서만 사용할 수 있습니다. 이 지표 값은 데이터베이스 파일이 있는 볼륨뿐 아니라 루트 볼륨을 포함한 모든 볼륨의 처리량과 IOPS를 기반으로 합니다. 이 지표를 지원하는 인스턴스 크기를 찾으려면 Amazon EC2 사용 설명서( Linux 인스턴스용 )기본적으로 최적화된 EBS 표에서 별표(*)가 표시된 인스턴스 크기를 참조하세요. Sum 통계는 이 지표에 적용되지 않습니다. 이 지표는 BurstBalance와 다릅니다. 이 지표를 사용하는 방법은 Amazon EBS 최적화 인스턴스 버스트 기능으로 애플리케이션 성능을 개선하고 비용을 절감하기를 참조하세요. 백분율
FailedSQLServerAgentJobsCount Failed SQL Server Agent Jobs Count (Count/Minute) [Failed SQL Server Agent job count (count/minute)] 지난 1분 동안 실패한 Microsoft SQL Server Agent 작업의 수입니다. 분당 카운트
FreeableMemory Freeable memory (MB) 사용 가능한 RAM 크기입니다. MariaDB, MySQL, Oracle 및 PostgreSQL 데이터베이스 인스턴스의 경우 이 지표는 /proc/meminfoMemAvailable 필드 값을 보고합니다. 바이트
FreeLocalStorage Free Local Storage (MB) 사용 가능한 로컬 스토리지 공간의 크기입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. (이는 Aurora Serverless v2에는 적용되지 않습니다.) 바이트
FreeStorageSpace Free storage space (MB) 사용 가능한 스토리지 공간의 크기입니다. 바이트
MaximumUsedTransactionIDs Maximum used transaction IDs (count) 사용된 최대 트랜잭션 ID입니다. PostgreSQL에만 적용됩니다. 카운트
NetworkReceiveThroughput Network receive throughput (MB/s) 모니터링 및 복제에 사용되는 고객 데이터베이스 트래픽과 Amazon RDS 트래픽을 포함한 데이터베이스 인스턴스의 인바운드(수신) 네트워크 트래픽입니다. 초당 바이트 수
NetworkTransmitThroughput Network transmit throughput (MB/s) 모니터링 및 복제에 사용되는 고객 데이터베이스 트래픽과 Amazon RDS 트래픽을 포함한 데이터베이스 인스턴스의 아웃바운드(전송) 네트워크 트래픽입니다. 초당 바이트 수
OldestReplicationSlotLag Oldest replication slot lag (MB) 선행 쓰기 로그(WAL) 데이터 수신에서 가장 뒤처진 복제본의 지연 크기입니다. PostgreSQL에 적용됩니다. 바이트
ReadIOPS Read IOPS (count/second) 초당 평균 디스크 읽기 I/O 작업 수입니다. 초당 카운트
ReadIOPSLocalStorage Read IOPS local storage (count/second) 로컬 스토리지에 대한 초당 평균 디스크 읽기 입력/출력 작업 수입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. 초당 카운트
ReadLatency Read latency (milliseconds) 각 디스크 I/O 작업에 필요한 평균 시간입니다. 밀리초
ReadLatencyLocalStorage Read latency local storage (milliseconds) 로컬 스토리지에 대한 각 디스크 입력/출력 작업에 필요한 평균 시간입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. 밀리초
ReadThroughput Read throughput (MB/s) 초당 디스크에서 읽은 평균 바이트 수입니다. 초당 바이트 수
ReadThroughputLocalStorage Read throughput local storage (MB/second) 초당 디스크에서 로컬 스토리지로 읽은 평균 바이트 수입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. 초당 바이트 수
ReplicaLag Replica lag (milliseconds) 읽기 전용 복제본 구성의 경우, 읽기 전용 복제본 데이터베이스 인스턴스가 소스 데이터베이스 인스턴스보다 뒤처지는 시간입니다. MariaDB, Microsoft SQL Server, MySQL, Oracle 및 PostgreSQL 읽기 전용 복제본에 적용됩니다. 다중 AZ 데이터베이스 클러스터의 경우, 쓰기기 데이터베이스 인스턴스의 최신 트랜잭션과 읽기기 데이터베이스 인스턴스의 최신 적용 트랜잭션 사이의 시간 차이입니다. 밀리초
ReplicationSlotDiskUsage Replication slot disk usage (MB) 복제 슬롯 파일이 사용한 디스크 공간입니다. PostgreSQL에 적용됩니다. 바이트
SwapUsage Swap usage (MB) 데이터베이스 인스턴스에서 사용 중인 스왑 공간의 크기입니다. 이 지표는 SQL Server에서는 사용할 수 없습니다. 바이트
TransactionLogsDiskUsage Transaction logs disk usage (MB) 트랜잭션 로그가 사용한 디스크 공간입니다. PostgreSQL에 적용됩니다. 바이트
TransactionLogsGeneration Transaction logs generation (MB/second) 초당 생성되는 트랜잭션 로그의 크기입니다. PostgreSQL에 적용됩니다. 초당 바이트 수
WriteIOPS Write IOPS (count/second) 초당 평균 디스크 쓰기 I/O 작업 수입니다. 초당 카운트
WriteIOPSLocalStorage Write IOPS local storage (count/second) 로컬 스토리지에 대한 초당 평균 디스크 쓰기 I/O 작업 수입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. 초당 카운트
WriteLatency Write latency (milliseconds) 각 디스크 I/O 작업에 필요한 평균 시간입니다. 밀리초
WriteLatencyLocalStorage Write latency local storage (milliseconds) 로컬 스토리지에서 각 디스크 I/O 작업에 필요한 평균 시간입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. 밀리초
WriteThroughput Write throughput (MB/s) 초당 디스크에 기록된 평균 바이트 수입니다. 초당 바이트 수
WriteThroughputLocalStorage Write throughput local storage (MB/second) 로컬 스토리지에서 초당 디스크에 기록된 평균 바이트 수입니다. 이 지표는 NVMe SSD 인스턴스 스토리지 볼륨이 있는 데이터베이스 인스턴스 클래스에만 적용됩니다. NVMe SSD 인스턴스 스토리지 볼륨이 있는 Amazon EC2 인스턴스에 대한 자세한 내용은 인스턴스 스토리지 볼륨을 참조하세요. 이에 상응하는 RDS 데이터베이스 인스턴스 클래스는 동일한 인스턴스 스토리지 볼륨을 가집니다. 예를 들어 db.m6gd 및 db.r6gd 데이터베이스 인스턴스 클래스에는 NVMe SSD 인스턴스 스토리지 볼륨이 있습니다. 초당 바이트 수

객체

수집된 AWS RDS PostgreSQL 객체 데이터 구조는 [인프라 - 리소스 디렉터리]에서 객체 데이터를 확인할 수 있습니다

{
  "measurement": "aws_rds",
  "tags": {
    "name"                     : "xxxxx",
    "RegionId"                 : "cn-northwest-1",
    "Engine"                   : "postgres",
    "DBInstanceClass"          : "db.t3.medium",
    "DBInstanceIdentifier"     : "xxxxxx",
    "AvailabilityZone"         : "cn-northwest-1c",
    "SecondaryAvailabilityZone": "ap-southeast-1c"
  },
  "fields": {
    "InstanceCreateTime"  : "2025-05-19T19:54:07.871Z",
    "LatestRestorableTime": "2025-05-19T19:54:07.871Z",
    "Endpoint"            : "{연결 주소 JSON 데이터}",
    "AllocatedStorage"    : 100,
    "message"             : "{인스턴스 JSON 데이터}",
  }
}

주의: tags, fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다

안내 1: tags.name 값은 인스턴스 ID이며, 고유 식별자로 사용됩니다

안내 2: fields.message, fields.Endpoint는 모두 JSON 직렬화 후의 문자열입니다

문서 평가

이 페이지가 도움이 되었나요?