포스트그레SQL지원 다음을 포함하여 서버 메시지를 기록하는 여러 가지 방법stderr, csvlog그리고syslog. 윈도우에서는,이벤트로그또한 지원됩니다. 이것을 설정하세요 매개변수를 원하는 로그 대상 목록으로 구분하여 지정 쉼표로. 기본값은 다음에 로그인하는 것입니다.stderr전용. 이 매개변수는 에서 설정하세요.postgresql.conf파일 또는 서버 명령줄에서.
만약csvlog포함됨 에서log_destination, 로그 항목 다음으로 출력됩니다."쉼표로 구분됨 값"로드에 편리한 형식입니다. 프로그램으로 변환합니다. 참조섹션 18.7.4자세한 내용은.logging_collector활성화되어야 합니다. CSV 형식의 로그 출력을 생성합니다.
참고:대부분의 Unix 시스템에서는 다음이 필요합니다. 시스템 구성을 변경하려면syslog데몬 있음 를 활용하기 위해syslog옵션log_destination. 포스트그레SQL로그인할 수 있음syslog시설LOCAL0통해LOCAL7(참조syslog_facility), 하지만 기본값syslog대부분의 구성 플랫폼은 그러한 메시지를 모두 삭제합니다. 당신은 것입니다 다음과 같은 것을 추가해야 합니다.
local0.* /var/log/postgresql에syslog데몬의 구성 파일이 작동하도록 합니다.
이 매개변수는 메시지를 다음으로 보낼 수 있습니다.stderr및 CSV 형식의 로그 출력, 캡처되어 로그 파일로 리디렉션됩니다. 이 접근 방식은 로그인보다 더 유용한 경우가 많습니다.syslog, 일부 유형 이후 의 메시지가 다음에 표시되지 않을 수 있습니다.syslog출력(일반적인 예는 다음과 같습니다. 동적 링커 실패 메시지). 이 매개변수는 서버 시작 시 설정됩니다.
언제logging_collector이다 활성화된 경우 이 매개변수는 로그 파일이 생성됩니다. 다음과 같이 지정할 수 있습니다. 절대 경로 또는 클러스터 데이터 디렉터리에 대한 상대 경로입니다. 이 매개변수는에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버에 명령줄.
언제logging_collector이다 활성화된 경우 이 매개변수는 로그 파일을 생성했습니다. 값은 다음과 같이 처리됩니다.strftime패턴, 그래서%-이스케이프를 사용하여 지정할 수 있습니다. 시간에 따라 변하는 파일 이름. (혹시나 있다면 참고하세요 시간대에 따라 다름%-탈출, 계산은 다음으로 지정된 영역에서 수행됩니다.log_timezone.) 그렇지 않은 경우%-이스케이프가 존재합니다.PostgreSQL추가됩니다 새 로그 파일이 생성된 시점입니다. 에 대한 예를 들어, 만약log_filename있었다서버_로그, 선택한 파일 이름은 다음과 같습니다.server_log.1093827753로그 시작용 2004년 8월 29일 일요일 19:02:33 MST. 이 매개변수는 에서 설정하세요.postgresql.conf파일 또는 서버 명령줄에서.
CSV 형식 출력이 활성화된 경우log_destination, .csv타임스탬프에 추가됩니다. CSV 형식의 파일 이름을 생성하기 위한 로그 파일 이름 출력. (만약에log_filename다음으로 끝남.log, 접미사가 대체됩니다. 대신.) 위의 예의 경우 CSV 파일은 이름은 다음과 같습니다server_log.1093827753.csv.
언제logging_collector이다 활성화하면 이 매개변수가 최대 수명을 결정합니다. 개별 로그 파일의 이 시간이 지나면 시간이 지나면 새 로그 파일이 생성됩니다. 0으로 설정 새 로그 파일의 시간 기반 생성을 비활성화합니다. 이 매개변수는에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버에 명령줄.
언제logging_collector이다 활성화된 경우 이 매개변수는 개별 로그 파일. 이 수 킬로바이트가 지난 후 로그 파일로 내보내지면 새 로그 파일이 생성됩니다. 새 로그의 크기 기반 생성을 비활성화하려면 0으로 설정하십시오. 파일. 이 매개변수는에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버에 명령줄.
언제logging_collector이다 활성화하면 이 매개변수로 인해PostgreSQL잘라내기(덮어쓰기), 추가하는 대신 동일한 기존 로그 파일에 이름. 그러나 잘림은 새 파일이 있는 경우에만 발생합니다. 동안이 아닌 시간 기반 순환으로 인해 열리는 중입니다. 서버 시작 또는 크기 기반 회전. 꺼져 있을 때, 모든 경우에 기존 파일이 추가됩니다. 에 대한 예를 들어 이 설정을 a와 함께 사용하면log_filename좋아요postgresql-%H.log다음과 같은 결과가 나올 것입니다 24시간 단위 로그 파일을 생성한 다음 주기적으로 덮어씁니다. 이 매개변수는 에 설정postgresql.conf파일 또는 서버 명령줄에서.
예: 7일의 로그를 보관하려면 하루에 하나의 로그 파일 명명된server_log.Mon, server_log.Tue등 자동으로 지난주 로그를 이번주 로그로 덮어쓰기, setlog_filename에서버_로그.%a, log_truncate_on_rotation에켜짐및log_rotation_age에1440.
예: 24시간 동안 로그를 보관하려면 각 로그 파일 하나 시간이지만 로그 파일 크기가 초과되면 더 빨리 회전됩니다. 1GB, 세트log_filename에서버_로그.%H%M, log_truncate_on_rotation에켜짐, log_rotation_age에60및log_rotation_size에1000000. 포함%Min로그_파일이름모든 크기 기반 허용 파일 이름을 선택하기 위해 발생할 수 있는 회전 해당 시간의 초기 파일 이름과 다릅니다.
로그인할 때syslog활성화되어 있으면 이 매개변수 를 결정합니다syslog "시설"사용됩니다. 당신은 할 수 있습니다 중에서 선택하세요LOCAL0, LOCAL1, 로컬2, LOCAL3, LOCAL4, LOCAL5, LOCAL6, LOCAL7; 기본값은LOCAL0. 또한 귀하의 문서를 참조하십시오 시스템의syslog데몬. 이 매개변수는에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버에 명령줄. 이 매개변수는 서버는 syslog를 지원하도록 컴파일되었습니다.
로그인할 때syslog이 활성화되어 있으며 이 매개변수는 식별하는 데 사용되는 프로그램 이름을 결정합니다.PostgreSQL메시지syslog로그. 기본값은포스트그레스. 이 매개변수는 에만 설정되어야 합니다.postgresql.conf파일 또는 서버에 명령줄. 이 매개변수는 서버는 syslog를 지원하도록 컴파일됩니다.
클라이언트에 전송되는 메시지 수준을 제어합니다. 유효한 값은 다음과 같습니다.디버그5, 디버그4, 디버그3, 디버그2, 디버그1, 로그, 공지, 경고, 토토 핫, 치명적및패닉. 각 레벨에는 모든 것이 포함됩니다. 그것을 따르는 수준. 레벨이 높아질수록 적어집니다 메시지가 전송됩니다. 기본값은공지. 참고하세요로그여기와 순위가 다릅니다log_min_messages.
어떤 메시지 수준이 기록되는지 제어합니다. 서버 로그. 유효한 값은 다음과 같습니다.디버그5, 디버그4, 디버그3, 디버그2, 디버그1, 정보, 공지, 경고, 토토 핫, 로그, 치명적및패닉. 각 레벨에는 모든 것이 포함됩니다. 그것을 따르는 수준. 레벨이 높아질수록 적어집니다 메시지가 로그로 전송됩니다. 기본값은공지. 참고하세요로그여기는 여기와 순위가 다릅니다client_min_messages. 만 슈퍼유저는 이 설정을 변경할 수 있습니다.
서버에 기록된 세부사항의 양을 제어합니다 기록된 각 메시지를 기록합니다. 유효한 값은 다음과 같습니다.TERSE, 기본값및상세, 각각 더 많은 필드를 추가합니다. 표시된 메시지. 슈퍼유저만 이를 변경할 수 있습니다. 설정.
SQL 문이 원인이 되는지 여부를 제어합니다. 토토 핫 조건은 서버 로그에 기록됩니다. 현재 SQL 문이 로그 항목에 포함됩니다. 지정된 심각도 이상의 메시지에 대해. 유효한 값은 다음과 같습니다.디버그5, 디버그4, 디버그3, 디버그2, 디버그1, 정보, 공지, 경고, 토토 핫, 로그, 치명적그리고패닉. 기본값은토토 핫은 다음을 발생시키는 명령문을 의미합니다. 토토 핫, 로그 메시지, 치명적인 토토 핫 또는 패닉이 발생합니다. 기록되었습니다. 실패 로깅을 효과적으로 끄려면 문에서 이 매개변수를 다음으로 설정합니다.패닉. 슈퍼유저만 이를 변경할 수 있습니다. 설정.
각 완성된 문장의 지속 시간은 다음과 같습니다. 명령문이 최소한 지정된 기간 동안 실행된 경우 기록됩니다. 밀리초 수입니다. 이것을 0으로 설정하면 모두 인쇄됩니다. 진술 기간. 마이너스 1(기본값) 비활성화 로깅 문 기간. 예를 들어 이렇게 설정하면 에250ms그 다음 모든 SQL 문 250ms 이상 실행되는 경우 기록됩니다. 이것을 활성화하면 매개변수는 최적화되지 않은 항목을 추적하는 데 도움이 될 수 있습니다. 귀하의 응용 프로그램에서 쿼리합니다. 슈퍼유저만 변경할 수 있습니다. 이 설정입니다.
확장 쿼리 프로토콜을 사용하는 클라이언트의 경우 기간 구문 분석, 바인딩 및 실행 단계가 기록됩니다. 독립적으로.
참고:이 옵션을 다음과 함께 사용할 때log_statement, 다음으로 인해 기록된 문의 텍스트입니다.log_statement않을 것입니다 기간 로그 메시지에서 반복됩니다. 당신이 그렇지 않다면 사용 중syslog, 그렇죠 다음을 사용하여 PID 또는 세션 ID를 기록하는 것이 좋습니다.log_line_prefix그래서 당신은 명령문 메시지를 프로세스 ID를 사용하는 이후 기간 메시지 또는 세션 ID.
서버를 자동으로 실행합니다. 이 매개변수가 설정된 경우, 서버는 백그라운드에서 자동으로 실행되며 제어 터미널이 연결 해제되었습니다. 서버의 표준 출력 및 표준 토토 핫는 다음으로 리디렉션됩니다./dev/null, 전송된 메시지는 모두 그들에게는 상실될 것이다. 그렇지 않은 경우syslog로깅이 선택되었거나logging_collector활성화되었습니다. 이 매개변수를 사용하는 것은 권장되지 않습니다. 토토 핫 메시지를 볼 수 없습니다. 이 매개변수는 서버 시작 시 설정됩니다.
테이블 18-1에서 사용하는 메시지 심각도 수준을 설명합니다.PostgreSQL. 출력을 로깅하는 경우 으로 전송됩니다.syslog또는 Windows'이벤트로그, 심각도 수준 표에 표시된 대로 번역됩니다.
표 18-1. 메시지 심각도 수준
| 심각도 | 사용법 | syslog | 이벤트로그 |
|---|---|---|---|
| DEBUG1..DEBUG5 | 다음에 대해 연속적으로 더 자세한 정보를 제공합니다. 개발자가 사용합니다. | 디버그 | 정보 |
| 정보 | 암시적으로 요청한 정보를 제공합니다. 사용자(예: 출력)진공 장황한. | 정보 | 정보 |
| 공지 | 다음에 도움이 될 수 있는 정보를 제공합니다. 사용자(예: 긴 문자 잘림 알림) 식별자. | 공지 | 정보 |
| 경고 | 발생할 수 있는 문제에 대한 경고를 제공합니다. 예:커밋트랜잭션 외부 차단합니다. | 공지 | 경고 |
| 토토 핫 | 현재 명령을 발생시킨 토토 핫를 보고합니다. 중단합니다. | 경고 | 토토 핫 |
| 로그 | 관리자에게 관심 있는 정보를 보고합니다. 예: 체크포인트 활동. | 정보 | 정보 |
| 치명적 | 현재 세션을 발생시킨 토토 핫를 보고합니다. 중단합니다. | ERR | 토토 핫 |
| 패닉 | 모든 데이터베이스 세션을 유발한 토토 핫를 보고합니다. 중단합니다. | 크리티컬 | 토토 핫 |
이 매개변수는 다양한 디버깅 출력을 가능하게 합니다. 방출됩니다. 실행된 각 쿼리에 대해 다음을 인쇄합니다. 결과 구문 분석 트리, 쿼리 재작성기 출력 또는 실행 계획입니다.debug_pretty_print이 디스플레이를 들여쓰기합니다. 더 읽기 쉽지만 훨씬 더 긴 출력 형식을 생성합니다.client_min_messages또는log_min_messages반드시디버그134189_34333
체크포인트가 서버 로그에 기록되도록 합니다. 각 체크포인트에 대한 일부 통계는 작성된 버퍼 수를 포함한 로그 메시지 그것들을 쓰는 데 소요된 시간. 이 매개변수는 에 설정postgresql.conf파일 또는 서버 명령줄에서. 기본값은 꺼져 있습니다.
서버에 연결을 시도할 때마다 기록되었으며 클라이언트가 성공적으로 완료되었습니다. 인증. 이 매개변수는에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버 명령줄. 기본값은 꺼져 있습니다.
참고:일부 클라이언트 프로그램, 다음과 같은psql, 시도 비밀번호가 맞는지 확인하는 동안 두 번 연결하세요. 필수이므로 중복됩니다."연결 수신됨"메시지는 그렇지 않습니다 반드시 문제가 있음을 나타냅니다.
이것은 서버 로그에 다음과 유사한 줄을 출력합니다.log_connections그러나 세션 중 종료 및 세션 기간을 포함합니다. 이는 기본적으로 꺼져 있습니다. 이 매개변수는 다음에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버 명령줄.
완성된 모든 문장의 지속 시간을 기록되었습니다. 기본값은꺼짐. 만 슈퍼유저는 이 설정을 변경할 수 있습니다.
확장 쿼리 프로토콜을 사용하는 클라이언트의 경우 기간 구문 분석, 바인딩 및 실행 단계가 기록됩니다. 독립적으로.
참고:이 설정의 차이점은 옵션 및 설정log_min_duration_statement0으로 하는 것은 초과log_min_duration_statement강제 기록할 쿼리의 텍스트이지만 이 옵션은 그렇지 않습니다. 따라서 만일log_durationis켜짐그리고log_min_duration_statement이 있습니다 양수 값이면 모든 기간이 기록되지만 쿼리 텍스트는 다음을 초과하는 명령문에만 포함됩니다. 문턱. 이 동작은 다음에 유용할 수 있습니다. 고부하 설치에 대한 통계 수집.
기본적으로 연결 로그 메시지에는 IP만 표시됩니다. 연결 호스트의 주소. 이 매개변수를 켜는 중 호스트 이름도 기록됩니다. 참고하세요 호스트 이름 확인 설정에 따라 이는 무시할 수 없는 성능 저하를 부과합니다. 이 매개변수는에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버에 명령줄.
이것은printf-스타일
각 로그 줄의 시작 부분에 출력되는 문자열입니다.%문자 시작"이스케이프 시퀀스"다음으로 대체됨
상태 정보는 아래에 설명되어 있습니다. 인식할 수 없음
이스케이프는 무시됩니다. 다른 문자는 바로 복사됩니다.
로그 라인에. 일부 탈출은 다음에서만 인식됩니다.
세션 프로세스이며 백그라운드에 적용되지 않습니다.
메인 서버 프로세스와 같은 프로세스. 이 매개변수
에서만 설정할 수 있습니다.postgresql.conf파일 또는 서버에
명령줄. 기본값은 빈 문자열입니다.
| 탈출 | 효과 | 세션만 |
|---|---|---|
| %u | 사용자 이름 | 예 |
| %d | 데이터베이스 이름 | 예 |
| %r | 원격 호스트 이름 또는 IP 주소 및 원격 항구 | 예 |
| %h | 원격 호스트 이름 또는 IP 주소 | 예 |
| %p | 프로세스 ID | 아니요 |
| %t | 밀리초가 없는 타임스탬프 | 아니요 |
| %m | 밀리초 단위의 타임스탬프 | 아니요 |
| %i | 명령 태그: 현재 세션 유형 명령 | 예 |
| %c | 세션 ID: 아래 참조 | 아니요 |
| %l | 각 세션에 대한 로그 줄 수 또는 프로세스, 1부터 시작 | 아니요 |
| %s | 프로세스 시작 타임스탬프 | 아니요 |
| %v | 가상 거래 ID (백엔드ID/localXID) | 아니요 |
| %x | 거래 ID(할당되지 않은 경우 0) | 아니요 |
| %q | 출력을 생성하지 않지만 세션이 아님을 알립니다. 문자열의 이 지점에서 프로세스를 중지합니다. 세션 프로세스에서 무시됨 | 아니요 |
| %% | 리터럴% | 아니요 |
팁:다음에 대해 비어 있지 않은 값을 설정한 경우log_line_prefix해야지 일반적으로 마지막 문자를 공백으로 만듭니다. 로그의 나머지 부분과 시각적으로 분리 라인. 구두점 문자도 사용할 수 있습니다.
팁: 시스로그스스로 시간을 생산합니다 스탬프 및 프로세스 ID 정보를 제공하므로 아마도 그럴 것입니다. 로그인하는 경우 해당 이스케이프를 사용하고 싶지 않습니다.syslog.
로그 메시지 생성 여부를 제어합니다. 세션이 다음보다 오래 대기함deadlock_timeout잠금을 획득합니다. 이는 잠금 여부를 결정하는 데 유용합니다. 대기로 인해 성능이 저하됩니다. 기본값은꺼짐.
어떤 SQL 문이 기록되는지 제어합니다. 유효한 값 이다없음, ddl, 모드및전체. ddl모든 데이터 정의 문을 기록합니다. 같은만들기, 변경및드롭문장.모드모두 기록ddl문장, 플러스 다음과 같은 데이터 수정 문삽입, 업데이트, 삭제, 잘라내기및복사 보낸사람. 준비, 실행및설명하세요 분석문은 다음과 같은 경우에도 기록됩니다. 포함된 명령은 적절한 유형입니다. 고객을 위한 확장 쿼리 프로토콜을 사용하면 다음과 같은 경우 로깅이 발생합니다. Execute 메시지가 수신되고 Bind 값이 매개변수가 포함됩니다(임베디드 작은따옴표 포함). 점수가 두 배가 됨).
기본값은없음. 만 슈퍼유저는 이 설정을 변경할 수 있습니다.
참고:간단한 구문을 포함하는 명령문 토토 핫는에 의해서도 기록되지 않습니다.log_statement = 모두설정, 로그 메시지 때문에 기본 구문 분석이 완료된 후에만 방출됩니다. 명령문 유형을 결정하십시오. 연장의 경우 쿼리 프로토콜, 이 설정도 마찬가지로 기록되지 않습니다. 실행 단계 이전에 실패한 명령문(예: 구문 분석 또는 계획 중). 설정log_min_error_statement에토토 핫(또는 그 이하) 진술.
다음 경우 임시 파일을 기록할지 여부를 제어합니다. 삭제되었습니다. 정렬을 위해 임시 파일을 생성할 수 있습니다. 해시 및 임시 쿼리 결과. 0 로그 값 모든 임시 파일 및 양수 값은 파일만 기록합니다. 크기가 지정된 숫자보다 크거나 같습니다. 킬로바이트. 기본값은-1, 이 로깅을 비활성화합니다.
다음에 기록된 타임스탬프에 사용되는 시간대를 설정합니다. 로그. 달리시간대, 이 값은 클러스터 전체에 적용되므로 모든 세션이 타임스탬프를 일관되게 보고합니다. 기본값은알 수 없음는 무엇이든 사용한다는 의미입니다. 시스템 환경은 시간대로 지정합니다. 참조섹션 8.5.348742_48815postgresql.conf파일 또는 서버 명령줄에서.
포함csvlog에서log_destination목록은 편리한 방법을 제공합니다 로그 파일을 데이터베이스 테이블로 가져옵니다. 이 옵션은 다음 열이 포함된 쉼표로 구분된 값 형식의 로그 라인입니다. 밀리초, 사용자 이름, 데이터베이스 이름, 프로세스가 포함된 타임스탬프 ID, 호스트:포트 번호, 세션 ID, 세션별 또는 프로세스 라인 번호, 명령 태그, 세션 시작 시간, 가상 트랜잭션 ID, 일반 트랜잭션 ID, 토토 핫 심각도, SQL 상태 코드, 토토 핫 메시지, 토토 핫 메시지 세부 정보, 힌트, 내부 쿼리 토토 핫가 발생한 경우(있는 경우) 토토 핫의 문자 수 해당 위치, 토토 핫 컨텍스트, 해당 토토 핫를 발생시킨 사용자 쿼리 토토 핫(있는 경우 및 활성화된 경우log_min_error_statement), 문자 수 토토 핫 위치, PostgreSQL의 토토 핫 위치 소스 코드(iflog_error_verbosity이다 으로 설정됨상세). 여기 샘플이 있습니다 CSV 형식 로그 출력을 저장하기 위한 테이블 정의:
테이블 생성 postgres_log ( 시간대가 있는 log_time 타임스탬프(3), user_name 텍스트, 데이터베이스_이름 텍스트, process_id 정수, 연결_텍스트에서, session_id 텍스트, session_line_num bigint, command_tag 텍스트, session_start_time 시간대가 포함된 타임스탬프, virtual_transaction_id 텍스트, transaction_id bigint, 토토 핫_심각도 텍스트, sql_state_code 텍스트, 메시지 텍스트, 세부 텍스트, 힌트 텍스트, 내부 쿼리 텍스트, Internal_query_pos 정수, 컨텍스트 텍스트, 쿼리 텍스트, query_pos 정수, 위치 텍스트, 기본 키(session_id, session_line_num) );
로그 파일을 이 테이블로 가져오려면 다음을 사용하십시오.다음에서 복사명령:
'/full/path/to/logfile.csv'에서 postgres_log를 csv로 복사;
가져오기를 단순화하기 위해 수행해야 할 몇 가지 작업이 있습니다. CSV 로그 파일을 쉽게 자동으로 생성하세요.
설정로그_파일이름그리고log_rotation_age일관되게 제공하기 위해, 로그 파일에 대한 예측 가능한 명명 체계. 이를 통해 파일 이름이 무엇인지 예측하고 언제 파일이 개별 로그 파일이 완료되었으므로 사용할 준비가 되었습니다. 가져왔습니다.
설정log_rotation_size0으로 로그 파일을 생성하므로 크기 기반 로그 회전을 비활성화합니다. 이름을 예측하기 어렵습니다.
설정log_truncate_on_rotation에켜짐그래서 이전 로그 데이터는 동일한 파일의 새 파일과 혼합됩니다.
위 테이블 정의에는 기본 키가 포함되어 있습니다 사양. 이는 다음으로부터 보호하는 데 유용합니다. 실수로 동일한 정보를 두 번 가져왔습니다.복사명령은 다음을 모두 커밋합니다. 데이터를 한 번에 가져오므로 토토 핫가 발생하면 전체 가져오기가 실패합니다. 부분 로그 파일을 가져오고 나중에 파일이 완료되면 다시 가져오세요. 기본 키 위반으로 인해 가져오기가 실패합니다. 잠깐 가져오기 전에 로그가 완료되고 닫힐 때까지. 이 절차를 통해 실수로 가져오는 일도 방지할 수 있습니다. 완전히 작성되지 않은 부분 행 또한 원인이 될 것입니다복사실패합니다.