| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 17. 서버의 설정 | Fast Forward | Next |
PostgreSQL는,stderr,csvlog및syslog를 포함해, 서버 메세지의 로그 취득에 대해 여러종류의 방법을 제공합니다. Windows에서는,eventlog도 동시에 제공합니다. 이 매개변수를 설정하려면 , 콤마로 분리된 필요한 로그 출력처를 기재합니다. 디폴트에서는, 로그는stderr에만 출력됩니다. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
이 매개변수를 사용하면, stderr 로 송신하는 메시지를 캡쳐하여 로그파일에 리디렉트 할 수 있습니다. 이 방법은, 즉 stderr에 로그하는 조합은 syslog에의 로그보다 더 유용합니다. 메세지의 일부의 종류가syslog에서는 출력되지 않을 가능성이 있기 때문입니다. (일반적인 예로서 다이나믹 링커의 에러 메세지가 있습니다). 이 매개변수는 서버 기동시만 설정 가능합니다.
redirect_stderr가 유효한 경우, 이 매개변수는 로그 파일이 작성되는 디렉토리를 결정합니다. 디렉토리는 절대 경로, 혹은 클러스터 데이터 디렉토리의 상대 경로로 지정될 수 있습니다. 이 매개변수는,postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
redirect_stderr가 유효한 경우, 이 매개변수는 작성된 로그 파일의 파일명을 설정합니다. 값은strftime패턴으로서 다루어지기 때문에,%이스케이프를 사용해, 시각에 의해 변동하는 파일명을 지정할 수가 있습니다. 만약 %이스케이프가 존재하지 않는 경우,PostgreSQL는 신규 로그 파일의 작성 시각을 추가합니다. 예를 들면, log_filename가server_log이면, 로그 개시시각, Sun Aug 29 19:02:33 2004 MST 에 대해, 선택된 파일명은server_log. 1093827753이 됩니다. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
logging_collector가 유효한 경우, 이 매개변수는 개개의 로그 파일의 최대 수명을을 결정합니다. 여기서 지정한 시간(분 단위) 경과하면, 새로운 로그 파일이 생성됩니다. 제로로 설정하는 것으로, 시간에 근거한 새로운 로그 파일의 생성은 무효가 됩니다. 이 매개변수는,postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
logging_collector가 유효한 경우, 이 매개변수는 개개의 로그 파일의 최대 사이즈를 결정합니다. 여기서 지정한 킬로바이트분 로그 파일에 출력된 후, 새로운 로그 파일이 생성됩니다. 제로로 설정하는 것으로, 사이즈에 근거한 새로운 로그 파일의 생성은 무효가 됩니다. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
logging_collector가 유효한 경우, 이 매개변수에 의해,PostgreSQL는 기존의 동명의 파일에 추가하는 것이 아니라, 그 파일을 절약하는 것(오버라이드 하는 것) 같게 됩니다. 그러나, 절약하고는 시간을 기본으로 한 로테이션을 위해서 신규에 파일이 열렸을 때에게만 발생해, 서버 기동시나 사이즈를 기본으로 한 로테이션에서는 발생하지 않습니다. off의 경우, 모든 경우에 대해 기존의 파일은 덧붙여 쓰여집니다. 예를 들면, 이 설정을postgresql-%H.log과 같은log_filename와 조합해 사용하면, 24시간별 로그 파일이 생성되어 그것들은 주기적으로 덧쓰게 됩니다. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인으로 설정됩니다.
예：7일간의 로그를 보존하려면, 매일의 로그를 server_log.Mon,server_log.Tue, 등으로 지명하고 자동적으로 지난주의 로그를 이번 주의 로그로 오버라이드하려면 이하와 같이 설정합니다. log_filename 를 server_log. %a로 해, log_truncate_on_rotation 를 on로 하고 log_rotation_age 를 1440으로 설정합니다.
예：24시간의 로그를 보관 유지, 1시간 간격으로 1개의 로그 파일을 작성, 다만, 로그 파일의 사이즈가 1기가바이트를 넘을 것 같은 경우 즉석에서 바꾸게 하려면 , log_filename 를 server_log. %H%M로 해, log_truncate_on_rotation 를 on로 해, log_rotation_age 를 60으로 하고, log_rotation_size 를 1000000으로 설정합니다. log_filename에%M를 포함하면, 시간의 초기 파일명과 다른 이름을 선택할 가능성이 있는, 사이즈를 바탕으로 한 로테이션을 실시할 수 있습니다.
syslog에의 로그 취득이 유효한 경우, 이 매개변수는syslog의"facility"가 사용되도록 확정합니다. LOCAL0,LOCAL1,LOCAL2,LOCAL3,LOCAL4,LOCAL5,LOCAL6,LOCAL7중에서 선택해 주세요. 디폴트는LOCAL0입니다. 사용하고 있는 시스템의syslogdemon의 문서를 동시에 참조해 주세요. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
syslog에 로그 취득이 유효한 경우, 이 매개변수는syslog로그내의PostgreSQL메세지를 특정하는데 사용하는 프로그램명을 확정합니다. 디폴트는postgres입니다. 이 매개변수는,postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정됩니다.
어느 메세지 계층을 클라이언트에 보내는지를 관리합니다. 유효한 값은,DEBUG5, DEBUG4,DEBUG3,DEBUG2, DEBUG1,LOG,NOTICE, WARNING,ERROR,FATAL, 및PANIC입니다. 각각의 계층은 거기에 계속되는 모든 계층을 포함 합니다. 계층이 후편일수록, 보다 적은 메세지가 보내집니다. 디폴트는NOTICE입니다. 여기서의LOG의 우선 순위가log_min_messages의 경우와 다른 것에 주의해 주세요.
어느 메세지 계층을 서버 로그에 기입하는지를 관리합니다. 유효한 값은 DEBUG5,DEBUG4, DEBUG3,DEBUG2,DEBUG1, INFO,NOTICE,WARNING, ERROR,LOG,FATAL, 및 PANIC입니다. 각각의 계층은 그 아래의 모든 계층을 포함합니다. 계층이 후편일수록, 보다 적은 메세지가 로그에 보내집니다. 디폴트는NOTICE입니다. 여기서의LOG의 우선 순위가client_min_messages의 경우와 다른 것에 주의해 주세요. 슈퍼 유저만 이 설정을 변경할 수 있습니다.
로그 된 각각의 메세지에 대해 서버 로그내에 기입되는 상세사항을 제어합니다. 유효한 값은,TERSE,DEFAULT, 및VERBOSE로, 각각 표시된 메세지에 필드가 추가됩니다. 슈퍼 유저만이 이 설정을 변경할 수가 있습니다.
에러 조건의 원인이 된 SQL문을 서버 로그에 기록하는지를 제어합니다. 설정한 레벨 이상의 메세지에 대해서는 현재의 SQL문이 로그에 기록됩니다. 유효한 값은,DEBUG5,DEBUG4,DEBUG3,DEBUG2,DEBUG1,INFO,NOTICE,WARNING,ERROR,LOG,FATAL,PANIC입니다. 디폴트는ERROR입니다. 에러, 로그 메세지, 치명적 에러, 패닉을 일으킨 문장이 로그에 기록되는 것을 의미합니다. 실패한 문장의 기록을 실질적으로 무효로 하려면 , 이 매개변수를PANIC로 설정해 주세요. 슈퍼 유저만이 이 옵션을 변경할 수가 있습니다.
문장의 실행에 적어도 지정한 밀리 세컨드수가 걸렸을 경우, 각각의 문장의 실행에 필요로 한 시간을 로그에 기록합니다. 0으로 설정하면, 모든 문장의 실행 시간이 출력됩니다. -1(디폴트)(은)는, 문장 실행 시간의 기록을 무효로 합니다. 예를 들면,250ms로 설정했을 경우, 250 ms 혹은 그 이상 길게 걸린 모든 SQL 명령문이 로그로서 남습니다. 이 매개변수를 유효하게 하는 것으로써, 애플리케이션으로 최적화되어 있지 않은 쿼리를 추적하는 것이 편리하게 됩니다. 슈퍼 유저만 이 설정을 변경할 수 있습니다.
확장 쿼리 프로토콜을 사용하는 클라이언트에서는, Parse, Bind, Execute 각각의 단계의 기간동안에 독립적으로 기록됩니다.
Note: 이 옵션과log_statement를 함께 사용할 때,log_statement를 위해서 기록되는 텍스트의 문장은, 실행 시간의 로그에는 반복되어 출력되지 않습니다. syslog를 사용하고 있지 않으면, 프로세스 ID와 세션 ID를 사용해, 문장 메세지와 후의 실행 시간 메세지를 연관지을 수 있도록,log_line_prefix를 사용해 PID 또는 세션 ID를 로그에 기록하는 것을 권합니다.
서버를 메세지 출력없이 실행합니다. 이 매개변수를 설정하면, 서버는 자동적으로 백그라운드에서 기동하고, 제어 단말을 떼어냅니다. 서버의 표준 출력이나 표준 에러는/dev/null에 리디렉트 되어 즉, 출력된 메세지는 모두 상실합니다. syslog로깅을 유효하게 하고 있지 않는 한, 혹은log_collector가 유효하지 않는 한, 에러 메세지를 확인할 수가 없게 되기 때문에, 이 매개변수의 사용은 권유받지 않습니다. 이 매개변수는 서버 기동시에만 설정 가능합니다.
여기에 이러한 설정에 사용된 다양한 메시지의 엄격한 레벨의 목록이 있습니다.
개발자에게 유용한 정보를 제공합니다.
VACUUM VERBOSE의 출력등의, 유저에 의해 암묵적으로 요구된 정보를 제공합니다.
유저에게 유용한 정보를 제공합니다. 예를들면, 긴 식별자를 줄이고, 주키의 일부로서 인덱스를 생성하는 것입니다.
트랜잭션 블록외에서의COMMIT의 같은, 유저에게 경고를 제공합니다.
현재의 커멘드를 중단시키는 원인이 된 에러를 보고합니다.
체크 포인트의 활동의 같은, 관리자에게 관심이 있는 정보를 보고합니다.
현재의 세션을 중단시키는 원인이 된 에러를 보고합니다.
모든 세션을 중단시키는 원인이 된 에러를 보고합니다.
이러한 매개변수는, 생성되는 각종의 디버그 출력을 유효하게 합니다. 실행된 각각의 쿼리에서는, 최종적인 파스 트리, 쿼리 리라이터의 출력, 실행 계획을 반환하여 출력합니다. debug_pretty_print는 보다 읽기 쉽고 그 표시를 인덴트 합니다만, 출력 서식이 보다 길어집니다. client_min_messages혹은log_min_messages는 각각, 실제로 출력을 클라이언트 혹은 서버 로그에 송신하기 위해서,DEBUG1 또는 그 이하로 해야 합니다. 디폴트에서는, 이러한 매개변수는 off(무효)입니다.
이것은 각각의 성공적인 접속을 세부화한 서버 로그의 행을 출력합니다. psql와 같은 클라이언트 프로그램안에는, 경로워드가 요구되면 결정까지 2회 접속을 시도하므로, 이중의"connection received"메세지는 반드시 문제를 나타내는 것이 아닙니다. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인에서 설정 가능합니다.
이것은 log_connections와 같은 서버 로그내의 행을 출력합니다. 그러나, 세션 종료시에 세션의 기간도 출력합니다. 디폴트에서는 이것은 off(무효)입니다. 이 매개변수는postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만 설정 가능합니다.
모든 완료한 문장에 대해, 그 경과시간을 로그 하게 합니다. 디폴트는off입니다. 슈퍼 유저만이 이 설정을 변경할 수 있습니다.
확장된 쿼리 프로토콜을 사용하는 클라이언트에서는, Parse, Bind, Execute 각각의 단계에서 필요로 한 시간이 독립적으로 기록됩니다.
Note: 이 옵션과log_min_duration_statement를 0으로 설정하는 방법과의 차이는,log_min_duration_statement를 초과할 경우, 텍스트판의 쿼리가 강제적으로 출력되지만, 이 옵션에서는 출력되지 않는다고 하는 점입니다. 따라서,log_duration가on, 한편,log_min_duration_statement가 양의 값을 가지는 경우, 모든 경과시간이 로그에 기록됩니다만, 경계를 넘은 문장만이 텍스트판의 쿼리를 포함할 수 있게 됩니다. 이 동작은, 고부하 설치로 통계 정보를 수집할 때에 유용합니다.
이것은, 각 로그행의 선두에 출력하는printf의 서식 문자열입니다. 디폴트는 공문자열입니다.
아래의 개요처럼 각각의 인식된 이스케이프는 대체 됩니다. 이스케이프처럼 보이는 그 밖의 것들은 무시됩니다.
다른 문자는 그대로 로그행으로 복사됩니다.
이스케이프 중에는, 세션 프로세스에 의해서만 인식 가능한 것이 있어, 이것들은 주서버 프로세스등의 백그라운드 프로세스에는 적용되지 않습니다.
Syslog는 자신의 타임 스탬프 및 프로세스 ID정보를 생성합니다.
따라서, syslog를 사용 중인 경우라면, 이스케이프의 사용을 원치 않습니다.
이 매개변수는,postgresql.conf파일내, 또는, 서버의 커멘드 라인에서만으로 설정할 수가 있습니다.
| 이스케이프 | 효과 | 세션만 |
|---|---|---|
| %u | 유저명 | ○ |
| %d | 데이터베이스명 | ○ |
| %r | 원격 호스트명, 혹은 IP주소와 포토 번호 | ○ |
| %h | 원격 호스트명, 혹은 IP주소 | ○ |
| %p | 프로세스 식별자 | × |
| %t | 밀리 세컨드 없음, 원도우상의 표준 시간대 없음 | × |
| %m | 밀리 세컨드가 있는 타임 스탬프 | × |
| %i | 커멘드 태그. 로그행을 생성한 커멘드 | ○ |
| %c | Session ID. 각 세션에 대한 유일한 식별자. 닷(점)으로 분리된 (선두에 0이 없는)24바이트 16진수의 수입니다. 수는 세션 개시시각 및 프로세스ID입니다. 따라서 이것은 이러한 항목을 출력하여 공간 절약의 방법으로 사용될 수 있습니다. | ○ |
| %l | 각 프로세스의 로그행의 번호. 1부터 시작됩니다. | × |
| %s | 세션은 타임 스탬프를 시작합니다 | ○ |
| %x | 트랜잭션 ID | ○ |
| %q | 아무것도 출력하지 않습니다. 비세션 프로세스에서는 이 이스케이프 이후의 출력을 정지합니다. 세션 프로세스에서는 무시됩니다. | × |
| %% | %문자 그 자체 | × |
어느 SQL문을 로그에 기록하는지를 제어합니다. 유효한 값은,none,ddl,mod, 및all입니다. ddl는,CREATE,ALTER, 및DROP문과 같은, 데이터 정의문을 모두 로그에 기록합니다. mod는, 모든ddl문에 가세하여INSERT,UPDATE,DELETE,TRUNCATE, 및COPY FROM과 같은, 데이터 변경문을 로그에 기록합니다. PREPARE와EXPLAIN ANALYZE커멘드도, 거기에 포함되는 커멘드가 적절한 종류이면 로그가 기록됩니다. 확장된 쿼리 프로토콜을 사용하는 클라이언트에서는, Execute 메세지를 받아들였을 때에 Bind 매개변수의 값이(모든 단일 인용부호가 이중으로 된 상태로) 포함되어 있었을 경우, 로그에 기록됩니다.
디폴트는none입니다. 슈퍼 유저만 이 설정을 변경할 수 있습니다.
Note: 로그 메세지의 발행은, 기본 해석에 의해 문장의 종류가 정해진 후에 행해지기 때문에,log_statement = all라고 하는 설정을 실시했다고 해도, 단순한 구문 에러를 가지는 문장은 기록되지 않습니다. 확장 쿼리 프로토콜의 경우도 같이 이 설정에서는 Execute 단계 이전(즉, 해석이나 계획 작성 기간)에 실패한 문장은 기록되지 않습니다. 이러한 문장의 로그를 기록하려면 ,log_min_error_statement를ERROR(또는 이하)로 설정해 주세요.
디폴트에서는, 접속 로그 메세지는 접속원호스트의 IP주소만을 표시합니다. 이 매개변수를 유효하게 하면, 호스트명도 로그에 남게 됩니다. 호스트명 해결 방법의 설정에 의존합니다만, 이것을 무시할 수 없을 만큼의 성능 패널티를 일으킬 가능성이 있는 것에 주의해 주세요. 이 매개변수는postgresql.conf파일내 또는 서버의 커멘드 라인에서만 설정 가능합니다.