27.2. 통계 수집기

PostgreSQL 통계 수집기 statistics collector는 서버 운영 상태에 대한 정보를 수집하거나 보고하기 위한 작업을 하는 백그라운드 시스템이다. 현재, 이 수집기는 테이블이나 인덱스의 디스크 블록 단위 또는 개별 로우 단위의 접근 회수를 수집할 수 있다. 또한 각 테이블에 저장 되어있는 총 로우 수를 수집하며, 각 테이블에 대한 vacuum 작업과, analyze 작업에 관한 정보들도 수집한다. 또한 사용자 정의 함수들의 호출 회수와, 그것들의 각각 총 수행 시간들도 수집한다.

또한 PostgreSQL에서는 각각 다른 서버 프로세스들이 자기가 무슨 작업을 하고 있는지에 대한 현재 상태를 살펴볼 수 있다. 이 기능은 수집기 프로세스와 별개로 제공하고 있는 기능이다.

27.2.1. 통계 수집기 환경설정

통계 자료를 수집한다는 것은 궁극적으로는 그 만큼의 추가 비용을 서버가 사용한다는 것을 의미한다. 그래서, 그 추가 비용을 얼마만큼 쓸 것인지에 대한 결정을 서버 환경변수로 제어할 수 있다. 다음은 postgresql.conf 환경설정 파일에서 사용할 수 있는 환경변수들이다. (이들에 대한 보다 자세한 부분은 18장을 참고하라.)

track_activities 설정값을 활성화하면 각각의 서버 프로세스들은 현재 자신이 하고 있는 작업을 프로세스 이름으로 보여준다.

track_counts 설정값을 활성화하면 테이블과 인덱스의 사용빈도를 통계 수집기가 수집한다.

track_functions 설정값을 활성화하면 사용자 정의 함수들의 사용빈도를 통계 수집기가 수집한다.

track_io_timing 설정값을 활성화면 블록 읽기 쓰기 회수를 통계 수집기가 수집한다.

일반적으로 이 환경설정 변수들은 postgresql.conf에서 그 값을 지정하면, 이것은 모든 서버의 프로세스들을 대상으로 작동하게 된다. 하지만, SET 명령을 이용해서, 개별 세션 단위로 이 설정값을 변경할 수도 있다. (이 작업은 일반 사용자가 악의적으로 사용될 가능성이 있기 때문에, 슈퍼유저만 사용할 수 있다.)

통계 수집기가 만든 정보는 stats_temp_directory 설정값으로 지정한 디렉토리 (초기값은 pg_stat_tmp) 안에 있는 임시파일로 저장되고, 그것을 여러 다른 PostgreSQL 프로세스들이 이용한다. 보다 나은 성능을 위해서는 이 파일의 I/O 성능을 높이기 위해 이 디렉토리를 메모리 기반 파일시스템에 두는 것도 좋은 방법이다. 이 통계 정보는 서버가 중지 될 때 pg_stat 디렉토리 쪽으로 복사하는 작업을 하기 때문에, 서버 중지, 재시작에도 자료를 그대로 유지할 수 있다.

27.2.2. 수집된 통계 정보 보기

수집된 통계 정보는 아래 표 27-1에서 나열한 여러 뷰를 통해서 살펴 볼 수 있다. 다른 방법으로는 27.2.3절에서 제공하는 여러 통계 정보 보기 함수들을 이용해서 필요한 뷰를 직접 만들어서 살펴 볼 수도 있을 것이다.

여기서 중요한 점은 살펴 보고 있는 통계 정보는 현재 데이터베이스의 정확한 현재 상태가 아니라는 점이다. 각 개별 프로세스들이 수집한 통계 정보는 그 프로세스가 아무런 작업을 하고 있지 않을 때, 수집기에게 전달한다. 즉 한 쿼리가 실행 되고 있다거나 트랜잭션 내에 있다면, 그 과정에 생긴 통계 정보들은 반영되지 않고 있다는 것이다. 또한 통계 수집기의 작업은 PGSTAT_STAT_INTERVAL (기본값은 500ms 이다) 시간 간격으로 진행된다. 즉 이 만큼의 통계 정보 오차가 발생한다. 하지만, track_activities 관련 정보는 항상 즉시 반영 된다.

