PostgreSQL 모니터링 구성

에이전트에서 모니터 중인 PostgreSQL 데이터베이스에서 데이터를 수집할 수 있도록 Monitoring Agent for PostgreSQL를 구성해야 합니다.

시작하기 전에

이 에이전트를 설치하기 전에 PostgreSQL JDBC 드라이버를 설치해야 합니다. 이 드라이버의 경로는 에이전트를 구성할 때 필요합니다.

JDBC 유형 4 드라이버는 새 버전이며 따라서 권장됩니다. 사용자는 에이전트가 사용하는 JDK 버전에 따라서 JDBC 4 버전의 하위 유형을 설치할 수 있습니다. JDBC 버전 대 JDBC 버전의 맵핑에 대해서는 https://jdbc.postgresql.org/download.html에서 추가 정보를 얻으십시오.

에이전트에 의해 수집된 몇몇 속성은 pg_stat_statements 확장에 의존합니다. pg_stat_statements를 추가하려면 먼저 postgresql-contrib 패키지를 설치하십시오. PostgreSQL 서버가 pg_stat_statements 확장을 로드하기 위해서는 postgresql.conf 구성 파일을 수정해야 합니다.
  1. postgresql.conf 파일을 텍스트 편집기에서 열고 shared_preload_libraries 행을 업데이트하십시오. 
    shared_preload_libraries = 'pg_stat_statements'
pg_stat_statements.track_utility = false
    이러한 변경은 SQL문을 모니터하는 데 필요합니다(유틸리티 명령 제외).
    참고: pg_stat_statements.track_utility의 상태는 수퍼유저만 설정하거나 수정합니다.
  2. postgresql.conf를 업데이트하고 저장한 후에는 PostgreSQL 서버를 다시 시작하십시오.
  3. JDBC 연결을 위해 나중에 에이전트 구성에 제공될 데이터베이스와 동일한 데이터베이스에 연결되어야 하는 psql을 사용하여 다음 SQL 명령을 실행하십시오. 
    create extension pg_stat_statements; 
select pg_stat_statements_reset();
    참고: 명령 create extension 및 함수 pg_stat_statements_reset()은 수퍼유저에 의해서만 실행됩니다.
    보기 pg_stat_statements를 특정 데이터베이스에 대해 사용으로 설정해야 합니다. 세부사항은 https://www.postgresql.org/docs/9.6/static/pgstatstatements.html의 내용을 참조하십시오.

pg_hba.conf 파일은 인증 설정이 포함된 PostgreSQL 데이터베이스 파일입니다. pg_hba.conf 파일에서 auth-method 매개변수 값이 ident로 설정된 경우, PostgreSQL 에이전트는 PostgreSQL 데이터베이스에 연결할 수 없습니다. auth-method 매개변수에 대한 인증 설정이 올바른지 확인하십시오. 예를 들어, auth-method 매개변수에 md5, trust 또는 password 값을 설정할 수 있습니다.

하드웨어 및 소프트웨어 전제조건을 검토하십시오. 최신 시스템 요구사항에 대해서는 PostgreSQL 에이전트에 대한 소프트웨어 제품 호환성 보고서(SPCR)를 참조하십시오.

이 태스크 정보

PostgreSQL 에이전트는 다중 인스턴스 에이전트입니다. 첫 번째 인스턴스를 작성하고 수동으로 에이전트를 시작해야 합니다. 사용자가 지정하는 인스턴스 이름이 관리 대상 시스템 이름에 포함됩니다(예: instance_name:host_name:pc). 여기서 pc는 두 자리 제품 코드입니다. 관리 대상 시스템 이름은 32자로 제한됩니다. 지정하는 인스턴스 이름은 호스트 이름 길이를 뺀 28자로 제한됩니다. 예를 들어 인스턴스 이름으로 PostgreSQL2를 지정하는 경우 관리 대상 시스템 이름은 PostgreSQL2:hostname:PN입니다.
중요사항: 긴 인스턴스 이름을 지정하면 관리 대상 시스템 이름이 잘리고 에이전트 코드가 완전히 표시되지 않습니다.

제품 버전과 에이전트 버전이 다른 경우가 있습니다. 여기에 설명된 내용은 이 에이전트에 대해 가장 최신 릴리스입니다. 사용자 환경의 에이전트 버전을 확인하는 방법에 대한 정보는 에이전트 버전 명령의 내용을 참조하십시오. 에이전트 버전 목록과 각 버전에 대한 새로운 기능에 대한 자세한 정보는 변경 히스토리의 내용을 참조하십시오.

다음에 수행할 작업

Cloud APM 콘솔에 로그인하여 대시보드에서 에이전트가 수집한 데이터를 보십시오. Cloud APM 콘솔 사용에 대한 정보는 Cloud APM 콘솔 시작의 내용을 참조하십시오.