PostgreSQL 통합은 데이터베이스 크기, 백엔드 수, 작업 수와 같은 데이터베이스 사용량 측정항목을 수집합니다. 또한 통합은 PostgreSQL 로그를 수집하고 이를 JSON 페이로드로 파싱합니다. 이 결과에는 역할, 사용자, 수준, 메시지에 대한 필드가 포함됩니다.
PostgreSQL에 대한 자세한 내용은 PostgreSQL 문서를 참조하세요.
기본 요건
PostgreSQL 원격 분석을 수집하려면 운영 에이전트를 설치해야 합니다.
- 측정항목의 경우 버전 2.9.0 이상을 설치합니다. 버전 2.21.0에 측정항목이 추가되었습니다.
- 로그의 경우 버전 2.9.0 이상을 설치합니다.
이 통합에서는 PostgreSQL 버전 10.18 이상을 지원합니다.
PostgreSQL 인스턴스 구성
postgresql
수신자는 기본적으로 Unix 소켓과 Unix 인증을 root
사용자로 사용하여 로컬 postgresql
서버에 연결합니다.
PostgreSQL용 작업 에이전트 구성
운영 에이전트 구성 가이드를 수행하여 PostgreSQL 인스턴스에서 원격 분석을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.
구성 예시
다음 명령어는 PostgreSQL용 원격 분석을 수집하고 운영 에이전트를 다시 시작하는 구성을 만듭니다.
로그 수집 구성
PostgreSQL에서 로그를 수집하려면 PostgreSQL에서 생성하는 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.
postgresql_general
로그의 수신자를 구성하려면 다음 필드를 지정합니다.
필드 | 기본값 | 설명 |
---|---|---|
exclude_paths |
include_paths 중에서 일치하는 집합에서 제외할 파일 시스템 경로 패턴의 목록입니다. |
|
include_paths |
[/var/log/postgresql/postgresql*.log, /var/lib/pgsql/data/log/postgresql*.log, /var/lib/pgsql/*/data/log/postgresql*.log] |
각 파일을 테일링하여 읽을 파일 시스템 경로의 목록입니다. 와일드 카드(* )를 경로에 사용할 수 있습니다. |
record_log_file_path |
false |
true 로 설정된 경우 로그 레코드를 가져온 특정 파일의 경로가 출력 로그 항목에 agent.googleapis.com/log_file_path 라벨 값으로 표시됩니다. 와일드 카드를 사용할 경우 레코드를 가져온 파일의 경로만 기록됩니다. |
type |
값은 postgresql_general 여야 합니다. |
|
wildcard_refresh_interval |
60s |
include_path의 와일드 카드 파일 경로가 새로고침되는 간격입니다. time.ParseDuration으로 구문 분석할 수 있는 기간으로 제공됩니다(예: 30s 또는 2m ). 이 속성은 로그 파일이 기본 간격보다 빠르게 순환되는 높은 로깅 처리량에서 유용할 수 있습니다. |
로깅되는 내용
logName
은 구성에 지정된 수신자 ID에서 파생됩니다. LogEntry
내의 자세한 필드는 다음과 같습니다.
postgresql_general
로그에는 LogEntry
의 다음 필드가 포함됩니다.
필드 | 유형 | 설명 |
---|---|---|
jsonPayload.level |
문자열 | 일부 로그에 대한 로그 심각도 또는 데이터베이스 상호작용 유형 |
jsonPayload.message |
문자열 | 데이터베이스 작업 로그 |
jsonPayload.role |
문자열 | 해당되는 경우 로깅되는 작업에 대해 인증된 역할 |
jsonPayload.tid |
숫자 | 로그가 발생된 스레드 ID |
jsonPayload.user |
문자열 | 해당되는 경우 로깅되는 작업에 대해 인증된 사용자 |
severity |
문자열(LogSeverity ) |
로그 항목 수준입니다(번역됨). |
측정항목 수집 구성
PostgreSQL에서 측정항목을 수집하려면 PostgreSQL에서 생성하는 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.
postgresql
측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.
필드 | 기본값 | 설명 |
---|---|---|
ca_file |
CA 인증서의 경로입니다. 클라이언트로서 서버 인증서를 확인합니다. 비어있으면 수신자는 시스템 루트 CA를 사용합니다. | |
cert_file |
mTLS 필수 연결에 사용할 TLS 인증서의 경로입니다. | |
collection_interval |
60s |
time.Duration 값(예: 30s 또는 5m )입니다. |
endpoint |
/var/run/postgresql/.s.PGSQL.5432 |
/ 로 시작하는 호스트 이름:포트 또는 소켓 경로로 postgresql 서버에 연결하는 데 사용됩니다. |
insecure |
true |
보안 TLS 연결을 사용할지 여부를 설정합니다. false 로 설정하면 TLS가 사용 설정됩니다. |
insecure_skip_verify |
false |
인증서 확인을 건너뛸지 여부를 설정합니다. insecure 이 true 로 설정된 경우 insecure_skip_verify 값이 사용되지 않습니다. |
key_file |
mTLS 필수 연결에 사용할 TLS 키의 경로입니다. | |
password |
서버 연결에 사용되는 비밀번호입니다. | |
type |
값은 postgresql 여야 합니다. |
|
username |
서버를 연결하는 데 사용되는 비밀번호입니다. |
모니터링 대상
다음 표에서는 작업 에이전트가 PostgreSQL 인스턴스에서 수집하는 측정항목의 목록을 보여줍니다.
측정항목 유형 | |
---|---|
종류, 유형 모니터링 리소스 |
라벨 |
workload.googleapis.com/postgresql.backends
|
|
GAUGE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.bgwriter.buffers.allocated
|
|
CUMULATIVE , INT64 gce_instance |
|
workload.googleapis.com/postgresql.bgwriter.buffers.writes
|
|
CUMULATIVE , INT64 gce_instance |
source
|
workload.googleapis.com/postgresql.bgwriter.checkpoint.count
|
|
CUMULATIVE , INT64 gce_instance |
type
|
workload.googleapis.com/postgresql.bgwriter.duration
|
|
CUMULATIVE , INT64 gce_instance |
type
|
workload.googleapis.com/postgresql.bgwriter.maxwritten
|
|
CUMULATIVE , INT64 gce_instance |
|
workload.googleapis.com/postgresql.blocks_read
|
|
CUMULATIVE , INT64 gce_instance |
database table source
|
workload.googleapis.com/postgresql.commits
|
|
CUMULATIVE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.connection.max
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/postgresql.database.count
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/postgresql.db_size
|
|
GAUGE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.index.scans
|
|
CUMULATIVE , INT64 gce_instance |
database table index
|
workload.googleapis.com/postgresql.index.size
|
|
GAUGE , INT64 gce_instance |
database table index
|
workload.googleapis.com/postgresql.operations
|
|
CUMULATIVE , INT64 gce_instance |
database table operation
|
workload.googleapis.com/postgresql.replication.data_delay
|
|
GAUGE , INT64 gce_instance |
replication_client
|
workload.googleapis.com/postgresql.rollbacks
|
|
CUMULATIVE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.rows
|
|
GAUGE , INT64 gce_instance |
database state table
|
workload.googleapis.com/postgresql.table.count
|
|
GAUGE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.table.size
|
|
GAUGE , INT64 gce_instance |
database table
|
workload.googleapis.com/postgresql.table.vacuum.count
|
|
CUMULATIVE , INT64 gce_instance |
database table
|
workload.googleapis.com/postgresql.wal.age
|
|
GAUGE , INT64 gce_instance |
|
workload.googleapis.com/postgresql.wal.lag
|
|
GAUGE , INT64 gce_instance |
operation replication_client
|
샘플 대시보드
PostgreSQL 측정항목을 보려면 차트나 대시보드가 구성되어 있어야 합니다. Cloud Monitoring은 사전 구성된 차트가 포함된 통합용 샘플 대시보드 라이브러리를 제공합니다. 이러한 대시보드 설치에 대한 자세한 내용은 샘플 대시보드 설치를 참조하세요.
구성 확인
이 섹션에서는 PostgreSQL 수신자를 올바르게 구성했는지 확인하는 방법을 설명합니다. 작업 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.
로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 PostgreSQL 로그를 봅니다.
resource.type="gce_instance"
log_id("postgresql_general")
측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.
fetch gce_instance
| metric 'workload.googleapis.com/postgresql.backends'
| every 1m
다음 단계
Ansible을 사용하여 운영 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.