또 다른 중요한 점은 한 통계 정보는 해당 뷰나, 함수로 출력할 때, 한 트랜잭션 내에서는 항상 같은 값을 출력한다. 즉, 트랜젹션이 끝날 때까지 그 값을 유지한다. 이와 비슷하게 모든 세션들의 현재 쿼리에 대한 정보도 하나의 트랜잭션 내에서는 같은 정보를 출력한다. 이것은 버그가 아니라 특성이다. 이것은 한 트랜잭션 내에서 그 통계 정보가 일정하게 유지 되도록해서 여러 다른 쿼리들에서 그 값을 일관성 있게 한다. 하지만 이것을 원치 않는다면 각 쿼리들을 트랜잭션 단위로 분리해서 작업하면 된다. 다른 방법으로 pg_stat_clear_snapshot() 함수를 사용해서, 현재 스냅숏으로 지정된 통계 정보를 버리고 새 통계 정보를 사용할 수도 있다.

하나의 트랜잭션 내에서 그 자신의 통계 정보 (아직까지 수집기 쪽으로 보내지 않은 현재 작업 내역에 대한 정보)들은 다음과 같은 뷰에서 제공한다: pg_stat_xact_all_tables, pg_stat_xact_sys_tables, pg_stat_xact_user_tables, pg_stat_xact_user_functions. 이들의 통계 정보는 현재 트랜잭션 내에서도 자신의 세션 작업에 대한 통계치를 반영 해서 다른 세션에서 수집된 정보와 자신의 세션에서 수집된 정보와 차이가 생길 수도 있다.

표 27-1. 표준 통계 정보 뷰

