PostgreSQL

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

다음 단계

Ansible을 사용하여 작업 에이전트를 설치하고, 타사 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 작업 에이전트를 설치하여 타사 애플리케이션 문제 해결 동영상을 참조하세요.