PostgreSQL 통합은 데이터베이스 크기, 백엔드 수, 작업 수와 같은 데이터베이스 사용량 측정항목을 수집합니다. 또한 통합은 PostgreSQL 로그를 수집하고 이를 JSON 페이로드로 파싱합니다. 이 결과에는 역할, 사용자, 수준, 메시지에 대한 필드가 포함됩니다.
PostgreSQL에 대한 자세한 내용은 postgresql.org를 참조하세요.
기본 요건
PostgreSQL 로그 및 측정항목을 수집하려면 작업 에이전트 버전 2.9.0 이상을 설치해야 합니다.
이 수신자는 PostgreSQL 버전 10.18 이상을 지원합니다.
PostgreSQL 인스턴스 구성
postgresql
수신자는 기본적으로 Unix 소켓과 Unix 인증을 root
사용자로 사용하여 로컬 postgresql
서버에 연결합니다.
PostgreSQL용 작업 에이전트 구성
작업 에이전트 구성 가이드에 따라 PostgreSQL 인스턴스에서 로그와 측정항목을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.
구성 예시
다음 명령어는 구성 파일을 만들어 PostgreSQL의 로그와 측정항목을 수집하고 Linux에서 작업 에이전트를 다시 시작합니다.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
logging:
receivers:
postgresql_general:
type: postgresql_general
service:
pipelines:
postgresql:
receivers:
- postgresql_general
metrics:
receivers:
postgresql:
type: postgresql
collection_interval: 60s
username: usr
password: pwd
service:
pipelines:
postgresql_pipeline:
receivers:
- postgresql
EOF
sudo service google-cloud-ops-agent restart
로그 수집 구성
PostgreSQL에서 로그를 수집하려면 PostgreSQL으로 생성되는 로그의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.
postgresql_general
로그의 수신자를 구성하려면 다음 필드를 지정합니다.
필드 | 기본값 | 설명 |
---|---|---|
type |
값은 postgresql_general 여야 합니다. |
|
include_paths |
[/var/log/postgresql/postgresql*.log, /var/lib/pgsql/data/log/postgresql*.log, /var/lib/pgsql/*/data/log/postgresql*.log] |
읽을 로그 파일입니다. |
exclude_paths |
include_paths 에 glob 또는 디렉터리가 포함된 경우 제외할 로그 파일입니다. |
로깅되는 내용
postgresql_general
로그의 logName
은 구성에 지정된 수신자 ID에서 파생됩니다. LogEntry
내의 자세한 필드는 다음과 같습니다.
postgresql_general
로그의 LogEntry
는 다음 필드가 포함됩니다.
필드 | 유형 | 설명 |
---|---|---|
jsonPayload.tid |
숫자 | 로그가 발생된 스레드 ID |
jsonPayload.role |
문자열 | 해당되는 경우 로깅되는 작업에 대해 인증된 역할 |
jsonPayload.user |
문자열 | 해당되는 경우 로깅되는 작업에 대해 인증된 사용자 |
jsonPayload.level |
문자열 | 일부 로그에 대한 로그 심각도 또는 데이터베이스 상호작용 유형 |
jsonPayload.message |
문자열 | 데이터베이스 작업 로그 |
severity |
문자열(LogSeverity ) |
로그 항목 수준(번역됨) |
timestamp |
문자열(Timestamp ) |
항목이 로깅된 시간 |
측정항목 수집 구성
PostgreSQL에서 측정항목을 수집하려면 PostgreSQL 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다. PostgreSQL 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.
필드 | 기본값 | 설명 |
---|---|---|
type |
값은 postgresql 여야 합니다. |
|
endpoint |
/var/run/postgresql/.s.PGSQL.5432 |
/ 로 시작하는 호스트 이름:포트 또는 소켓 경로로 postgresql 서버에 연결하는 데 사용됩니다. |
collection_interval |
60s |
time.Duration 값(예: 30s 또는 5m )입니다. |
username |
서버를 연결하는 데 사용되는 비밀번호입니다. | |
password |
서버 연결에 사용되는 비밀번호입니다. | |
insecure |
true |
보안 TLS 연결을 사용할지 여부를 설정합니다. false 로 설정하면 TLS가 사용 설정됩니다. |
insecure_skip_verify |
false |
인증서 확인을 건너뛸지 여부를 설정합니다. insecure 이 true 로 설정된 경우 insecure_skip_verify 값이 사용되지 않습니다. |
cert_file |
TLS 필수 연결에 사용할 TLS 인증서의 경로입니다. | |
key_file |
TLS 필수 연결에 사용할 TLS 키의 경로입니다. | |
ca_file |
CA 인증서의 경로입니다. 클라이언트로서 서버 인증서를 확인합니다. 비어있으면 수신자는 시스템 루트 CA를 사용합니다. |
모니터링 대상
다음 표에서는 작업 에이전트가 PostgreSQL 인스턴스에서 수집하는 측정항목의 목록을 보여줍니다.
측정항목 유형 | |
---|---|
종류, 유형 모니터링 리소스 |
라벨 |
workload.googleapis.com/postgresql.backends
|
|
GAUGE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.commits
|
|
CUMULATIVE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.db_size
|
|
GAUGE , INT64 gce_instance |
database
|
workload.googleapis.com/postgresql.rollbacks
|
|
CUMULATIVE , INT64 gce_instance |
database
|
구성 확인
로그 탐색기와 측정항목 탐색기를 사용하여 PostgreSQL 수신자를 올바르게 구성했는지 확인할 수 있습니다. 작업 에이전트가 로그 및 측정항목 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.
로그가 수집되었는지 확인하려면 로그 탐색기로 이동하고 다음 쿼리를 실행하여 PostgreSQL 로그를 확인합니다.
resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/postgresql_general")
측정항목이 수집되었는지 확인하려면 측정항목 탐색기로 이동하고 MQL 탭에서 다음 쿼리를 실행합니다.
fetch gce_instance
| metric 'workload.googleapis.com/postgresql.operations'
| align rate(1m)
| every 1m