뷰 이름설명
pg_stat_activity 세션 프로세스들의 정보를 각각 하나의 로우로 보여준다. 이 프로세스들은 현재 서버를 사용하고는 있는 - 클라이언트가 서버로 접속 해서 만들어진 하위 서버 프로세스들이며, 이들의 현재 상태, 실행 중인 쿼리들을 살펴 볼 수 있다. 자세한 내용은 pg_stat_activity 참조.
pg_stat_bgwriter 백그라운드 라이터 프로세스의 작업 통계 정보. 자세한 내용은 pg_stat_bgwriter 참조.
pg_stat_database한 로우에 하나씩 각 데이터베이스 전역 통계 정보를 보여 준다. 자세한 내용은 pg_stat_database 참조.
pg_stat_all_tables 현재 접속한 데이터베이스에 속한 모든 테이블에 대해서 한 로우씩 그 테이블 사용에 대한 통계 정보를 보여 준다. 자세한 내용은 pg_stat_all_tables 참조.
pg_stat_sys_tablespg_stat_all_tables 내용과 같은데, 시스템 테이블에 대해서만 보여준다.
pg_stat_user_tablespg_stat_all_tables 내용과 같은데, 시스템 테이블을 제외한 현재 사용자 접근 할 수 있는 테이블에 대한 정보만 보여준다.
pg_stat_xact_all_tablespg_stat_all_tables 내용과 비슷하지만, 여기서 반영된 숫자들은 현재 트랜잭션 내에서 반영된 정보만 보여준다. (즉 pg_stat_all_tables 쪽으로 반영 되지 않은 트랜잭션 내의 정보다). 이 뷰에는 사용하는 실 로우 수, 사용하지 않는 로우(dead row) 수, vacuum과 analyze 작업에 관계된 정보는 제공하지 않는다.
pg_stat_xact_sys_tablespg_stat_xact_all_tables 내용과 같은데, 시스템 테이블에 대해서만 보여준다.
pg_stat_xact_user_tablespg_stat_xact_all_tables 내용과 같은데, 시스템 테이블을 제외한 현재 사용자가 접근 할 수 있는 테이블에 대해서만 보여준다.
pg_stat_all_indexes 현재 접속한 데이터베이스에 속한 모든 인덱스에 대해서 한 로우씩 그 인덱스 사용에 대한 통계 정보를 보여 준다. 자세한 내용은 pg_stat_all_indexes 참조.
pg_stat_sys_indexespg_stat_all_indexes 내용과 같은데, 시스템 인덱스에 대해서만 보여준다.
pg_stat_user_indexespg_stat_all_indexes 내용과 같은데, 시스템 인덱스를 제외한 현재 사용자가 접근 할 수 있는 인덱스에 대해서만 보여준다.
pg_statio_all_tables 현재 접속한 데이터베이스에 속한 모든 테이블에 대해서 한 로우씩 그 테이블에 대한 I/O 통계 정보를 보여 준다. 자세한 내용은 pg_statio_all_tables 참조.
pg_statio_sys_tablespg_statio_all_tables 내용과 같은데, 시스템 테이블에 대해서만 보여준다.
pg_statio_user_tablespg_statio_all_tables 내용과 같은데, 시스템 테이블을 제외한 현재 사용자가 접근 할 수 있는 테이블에 대해서만 보여준다.
pg_statio_all_indexes 현재 접속한 데이터베이스에 속한 모든 인덱스에 대해서 한 로우씩 그 인덱스에 대한 I/O 통계 정보를 보여 준다. 자세한 내용은 pg_statio_all_indexes 참조.
pg_statio_sys_indexespg_statio_all_indexes 내용과 같은데, 시스템 인덱스에 대해서만 보여준다.
pg_statio_user_indexespg_statio_all_indexes 내용과 같은데, 시스템 인덱스를 제외한 현재 사용자가 접근 할 수 있는 인덱스에 대해서만 보여준다.
pg_statio_all_sequences 현재 접속한 데이터베이스에 속한 모든 시퀀스에 대해서 한 로우씩 그 시퀀스에 대한 I/O 통계 정보를 보여 준다. 자세한 내용은 pg_statio_all_sequences 참조.
pg_statio_sys_sequencespg_statio_all_sequences 내용과 같은데, 시스템 시퀀스에 대해서만 보여준다. (현재 사용하고 있는 시스템 시퀀스가 없음으로 이 뷰는 항상 그 내용이 비어있을 것이다.)
pg_statio_user_sequencespg_statio_all_sequences 내용과 같은데, 시스템 시퀀스를 제외한 현재 사용자가 접근 할 수 있는 시퀀스에 대해서만 보여준다.
pg_stat_user_functions 현재 데이터베이스에 만들어진 사용자 정의 함수들의 실행에 대한 통계 정보를 보여준다. 자세한 내용은 pg_stat_user_functions 참조.
pg_stat_xact_user_functionspg_stat_user_functions 내용과 비슷하지만, 여기서 반영된 숫자들은 현재 트랜잭션 내에서 반영된 정보만 보여준다, (즉 pg_stat_user_functions 쪽으로 반영 되지 않은 트랜잭션 내의 정보다).
pg_stat_replication 하나의 WAL 송신 프로세스에 대해서 하나의 로우로, 대기 서버 쪽으로 보내는 리플리케이션 작업에 대한 통계 정보를 보여준다. 자세한 내용은 pg_stat_replication 참조.
pg_stat_database_conflicts 하나의 데이터베이스에서 그 전역에 걸쳐 발생한 대기 서버 복제 작업 충돌에 의한 쿼리 실행 실패 통계 정보를 각각 하나의 로우로 보여준다. 자세한 내용은 pg_stat_database_conflicts 참조.

인덱스 별 통계 정보는 어느 인덱스가 많이 사용되며, 어떻게 영향을 미치는 지를 조사하는데 특히 유용하게 쓰인다.

pg_statio_ 뷰들은 공유 버퍼의 사용 빈도를 파악하는데 가장 기본이 되는 것들이다. 이상적인 서버 운영 모습은 디스크 읽기 빈도 보다 공유 버퍼를 사용하는(buffer hit) 빈도가 훨씬 높아서, 대부분의 작업이 커널 호출 작업 없이 이루워 지도록 하는 것이다. 한편, PostgreSQL 에서는 단지 이 서버 기준으로 디스크를 읽은 것과 서버의 공유 버퍼를 사용한 것에 대한 정보만 제공 할 뿐이다. 즉, 커널의 I/O 캐시 사용 빈도에 대해서는 제공하지 않는다. 다시 말하면, 정말 디스크를 읽은 것인지, OS의 I/O 캐시를 사용한 것인지는 이 뷰를 통해서는 알 수 없다. 이런 세세한 부분까지 살펴 보려면, OS 관련 도구들을 이용해야 할 것이다.

표 27-2. pg_stat_activity

