PostgreSQL 메트릭

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기7분

    • 다음 테이블은 지정된 PostgreSQL 검사에서 출력으로 수집되는 메트릭을 나열하고 설명합니다. 추천 메트릭으로 표시된 항목은 경보가 생성된 후 운영자 작업 공간 메트릭 탭에 표시되는, 가시성이 높은 메트릭입니다. 이러한 메트릭은 운영자에게 지정된 문제를 자세히 알아보는 데 도움이 되는 추가 정보를 제공합니다.

    표 1. postgresql.check-connections 메트릭
    메트릭 설명
    pgsql.connections.active

    (주요 메트릭)

    		 PostgreSQL 데이터베이스의 총 활성 연결에 대한 메트릭을 제공합니다.
    pgsql.connections.idle

    (주요 메트릭)

    		 PostgreSQL 데이터베이스의 총 유휴 상태 연결에 대한 메트릭을 제공합니다.
    표 2. postgresql.metric-dbsize 메트릭
    메트릭 설명
    pgsql.db.size

    (주요 메트릭)

    		 서버에서 각 PostgreSQL 데이터베이스의 총 디스크 크기 사용률에 대한 메트릭을 제공합니다.
    표 3. postgresql.metric-locks 메트릭
    메트릭 설명
    pgsql.locks.AccessShareLock 쿼리된 테이블에서 자동으로 가져온 읽기 잠금 모드의 메트릭을 제공합니다.
    pgsql.locks.ExclusiveLock IN EXCLUSIVE MODE 문의 LOCK TABLE 테이블에서 획득한 읽기 잠금 모드의 메트릭을 제공합니다.
    표 4. postgresql.metric-relations-size 메트릭
    메트릭 설명
    pgsql.tables_size

    (주요 메트릭)

    		 서버의 데이터베이스 테이블 크기에 대한 메트릭을 제공합니다.
    표 5. postgresql.metric-statsbgwriter 메트릭
    메트릭 설명
    pgsql.statsbgwriter.buffers_alloc 할당된 버퍼 수와 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.buffers_backend 백엔드로 직접 쓴 버퍼 수와 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.buffers_backend_fsync 백엔드가 자체 fsync 호출을 실행해야 한 횟수와 관련된 메트릭을 제공합니다(일반적으로 백엔드가 자체 쓰기를 수행하는 경우에도 백그라운드 작성기가 처리함).
    pgsql.statsbgwriter.buffers_checkpoint 검사점 동안 쓴 버퍼 수와 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.buffers_clean 백그라운드 작성기가 쓴 버퍼 수와 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.checkpoint_sync_time 파일이 디스크와 동기화되는 검사점 처리 부분에 사용한 총 시간(밀리초)과 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.checkpoint_write_time 파일이 디스크에 기록되는 검사점 처리 부분에 사용한 총 시간(밀리초)과 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.checkpoints_req

    (주요 메트릭)

    		 수행된 요청된 검사점 수와 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.checkpoints_timed

    (주요 메트릭)

    		 수행된 예약된 검사점 수와 관련된 메트릭을 제공합니다.
    pgsql.statsbgwriter.maxwritten_clean 백그라운드 작성기가 너무 많은 버퍼를 썼기 때문에 클린 검사를 중지한 횟수와 관련된 메트릭을 제공합니다.
    표 6. postgresql.metric-statsdb 메트릭
    메트릭 설명
    pgsql.statsdb.blk_read_time

    (주요 메트릭)

    		 이 데이터베이스의 백엔드별로 데이터 파일 블록을 읽는 데 소요된 시간(밀리초)과 관련된 메트릭을 제공합니다.
    pgsql.statsdb.blk_write_time

    (주요 메트릭)

    		 이 데이터베이스의 백엔드별로 데이터 파일 블록을 쓰는 데 소요된 시간(밀리초)과 관련된 메트릭을 제공합니다.
    pgsql.statsdb.blks_hit

    (주요 메트릭)

    		 읽기가 필요하지 않도록 버퍼 캐시에서 디스크 블록이 발견된 횟수와 관련된 메트릭을 제공합니다. 여기에는 운영 체제의 파일 시스템 캐시가 아니라 PostgreSQL 버퍼 캐시의 적중만 포함됩니다.
    pgsql.statsdb.blks_read 이 데이터베이스에서 읽은 디스크 블록 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.checksum_failures 이 데이터베이스(또는 공유 객체)에서 탐지된 데이터 페이지 체크섬 오류 수와 관련된 메트릭을 제공합니다. 또는 데이터 체크섬이 활성화되지 않은 경우 0을 제공합니다.
    pgsql.statsdb.conflicts 이 데이터베이스의 복구와 상충하여 취소된 쿼리 수와 관련된 메트릭을 제공합니다. 상충은 대기 서버에서만 발생합니다.
    pgsql.statsdb.deadlocks

    (주요 메트릭)

    		 이 데이터베이스에서 검색된 교착 상태 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.numbackends 이 데이터베이스에 현재 연결된 백엔드 수와 관련된 메트릭을 제공합니다. 이 뷰에서 현재 상태를 반영하는 값을 반환하는 유일한 열입니다. 다른 모든 열은 가장 최근 재설정 이후 누적된 값을 반환합니다.
    pgsql.statsdb.temp_bytes 이 데이터베이스의 쿼리에 의해 임시 파일에 쓴 총 데이터 양과 관련된 메트릭을 제공합니다. 임시 파일이 생성된 이유에 관계없이, log_temp_files 설정에 관계없이 모든 임시 파일이 계산됩니다.
    pgsql.statsdb.temp_files 이 데이터베이스의 쿼리에 의해 생성된 임시 파일의 수와 관련된 메트릭을 제공합니다. 임시 파일이 생성된 이유(정렬이나 해시 등)에 관계없이, log_temp_files 설정에 관계없이 모든 임시 파일이 계산됩니다.
    pgsql.statsdb.tup_deleted 이 데이터베이스의 쿼리에 의해 삭제된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.tup_fetched 이 데이터베이스의 쿼리에 의해 가져온 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.tup_inserted 이 데이터베이스의 쿼리에 의해 삽입된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.tup_returned 이 데이터베이스의 쿼리에 의해 반환된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.tup_updated 이 데이터베이스의 쿼리에 의해 업데이트된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.xact_commit 커밋된 이 데이터베이스의 트랜잭션 수와 관련된 메트릭을 제공합니다.
    pgsql.statsdb.xact_rollback 롤백된 이 데이터베이스의 트랜잭션 수와 관련된 메트릭을 제공합니다.
    표 7. postgresql.metric-statsio 메트릭
    메트릭 설명
    pgsql.statsio.heap_blks_hit

    (주요 메트릭)

    		 이 테이블의 버퍼 적중 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.heap_blks_read 이 테이블에서 읽은 디스크 블록 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.idx_blks_hit 이 테이블의 모든 인덱스에 있는 버퍼 적중 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.idx_blks_read 이 테이블의 모든 인덱스에서 읽은 디스크 블록 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.tidx_blks_hit 이 테이블의 TOAST 테이블 인덱스(있는 경우)에 있는 버퍼 적중 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.tidx_blks_read 이 테이블의 TOAST 테이블 인덱스에서 읽은 디스크 블록 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.toast_blks_hit 이 테이블의 TOAST 테이블(있는 경우)에 있는 버퍼 적중 수와 관련된 메트릭을 제공합니다.
    pgsql.statsio.toast_blks_read 이 테이블의 TOAST 테이블(있는 경우)에서 읽은 디스크 블록 수와 관련된 메트릭을 제공합니다.
    표 8. postgresql.metric-statsio 메트릭
    메트릭 설명
    pgsql.statstable.idx_scan 이 테이블에서 시작된 인덱스 검사 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.idx_tup_fetch 인덱스 검사에 의해 가져온 라이브 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.n_dead_tup 예상되는 데드 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.n_live_tup 예상되는 라이브 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.n_tup_del 삭제된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.n_tup_hot_upd HOT 업데이트된 행 수와 관련된 메트릭을 제공합니다(즉 별도의 인덱스 업데이트 필요 없음).
    pgsql.statstable.n_tup_ins 삽입된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.n_tup_upd 업데이트된 행 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.seq_scan 이 테이블에서 시작된 순차적 검사 수와 관련된 메트릭을 제공합니다.
    pgsql.statstable.seq_tup_read 순차적 검사에 의해 가져온 라이브 행 수와 관련된 메트릭을 제공합니다.