칼럼자료형설명
datidoidOID of the database this backend is connected to
datnamenameName of the database this backend is connected to
pidintegerProcess ID of this backend
usesysidoidOID of the user logged into this backend
usenamenameName of the user logged into this backend
application_nametextName of the application that is connected to this backend
client_addrinetIP address of the client connected to this backend. If this field is null, it indicates either that the client is connected via a Unix socket on the server machine or that this is an internal process such as autovacuum.
client_hostnametextHost name of the connected client, as reported by a reverse DNS lookup of client_addr. This field will only be non-null for IP connections, and only when log_hostname is enabled.
client_portintegerTCP port number that the client is using for communication with this backend, or -1 if a Unix socket is used
backend_starttimestamp with time zoneTime when this process was started, i.e., when the client connected to the server
xact_starttimestamp with time zoneTime when this process' current transaction was started, or null if no transaction is active. If the current query is the first of its transaction, this column is equal to the query_start column.
query_starttimestamp with time zoneTime when the currently active query was started, or if state is not active, when the last query was started
state_changetimestamp with time zoneTime when the state was last changed
waitingbooleanTrue if this backend is currently waiting on a lock
statetextCurrent overall state of this backend. Possible values are:

  • active: The backend is executing a query.

  • idle: The backend is waiting for a new client command.

  • idle in transaction: The backend is in a transaction, but is not currently executing a query.

  • idle in transaction (aborted): This state is similar to idle in transaction, except one of the statements in the transaction caused an error.

  • fastpath function call: The backend is executing a fast-path function.

  • disabled: This state is reported if track_activities is disabled in this backend.

querytextText of this backend's most recent query. If state is active this field shows the currently executing query. In all other states, it shows the last query that was executed.

The pg_stat_activity view will have one row per server process, showing information related to the current activity of that process.

참고: The waiting and state columns are independent. If a backend is in the active state, it may or may not be waiting. If the state is active and waiting is true, it means that a query is being executed, but is being blocked by a lock somewhere in the system.

표 27-3. pg_stat_bgwriter

칼럼자료형설명
checkpoints_timedbigintcheckpoint_timeout 환경 설정값에 따른 체크 포인트 작업 회수
checkpoints_reqbigint체크포인트 명령이 수행되어 진행한 작업 회수
checkpoint_write_timedouble precision 체크포인트 작업으로 발생한 디스크 쓰기 작업의 밀리세컨드 총 시간.
checkpoint_sync_timedouble precision 체크포인트 작업으로 발생할 디스크 쓰기에 대한 디스크 동기화 작업(fsync)에 소요된 밀리세컨드 총 시간.
buffers_checkpointbigintcheckpointer 프로세스가 기록한 총 버퍼 수
buffers_cleanbigintwriter 프로세스가 기록한 총 버퍼 수
maxwritten_cleanbigintwriter 프로세스가 기록해야 할 버퍼수가 bgwriter_lru_maxpages 환경 설정값보다 많아서 작업이 중지된 회수
buffers_backendbigint백엔드(세션) 프로세스가 직접 기록한 총 버퍼 수
buffers_backend_fsyncbigint백엔드(세션) 프로세스가 직접 fsync 작업을 한 회수 (일반적으로 백엔드(세션) 프로세스가 공유 버퍼를 디스크로 내려 쓰더라도, 이 동기화 작업은 writer 프로세스가 담당한다. 즉 writer 프로세스의 fsync 작업 부하량을 파악하는데 도움이 됨 - 옮긴이)
buffers_allocbigintNumber of buffers allocated
stats_resettimestamp with time zone이 통계값들이 초기화 된 시각

pg_stat_bgwriter 뷰는 항상 한 개의 로우만 보여준다. 이 자료는 데이터클러스터 전역 정보다.

표 27-4. pg_stat_database View

칼럼자료형설명
datidoidOID of a database
datnamenameName of this database
numbackendsintegerNumber of backends currently connected to this database. This is the only column in this view that returns a value reflecting current state; all other columns return the accumulated values since the last reset.
xact_commitbigintNumber of transactions in this database that have been committed
xact_rollbackbigintNumber of transactions in this database that have been rolled back
blks_readbigintNumber of disk blocks read in this database
blks_hitbigintNumber of times disk blocks were found already in the buffer cache, so that a read was not necessary (this only includes hits in the PostgreSQL buffer cache, not the operating system's file system cache)
tup_returnedbigintNumber of rows returned by queries in this database
tup_fetchedbigintNumber of rows fetched by queries in this database
tup_insertedbigintNumber of rows inserted by queries in this database
tup_updatedbigintNumber of rows updated by queries in this database
tup_deletedbigintNumber of rows deleted by queries in this database
conflictsbigintNumber of queries canceled due to conflicts with recovery in this database. (Conflicts occur only on standby servers; see pg_stat_database_conflicts for details.)
temp_filesbigintNumber of temporary files created by queries in this database. All temporary files are counted, regardless of why the temporary file was created (e.g., sorting or hashing), and regardless of the log_temp_files setting.
temp_bytesbigintTotal amount of data written to temporary files by queries in this database. All temporary files are counted, regardless of why the temporary file was created, and regardless of the log_temp_files setting.
deadlocksbigintNumber of deadlocks detected in this database
blk_read_timedouble precisionTime spent reading data file blocks by backends in this database, in milliseconds
blk_write_timedouble precisionTime spent writing data file blocks by backends in this database, in milliseconds
stats_resettimestamp with time zoneTime at which these statistics were last reset

The pg_stat_database view will contain one row for each database in the cluster, showing database-wide statistics.

표 27-5. pg_stat_all_tables View

칼럼자료형설명
relidoidOID of a table
schemanamenameName of the schema that this table is in
relnamenameName of this table
seq_scanbigintNumber of sequential scans initiated on this table
seq_tup_readbigintNumber of live rows fetched by sequential scans
idx_scanbigintNumber of index scans initiated on this table
idx_tup_fetchbigintNumber of live rows fetched by index scans
n_tup_insbigintNumber of rows inserted
n_tup_updbigintNumber of rows updated
n_tup_delbigintNumber of rows deleted
n_tup_hot_updbigintNumber of rows HOT updated (i.e., with no separate index update required)
n_live_tupbigintEstimated number of live rows
n_dead_tupbigintEstimated number of dead rows
last_vacuumtimestamp with time zoneLast time at which this table was manually vacuumed (not counting VACUUM FULL)
last_autovacuumtimestamp with time zoneLast time at which this table was vacuumed by the autovacuum daemon
last_analyzetimestamp with time zoneLast time at which this table was manually analyzed
last_autoanalyzetimestamp with time zoneLast time at which this table was analyzed by the autovacuum daemon
vacuum_countbigintNumber of times this table has been manually vacuumed (not counting VACUUM FULL)
autovacuum_countbigintNumber of times this table has been vacuumed by the autovacuum daemon
analyze_countbigintNumber of times this table has been manually analyzed
autoanalyze_countbigintNumber of times this table has been analyzed by the autovacuum daemon

The pg_stat_all_tables view will contain one row for each table in the current database (including TOAST tables), showing statistics about accesses to that specific table. The pg_stat_user_tables and pg_stat_sys_tables views contain the same information, but filtered to only show user and system tables respectively.

표 27-6. pg_stat_all_indexes View

칼럼자료형설명
relidoidOID of the table for this index
indexrelidoidOID of this index
schemanamenameName of the schema this index is in
relnamenameName of the table for this index
indexrelnamenameName of this index
idx_scanbigintNumber of index scans initiated on this index
idx_tup_readbigintNumber of index entries returned by scans on this index
idx_tup_fetchbigintNumber of live table rows fetched by simple index scans using this index

The pg_stat_all_indexes view will contain one row for each index in the current database, showing statistics about accesses to that specific index. The pg_stat_user_indexes and pg_stat_sys_indexes views contain the same information, but filtered to only show user and system indexes respectively.

Indexes can be used via either simple index scans or "bitmap" index scans. In a bitmap scan the output of several indexes can be combined via AND or OR rules, so it is difficult to associate individual heap row fetches with specific indexes when a bitmap scan is used. Therefore, a bitmap scan increments the pg_stat_all_indexes.idx_tup_read count(s) for the index(es) it uses, and it increments the pg_stat_all_tables.idx_tup_fetch count for the table, but it does not affect pg_stat_all_indexes.idx_tup_fetch.

참고: The idx_tup_read and idx_tup_fetch counts can be different even without any use of bitmap scans, because idx_tup_read counts index entries retrieved from the index while idx_tup_fetch counts live rows fetched from the table. The latter will be less if any dead or not-yet-committed rows are fetched using the index, or if any heap fetches are avoided by means of an index-only scan.

표 27-7. pg_statio_all_tables View

칼럼자료형설명
relidoidOID of a table
schemanamenameName of the schema that this table is in
relnamenameName of this table
heap_blks_readbigintNumber of disk blocks read from this table
heap_blks_hitbigintNumber of buffer hits in this table
idx_blks_readbigintNumber of disk blocks read from all indexes on this table
idx_blks_hitbigintNumber of buffer hits in all indexes on this table
toast_blks_readbigintNumber of disk blocks read from this table's TOAST table (if any)
toast_blks_hitbigintNumber of buffer hits in this table's TOAST table (if any)
tidx_blks_readbigintNumber of disk blocks read from this table's TOAST table index (if any)
tidx_blks_hitbigintNumber of buffer hits in this table's TOAST table index (if any)

The pg_statio_all_tables view will contain one row for each table in the current database (including TOAST tables), showing statistics about I/O on that specific table. The pg_statio_user_tables and pg_statio_sys_tables views contain the same information, but filtered to only show user and system tables respectively.

표 27-8. pg_statio_all_indexes View

칼럼자료형설명
relidoidOID of the table for this index
indexrelidoidOID of this index
schemanamenameName of the schema this index is in
relnamenameName of the table for this index
indexrelnamenameName of this index
idx_blks_readbigintNumber of disk blocks read from this index
idx_blks_hitbigintNumber of buffer hits in this index

The pg_statio_all_indexes view will contain one row for each index in the current database, showing statistics about I/O on that specific index. The pg_statio_user_indexes and pg_statio_sys_indexes views contain the same information, but filtered to only show user and system indexes respectively.

표 27-9. pg_statio_all_sequences View

칼럼자료형설명
relidoidOID of a sequence
schemanamenameName of the schema this sequence is in
relnamenameName of this sequence
blks_readbigintNumber of disk blocks read from this sequence
blks_hitbigintNumber of buffer hits in this sequence

The pg_statio_all_sequences view will contain one row for each sequence in the current database, showing statistics about I/O on that specific sequence.

표 27-10. pg_stat_user_functions View

칼럼자료형설명
funcidoidOID of a function
schemanamenameName of the schema this function is in
funcnamenameName of this function
callsbigintNumber of times this function has been called
total_timedouble precisionTotal time spent in this function and all other functions called by it, in milliseconds
self_timedouble precisionTotal time spent in this function itself, not including other functions called by it, in milliseconds

The pg_stat_user_functions view will contain one row for each tracked function, showing statistics about executions of that function. The track_functions parameter controls exactly which functions are tracked.

표 27-11. pg_stat_replication View

칼럼자료형설명
pidintegerProcess ID of a WAL sender process
usesysidoidOID of the user logged into this WAL sender process
usenamenameName of the user logged into this WAL sender process
application_nametextName of the application that is connected to this WAL sender
client_addrinetIP address of the client connected to this WAL sender. If this field is null, it indicates that the client is connected via a Unix socket on the server machine.
client_hostnametextHost name of the connected client, as reported by a reverse DNS lookup of client_addr. This field will only be non-null for IP connections, and only when log_hostname is enabled.
client_portintegerTCP port number that the client is using for communication with this WAL sender, or -1 if a Unix socket is used
backend_starttimestamp with time zoneTime when this process was started, i.e., when the client connected to this WAL sender
statetextCurrent WAL sender state
sent_locationtextLast transaction log position sent on this connection
write_locationtextLast transaction log position written to disk by this standby server
flush_locationtextLast transaction log position flushed to disk by this standby server
replay_locationtextLast transaction log position replayed into the database on this standby server
sync_priorityintegerPriority of this standby server for being chosen as the synchronous standby
sync_statetextSynchronous state of this standby server

The pg_stat_replication view will contain one row per WAL sender process, showing statistics about replication to that sender's connected standby server. Only directly connected standbys are listed; no information is available about downstream standby servers.

표 27-12. pg_stat_database_conflicts View

칼럼자료형설명
datidoidOID of a database
datnamenameName of this database
confl_tablespacebigintNumber of queries in this database that have been canceled due to dropped tablespaces
confl_lockbigintNumber of queries in this database that have been canceled due to lock timeouts
confl_snapshotbigintNumber of queries in this database that have been canceled due to old snapshots
confl_bufferpinbigintNumber of queries in this database that have been canceled due to pinned buffers
confl_deadlockbigintNumber of queries in this database that have been canceled due to deadlocks

The pg_stat_database_conflicts view will contain one row per database, showing database-wide statistics about query cancels occurring due to conflicts with recovery on standby servers. This view will only contain information on standby servers, since conflicts do not occur on master servers.

27.2.3. 통계 함수들

위에서 소개한 뷰를 통해서 서버 통계 정보를 살펴보는 방법과 함께 또 다른 한 방법은 각각의 정보를 제공하는 함수를 사용하는 방법이다. 위에서 소개한 뷰들의 뷰 정의를 살펴보면, 각각의 뷰가 어떤 함수들을 사용하는지 알 수 있다. (예를 들면, psql 에서 \d+ pg_stat_activity 명령을 사용하면 된다.) 데이터베이스 단위로 통계 정보를 보여주는 함수들에 대해서는 함수의 입력 인자로 데이터베이스 OID를 입력해야 한다. 이처럼, 테이블별, 인덱스별, 함수별 통계 정보를 살펴보려면, 그 각 객체의 OID를 입력 인자로 사용하면 된다. 기억해야 할 점은, 테이블, 인덱스, 함수 같은 각 데이터베이스 소속 객체들을 입력 인자로 쓰는 함수라면, 그 데이터베이스는 현재 접속한 데이터베이스가 된다.

부가적으로 제공하는 통계 관련 함수들은 표 27-13에서 소개한다.

표 27-13. 부가 통계 함수들

함수이름리턴 자료형설명
pg_backend_pid()integer Process ID of the server process handling the current session
pg_stat_get_activity(integer)setof record Returns a record of information about the backend with the specified PID, or one record for each active backend in the system if NULL is specified. The fields returned are a subset of those in the pg_stat_activity view.
pg_stat_clear_snapshot()void Discard the current statistics snapshot
pg_stat_reset()void Reset all statistics counters for the current database to zero (requires superuser privileges)
pg_stat_reset_shared(text)void Reset some cluster-wide statistics counters to zero, depending on the argument (requires superuser privileges). Calling pg_stat_reset_shared('bgwriter') will zero all the counters shown in the pg_stat_bgwriter view.
pg_stat_reset_single_table_counters(oid)void Reset statistics for a single table or index in the current database to zero (requires superuser privileges)
pg_stat_reset_single_function_counters(oid)void Reset statistics for a single function in the current database to zero (requires superuser privileges)

pg_stat_activity 뷰에서 사용되는 pg_stat_get_activity 함수는 지정한 한 세션의 현재 상태에 대한 모든 정보를 레코드 자료형으로 리턴한다. 이렇게, 가끔은 뷰보다, 함수를 직접 사용하는 것이 보다 유용할 때가 있다. 위에서 소개한 뷰들(표 27-14)은 함수를 호출하고 그것을 뷰로 보여주기 때문에, 뷰를 내용으로 출력 되는 결과는 이미 지난 자료 집합이다 보다 정확한 현재 상태를 파악 하고자 할 때, 이런 함수를 직접 사용하는 방법이 좋다. 한 예제를 소개하면, 다음은, 현재 접속해 있는 세션들의 PID와 현재 실행 중인 쿼리 내용을 보는 쿼리다:

SELECT pg_stat_get_backend_pid(s.backendid) AS pid,
       pg_stat_get_backend_activity(s.backendid) AS query
    FROM (SELECT pg_stat_get_backend_idset() AS backendid) AS s;

표 27-14. 백엔드 단위 통계 함수들

함수이름리턴 자료형설명
pg_stat_get_backend_idset()setof integerSet of currently active backend ID numbers (from 1 to the number of active backends)
pg_stat_get_backend_activity(integer)textText of this backend's most recent query
pg_stat_get_backend_activity_start(integer)timestamp with time zoneTime when the most recent query was started
pg_stat_get_backend_client_addr(integer)inetIP address of the client connected to this backend
pg_stat_get_backend_client_port(integer)integerTCP port number that the client is using for communication
pg_stat_get_backend_dbid(integer)oidOID of the database this backend is connected to
pg_stat_get_backend_pid(integer)integerProcess ID of this backend
pg_stat_get_backend_start(integer)timestamp with time zoneTime when this process was started
pg_stat_get_backend_userid(integer)oidOID of the user logged into this backend
pg_stat_get_backend_waiting(integer)booleanTrue if this backend is currently waiting on a lock
pg_stat_get_backend_xact_start(integer)timestamp with time zoneTime when the current transaction was started