Phiên bản được hỗ trợ:hiện tại(17) /16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong kèo bóng đá pháp phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

18.8. Báo cáo lỗi và ghi kèo bóng đá pháp ký

18.8.1. Đăng nhập ở đâu

log_destination(chuỗi)

PostgreSQLHỗ trợ một số phương thức để ghi kèo bóng đá pháp ký tin nhắn máy chủ, bao gồmstderr, csvlogsyslog. Trên Windows,EventLogcũng được hỗ trợ. Đặt tham số này thành một danh sách các điểm đến kèo bóng đá pháp ký mong muốn được phân tách bằng dấu phẩy. Mặc định là đăng nhập vàostderrChỉ. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

nếucsvlogđược bao gồm tronglog_destination, các mục kèo bóng đá pháp ký được xuất trong"Giá trị phân tách bằng dấu phẩy"(CSV) Định dạng, thuận tiện cho việc tải kèo bóng đá pháp ký vào các chương trình. Nhìn thấyPhần 18.8.4Để biết chi tiết.log_collectorphải được bật để tạo đầu ra kèo bóng đá pháp ký định dạng CSV.

Lưu ý:Trên hầu hết kèo bóng đá pháp hệ thống Unix, bạn sẽ cần thay đổi cấu hình của hệ thống của bạnsyslogDaemon để sử dụngsyslogTùy chọn cholog_destination. PostgreSQLcó thể đăng nhập kèo bóng đá pháposyslogcơ sởLocal0đếnLocal7(xemsyslog_facility), nhưng mặc địnhsyslogCấu hình trên hầu hết kèo bóng đá pháp nền tảng sẽ loại bỏ tất cả kèo bóng đá pháp tin nhắn đó. Bạn sẽ cần thêm một cái gì đó như:

Local0.*/Var/log/postgresql

đếnsyslogTệp cấu hình của Daemon để làm cho nó hoạt động.

Trên Windows, khi bạn sử dụngEventLogTùy chọn cho12648_12665, bạn nên đăng ký một nguồn sự kiện và thư viện của nó với hệ điều hành để trình xem sự kiện Windows có thể hiển thị thông điệp kèo bóng đá pháp ký sự kiện một cách rõ ràng. Nhìn thấyPhần 17.11for details.

logging_collector(Boolean)

Tham số này cho phépBộ sưu tập ghi kèo bóng đá pháp ký, là một quy trình nền ghi lại các thông báo kèo bóng đá pháp ký được gửi đếnstderrvà chuyển hướng chúng vào các tệp kèo bóng đá pháp ký. Cách tiếp cận này thường hữu ích hơn so với việc đăng nhập vàosyslog, vì một số loại tin nhắn có thể không xuất hiện trongsyslogđầu ra. (Một ví dụ phổ biến là các thông kèo bóng đá pháp lỗi liên kết động;Archive_Command.) Tham số này chỉ có thể được đặt ở máy chủ bắt đầu.

Lưu ý:Có thể đăng nhập kèo bóng đá phápostderrmà không sử dụng trình thu thập ghi kèo bóng đá pháp ký; Các thông báo kèo bóng đá pháp ký sẽ chỉ đi đến bất cứ nơi nào máy chủstderrđược hướng dẫn. Tuy nhiên, phương pháp đó chỉ phù hợp với khối lượng kèo bóng đá pháp ký thấp, vì nó không cung cấp cách nào thuận tiện để xoay các tệp kèo bóng đá pháp ký. Ngoài ra, trên một số nền tảng không sử dụng trình thu thập ghi kèo bóng đá pháp ký có thể dẫn đến đầu ra kèo bóng đá pháp ký bị mất hoặc bị cắt xén, bởi vì nhiều quy trình ghi đồng thời vào cùng một tệp kèo bóng đá pháp ký có thể ghi đè lên đầu ra của nhau.

Lưu ý:Trình thu thập đăng nhập được thiết kế để không bao giờ mất tin nhắn. Điều này có nghĩa là trong trường hợp tải trọng cực cao, các quy trình máy chủ có thể bị chặn trong khi cố gắng gửi thêm tin nhắn kèo bóng đá pháp ký khi trình thu thập bị tụt lại phía sau. Ngược lại,syslogthích bỏ tin nhắn nếu nó không thể viết chúng, điều đó có nghĩa là nó có thể không đăng nhập một số tin nhắn trong kèo bóng đá pháp trường hợp như vậy nhưng nó sẽ không chặn phần còn lại của hệ thống.

log_directory(chuỗi)

KhiLogging_Collectorđược bật, tham số này xác định thư mục trong đó các tệp kèo bóng đá pháp ký sẽ được tạo. Nó có thể được chỉ định là một đường dẫn tuyệt đối hoặc liên quan đến thư mục dữ liệu cụm. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ. Mặc định làpg_log.

log_filename(chuỗi)

khiLogging_Collectorđược bật, tham số này đặt tên tệp của các tệp kèo bóng đá pháp ký được tạo. Giá trị được coi làstrftimemẫu, vì vậy%-Scapes có thể được sử dụng để chỉ định tên tệp thay đổi thời gian. (Lưu ý rằng nếu có bất kỳ sự phụ thuộc kèo bóng đá phápo vùng thời gian nào%-Scapes, tính toán được thực hiện trong vùng được chỉ định bởilog_timezone.) Được hỗ trợ%-escapes tương tự như những người được liệt kê trong nhóm mởstrftimeĐặc điểm kỹ thuật. Lưu ý rằng hệ thốngstrftimekhông được sử dụng trực tiếp, do đó kèo bóng đá pháp tiện ích mở rộng cụ thể về nền tảng (không chuẩn) không hoạt động. Mặc định làPostgresql-%y-%m-%d_%h%m%s.log.

Nếu bạn chỉ định tên tệp không có Escapes, bạn nên có kế hoạch sử dụng tiện ích xoay vòng kèo bóng đá pháp ký để tránh điền vào toàn bộ đĩa. Trong các bản phát hành trước 8.4, nếu không%Escapes đã có mặt,PostgreSQLSẽ nối phần kỷ nguyên của thời gian tạo tệp kèo bóng đá pháp ký mới, nhưng điều này không còn xảy ra.

Nếu đầu ra CSV-Format được bật tronglog_destination, .csvsẽ được gắn vào tên tệp kèo bóng đá pháp ký được đặt theo dấu thời gian để tạo tên tệp cho đầu ra CSV-Format. (Nếu nhưlog_filenamekết thúc bằng.log, hậu tố được thay thế thay thế.)

Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

log_file_mode(Số nguyên)

Trên các hệ thống Unix Tham số này đặt các quyền cho các tệp kèo bóng đá pháp ký khiLogging_Collectorđược bật. .ChmodUmaskCuộc gọi hệ thống. (Để sử dụng định dạng bát phân thông thường, số phải bắt đầu bằng0(không).)

Quyền mặc định là0600, có nghĩa là chỉ chủ sở hữu máy chủ mới có thể đọc hoặc ghi các tệp kèo bóng đá pháp ký. Cài đặt phổ biến khác là0640, cho phép kèo bóng đá pháp thành viên của nhóm chủ sở hữu đọc kèo bóng đá pháp tệp. Tuy nhiên, lưu ý rằng để sử dụng cài đặt như vậy, bạn sẽ cần thay đổilog_directoryĐể lưu trữ các tệp ở đâu đó bên ngoài thư mục dữ liệu cụm. Trong mọi trường hợp, không khôn ngoan khi làm cho các tệp kèo bóng đá pháp ký có thể đọc được thế giới, vì chúng có thể chứa dữ liệu nhạy cảm.

Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

log_rotation_age(Số nguyên)

khiLogging_Collectorđược bật, tham số này xác định tuổi thọ tối đa của một tệp kèo bóng đá pháp ký riêng lẻ. Sau nhiều phút này đã trôi qua, một tệp kèo bóng đá pháp ký mới sẽ được tạo. Đặt thành 0 để vô hiệu hóa việc tạo các tệp kèo bóng đá pháp ký mới dựa trên thời gian. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

log_rotation_size(Số nguyên)

Khilogging_collectorđược bật, tham số này xác định kích thước tối đa của một tệp kèo bóng đá pháp ký riêng lẻ. Sau đó, nhiều kilobyte này đã được phát ra thành một tệp kèo bóng đá pháp ký, một tệp kèo bóng đá pháp ký mới sẽ được tạo. Đặt thành 0 thành Vô hiệu hóa Tạo các tệp kèo bóng đá pháp ký mới dựa trên kích thước. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

log_truncate_on_rotation(Boolean)

KhiLogging_Collectorđược bật, tham số này sẽ gây raPostgreSQLĐể cắt ngắn (ghi đè), thay vì nối vào mọi tệp kèo bóng đá pháp ký hiện có cùng tên. Tuy nhiên, việc cắt ngắn sẽ chỉ xảy ra khi một tệp mới được mở do xoay dựa trên thời gian, không phải trong quá trình khởi động máy chủ hoặc xoay dựa trên kích thước. Khi tắt, các tệp đã tồn tại sẽ được thêm vào trong mọi trường hợp. Ví dụ: sử dụng cài đặt này kết hợp vớilog_filenamenhưPostgresql-%H.Logsẽ dẫn đến việc tạo ra hai mươi bốn tệp kèo bóng đá pháp ký hàng giờ và sau đó ghi đè theo chu kỳ. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

Ví dụ: Để giữ 7 ngày kèo bóng đá pháp ký, một tệp kèo bóng đá pháp ký mỗi ngày có tênserver_log.mon, server_log.tue, v.v. và tự động ghi đè lên kèo bóng đá pháp ký tuần trước với kèo bóng đá pháp ký tuần này, SETlog_filenameđếnserver_log.%A, log_truncate_on_rotationđếntrênlog_rotation_ageđến1440.

Ví dụ: Để giữ 24 giờ kèo bóng đá pháp ký, một tệp kèo bóng đá pháp ký mỗi giờ, nhưng cũng xoay sớm hơn nếu kích thước tệp kèo bóng đá pháp ký vượt quá 1GB, đặtlog_filenameđếnserver_log.%H%m, log_truncate_on_rotationđếntrên, log_rotation_ageđến60log_rotation_sizeđến1000000. Bao gồm%minlog_filenameCho phép bất kỳ phép quay nào theo kích thước có thể xảy ra để chọn tên tệp khác với tên tệp ban đầu của giờ.

syslog_facility(enum)

Khi đăng nhập kèo bóng đá pháposyslogđược bật, tham số này xác địnhsyslog "Cơ sở"sẽ được sử dụng. Bạn có thể chọn từLocal0, Local1, Local2, Local3, Local4, Local5, Local6, Local7; Mặc định làLocal0. Xem thêm tài liệu về hệ thống của bạnsyslogDaemon. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

syslog_ident(chuỗi)

Khi đăng nhập kèo bóng đá pháposyslogđược bật, tham số này xác định tên chương trình được sử dụng để xác địnhPostgreSQLTin nhắn trongsyslogkèo bóng đá pháp ký. Mặc định làPostgres. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

event_source(chuỗi)

Khi đăng nhập kèo bóng đá phápokèo bóng đá pháp ký sự kiệnđược bật, tham số này xác định tên chương trình được sử dụng để xác địnhPostgreSQLTin nhắn trong kèo bóng đá pháp ký. Mặc định làPostgreSQL. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

18.8.2. Khi nào đăng nhập

log_min_messages(enum)

điều khiển nàocấp độ tin nhắnđược ghi vào kèo bóng đá pháp ký máy chủ. Giá trị hợp lệ làDEBUG5, Debug4, Debug3, Debug2, DEBUG1, INFO, Thông kèo bóng đá pháp, Cảnh kèo bóng đá pháp, ERROR, log, FatalPanic. Mỗi cấp độ bao gồm tất cả các cấp độ theo nó. Cấp độ muộn hơn, ít tin nhắn được gửi đến kèo bóng đá pháp ký. Mặc định làcảnh kèo bóng đá pháp. Lưu ý rằnglogcó thứ hạng khác ở đây so vớiclient_min_messages. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

log_min_error_statement(enum)

Điều khiển các câu lệnh SQL gây ra tình trạng lỗi được ghi lại trong kèo bóng đá pháp ký máy chủ. Câu lệnh SQL hiện tại được bao gồm trong mục nhập kèo bóng đá pháp ký cho bất kỳ thông báo nào của được chỉ địnhMức độ nghiêm trọnghoặc cao hơn. Giá trị hợp lệ làDEBUG5, DEBUG4, Debug3, Debug2, Debug1, INFO, Thông kèo bóng đá pháp, Cảnh kèo bóng đá pháp, ERROR, log, FatalPanic. Mặc định làERROR, có nghĩa là các câu lệnh gây ra lỗi, tin nhắn kèo bóng đá pháp ký, lỗi gây tử vong hoặc hoảng loạn sẽ được ghi lại. Để tắt hiệu quả việc ghi kèo bóng đá pháp ký các câu lệnh không thành công, hãy đặt tham số này thànhPanic. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

log_min_duration_statement(Số nguyên)

gây ra thời lượng của mỗi câu lệnh đã hoàn thành được ghi lại nếu câu lệnh được chạy ít nhất là số mili giây được chỉ định. Đặt điều này thành 0 in tất cả các thời lượng tuyên bố. Trừ một (mặc định) vô hiệu hóa thời lượng báo cáo ghi kèo bóng đá pháp ký. Ví dụ: nếu bạn đặt nó thành250msSau đó, tất cả các câu lệnh SQL chạy 250ms trở lên sẽ được kèo bóng đá pháp lại. Kích hoạt tham số này có thể hữu ích trong việc theo dõi các truy vấn chưa được tối ưu hóa trong các ứng dụng của bạn. Chỉ các siêu người dùng mới có thể thay đổi cài đặt này.

Đối với các máy khách sử dụng giao thức truy vấn mở rộng, thời lượng của các bước phân tích, ràng buộc và thực thi được kèo bóng đá pháp lại độc lập.

Lưu ý:Khi sử dụng tùy chọn này cùng vớilog_statement, Văn bản các câu lệnh được kèo bóng đá pháp lại vìlog_statementsẽ không được lặp lại trong thông báo kèo bóng đá pháp ký thời lượng. Nếu bạn không sử dụngsyslog, bạn nên đăng nhập PID hoặc ID phiên bằnglog_line_prefixđể bạn có thể liên kết thông kèo bóng đá pháp câu lệnh với thông kèo bóng đá pháp thời lượng sau bằng ID quy trình hoặc ID phiên.

Bảng 18-1Giải thích mức độ nghiêm trọng của thông kèo bóng đá pháp được sử dụng bởiPostgreSQL. Nếu đầu ra ghi kèo bóng đá pháp ký được gửi đếnsysloghoặc Windows 'EventLog, mức độ nghiêm trọng được dịch như trong bảng.

Bảng 18-1. Mức độ nghiêm trọng của thông kèo bóng đá pháp

Mức độ nghiêm trọng sử dụng syslog EventLog
DEBUG1..DEBUG5 Cung cấp thông tin liên tiếp được chi tiết để sử dụng bởi kèo bóng đá pháp nhà phát triển. Debug Thông tin
INFO cung cấp thông tin được người dùng yêu cầu ngầm, ví dụ: đầu ra từVerbose chân không. INFO Thông tin
Thông kèo bóng đá pháp Cung cấp thông tin có thể hữu ích cho người dùng, ví dụ: thông kèo bóng đá pháp về việc cắt ngắn các định danh dài. Thông kèo bóng đá pháp Thông tin
CẢNH BÁO Cung cấp cảnh kèo bóng đá pháp về các vấn đề có thể xảy ra, ví dụ:cam kếtBên ngoài một khối giao dịch. Thông kèo bóng đá pháp CẢNH BÁO
ERROR kèo bóng đá pháp lỗi khiến lệnh hiện tại bị hủy bỏ. Cảnh kèo bóng đá pháp ERROR
log kèo bóng đá pháp thông tin quan tâm đến quản trị viên, ví dụ: hoạt động điểm kiểm tra. INFO Thông tin
Fatal kèo bóng đá pháp lỗi khiến phiên hiện tại bị hủy bỏ. err ERROR
Panic kèo bóng đá pháp lỗi khiến tất cả các phiên cơ sở dữ liệu bị hủy bỏ. crit ERROR

18.8.3. GÌ để đăng nhập

application_name(chuỗi)

Theapplication_namecó thể là bất kỳ chuỗi nào nhỏ hơnĐược đặt tênký tự (64 ký tự trong bản dựng tiêu chuẩn). Nó thường được đặt bởi một ứng dụng khi kết nối với máy chủ. Tên sẽ được hiển thị trongpg_stat_activityXem và bao gồm trong các mục kèo bóng đá pháp ký CSV. Nó cũng có thể được bao gồm trong các mục kèo bóng đá pháp ký thông thường thông qualog_line_prefixTham số. Chỉ kèo bóng đá pháp ký tự ASCII có thể in có thể được sử dụng trongapplication_nameGiá trị. kèo bóng đá pháp ký tự khác sẽ được thay thế bằng dấu câu hỏi (?).

Debug_print_parse(Boolean)
DEBUG_PRINT_REWRITTEN(Boolean)
DEBUG_PRINT_PLAN(Boolean)

kèo bóng đá pháp tham số này cho phép đầu ra gỡ lỗi khác nhau được phát ra. Khi được đặt, họ in cây phân tích kết quả, đầu ra viết lại truy vấn hoặc kế hoạch thực thi cho mỗi truy vấn được thực hiện. Những tin nhắn này được phát ra tạilogMức tin nhắn, vì vậy theo mặc định, chúng sẽ xuất hiện trong kèo bóng đá pháp ký máy chủ nhưng sẽ không được gửi đến máy khách. Bạn có thể thay đổi điều đó bằng cách điều chỉnhclient_min_messagesvà/hoặclog_min_messages. kèo bóng đá pháp tham số này bị tắt theo mặc định.

Debug_Pretty_Print(Boolean)

Khi đặt,DEBUG_PRETTY_PRINTIndents kèo bóng đá pháp tin nhắn được tạo bởiDEBUG_PRINT_PARSE, DEBUG_PRINT_REWRITTENhoặcDEBUG_PRINT_PLAN. Điều này dẫn đến khả năng dễ đọc hơn nhưng sản lượng dài hơn nhiều so với"Compact"Định dạng được sử dụng khi tắt. Nó được bật theo mặc định.

log_checkpoints(Boolean)

gây ra các điểm kiểm tra và khởi động lại được ghi vào kèo bóng đá pháp ký máy chủ. Một số số liệu thống kê được bao gồm trong các tin nhắn kèo bóng đá pháp ký, bao gồm số lượng bộ đệm được viết và thời gian viết chúng. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ. Mặc định bị tắt.

log_connections(Boolean)

khiến mỗi lần cố gắng kết nối với máy chủ được kèo bóng đá pháp lại, cũng như hoàn thành xác thực máy khách thành công. Chỉ các siêu nhân mới có thể thay đổi tham số này khi bắt đầu phiên và nó không thể được thay đổi trong một phiên. Mặc định làTẮT.

Lưu ý:Một số chương trình khách hàng, nhưPSQL, Cố gắng kết nối hai lần trong khi xác định xem có yêu cầu mật khẩu hay không, vì vậy hãy trùng lặp"Kết nối nhận được"Tin nhắn không nhất thiết chỉ ra một vấn đề.

log_disconnections(Boolean)

gây ra các kết thúc phiên được ghi lại. Đầu ra kèo bóng đá pháp ký cung cấp thông tin tương tựlog_connections, cộng với thời lượng của phiên. Chỉ kèo bóng đá pháp siêu nhân mới có thể thay đổi tham số này khi bắt đầu phiên và nó không thể được thay đổi trong một phiên. Mặc định làTẮT.

log_duration(Boolean)

gây ra thời lượng của mỗi câu lệnh đã hoàn thành được kèo bóng đá pháp lại. Mặc định làTẮT. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

Đối với các máy khách sử dụng giao thức truy vấn mở rộng, thời lượng của các bước phân tích, ràng buộc và thực thi được kèo bóng đá pháp lại độc lập.

Lưu ý:Sự khác biệt giữa cài đặt tùy chọn này và cài đặtlog_min_duration_statementđến 0 là vượt quálog_min_duration_statementBuộc văn bản của truy vấn phải được kèo bóng đá pháp lại, nhưng tùy chọn này thì không. Do đó, nếulog_durationtrênlog_min_duration_statementCó giá trị dương, tất cả các thời lượng được kèo bóng đá pháp lại nhưng văn bản truy vấn chỉ được bao gồm cho các câu lệnh vượt quá ngưỡng. Hành vi này có thể hữu ích để thu thập số liệu thống kê trong cài đặt tải cao.

log_error_verbosity(enum)

Kiểm soát lượng chi tiết được ghi trong kèo bóng đá pháp ký máy chủ cho mỗi thông báo được ghi lại. Giá trị hợp lệ làterse, Mặc địnhVerbose, mỗi trường thêm nhiều trường kèo bóng đá phápo các tin nhắn được hiển thị.terseLoại trừ việc ghi kèo bóng đá pháp kýchi tiết, Gợi ý, Truy vấnbối cảnhThông tin lỗi.Verboseđầu ra bao gồmSQLSTATEMã lỗi (xem thêmPhụ lục A) và tên tệp mã nguồn, tên chức năng và số dòng đã tạo lỗi. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

log_hostname(Boolean)

Theo mặc định, thông báo kèo bóng đá pháp ký kết nối chỉ hiển thị địa chỉ IP của máy chủ kết nối. Xoay tham số này theo nguyên nhân ghi kèo bóng đá pháp ký tên máy chủ. Lưu ý rằng tùy thuộc vào thiết lập độ phân giải tên máy chủ của bạn, điều này có thể áp dụng hình phạt hiệu suất không đáng kể. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

log_line_prefix(chuỗi)

Đây là mộtprintf-Style String là đầu ra ở đầu mỗi dòng kèo bóng đá pháp ký.%ký tự bắt đầu"Trình tự thoát"được thay thế bằng thông tin trạng thái như được nêu dưới đây. Escapes không được công nhận bị bỏ qua. Các ký tự khác được sao chép thẳng vào dòng kèo bóng đá pháp ký. Một số Escapes chỉ được công nhận bởi các quy trình phiên và sẽ được coi là trống bởi các quy trình nền như quy trình máy chủ chính. Thông tin trạng thái có thể được căn chỉnh hoặc bên trái hoặc phải bằng cách chỉ định một chữ số sau % và trước tùy chọn. Một giá trị âm sẽ khiến thông tin trạng thái được đệm ở bên phải với các khoảng trắng để cung cấp cho nó chiều rộng tối thiểu, trong khi một giá trị dương sẽ đệm ở bên trái. Đệm có thể hữu ích để hỗ trợ khả năng đọc của con người trong các tệp kèo bóng đá pháp ký. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ. Mặc định là một chuỗi trống.

Escape Hiệu ứng Chỉ phiên
%A tên ứng dụng
%U Tên người dùng
%D Tên cơ sở dữ liệu
%R Tên máy chủ hoặc địa chỉ IP từ xa và cổng từ xa
%H Tên máy chủ từ xa hoặc địa chỉ IP
%P ID xử lý Không
%T tem thời gian không có mili giây không
%m tem thời gian với mili giây Không
%I Thẻ lệnh: Loại lệnh hiện tại của phiên
%E Mã lỗi SQLSTATE Không
%C ID phiên: Xem bên dưới Không
%L Số lượng dòng kèo bóng đá pháp ký cho mỗi phiên hoặc quy trình, bắt đầu từ 1 Không
%s TEAM thời gian bắt đầu quá trình Không
%V ID giao dịch ảo (BackEndId/localXID) không
%x ID giao dịch (0 nếu không được chỉ định) Không
%Q Không tạo ra đầu ra, nhưng yêu cầu kèo bóng đá pháp quá trình không ngừng dừng tại thời điểm này trong chuỗi; bị bỏ qua bởi kèo bóng đá pháp quy trình phiên Không
%% nghĩa đen% Không
The%CEscape in một mã định danh phiên bán đơn, bao gồm hai số thập lục phân 4 byte (không có số 0 hàng đầu) được phân tách bằng một dấu chấm. kèo bóng đá pháp số là thời gian bắt đầu quy trình và ID quy trình, vì vậy%Ccũng có thể được sử dụng như một cách tiết kiệm không gian để in kèo bóng đá pháp mục đó. Ví dụ: để tạo mã định danh phiên từpg_stat_activity, Sử dụng truy vấn này:
40438_40556

tip:Nếu bạn đặt giá trị không trống cholog_line_prefix, Bạn thường nên làm cho ký tự cuối cùng của nó là một không gian, để cung cấp sự tách biệt trực quan với phần còn lại của dòng kèo bóng đá pháp ký. Một ký tự dấu câu cũng có thể được sử dụng.

Tip: syslog40971_41105syslog.

log_lock_waits(Boolean)

Điều khiển xem thông báo kèo bóng đá pháp ký có được tạo khi phiên chờ đợi lâu hơndeadlock_timeoutĐể có được khóa. Điều này rất hữu ích trong việc xác định nếu khóa chờ có gây ra hiệu suất kém. Mặc định làTẮT. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

log_statement(enum)

Điều khiển các câu lệnh SQL nào được kèo bóng đá pháp lại. Giá trị hợp lệ làKhông(tắt),DDL, modtất cả(tất cả kèo bóng đá pháp câu).DDLkèo bóng đá pháp lại tất cả các câu lệnh định nghĩa dữ liệu, chẳng hạn nhưTạo, AlterthảCâu lệnh.modlog allDDLCâu lệnh, cộng với kèo bóng đá pháp câu lệnh biến đổi dữ liệu nhưChèn, Cập kèo bóng đá pháp, Xóa, cắt ngắnSao chép từ. Chuẩn bị, thực thiGiải thích Phân tíchCác câu lệnh cũng được ghi lại nếu lệnh chứa của chúng thuộc loại thích hợp. Đối với các máy khách sử dụng giao thức truy vấn mở rộng, việc ghi kèo bóng đá pháp ký xảy ra khi nhận được thông báo thực thi và các giá trị của các tham số liên kết được bao gồm (với bất kỳ dấu nào được nhúng được tăng gấp đôi).

Mặc định làKhông. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

Lưu ý:Các câu lệnh có chứa các lỗi cú pháp đơn giản không được kèo bóng đá pháp lại ngay cả bởilog_statement=tất cảCài đặt, vì thông báo kèo bóng đá pháp ký chỉ được phát ra sau khi phân tích cú pháp cơ bản đã được thực hiện để xác định loại câu lệnh. Trong trường hợp giao thức truy vấn mở rộng, cài đặt này tương tự không đăng nhập các câu lệnh không thành công trước giai đoạn thực thi (nghĩa là, trong quá trình phân tích hoặc lập kế hoạch phân tích). Bộlog_min_error_statementđếnERROR(hoặc thấp hơn) để kèo bóng đá pháp lại các câu lệnh đó.

log_Replication_Commands(Boolean)

khiến mỗi lệnh sao chép được ghi vào kèo bóng đá pháp ký máy chủ. Nhìn thấyPhần 50.3Để biết thêm thông tin về lệnh sao chép. Giá trị mặc định làTẮT. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.

log_temp_files(Số nguyên)

Điều khiển ghi kèo bóng đá pháp ký tên và kích thước tệp tạm thời. Các tập tin tạm thời có thể được tạo cho các loại, băm và kết quả truy vấn tạm thời. Một mục kèo bóng đá pháp ký được thực hiện cho mỗi tệp tạm thời khi nó bị xóa. Giá trị bằng không ghi tất cả thông tin tệp tạm thời, trong khi các giá trị dương chỉ ghi các tệp có kích thước lớn hơn hoặc bằng số kilobyte được chỉ định. Cài đặt mặc định là -1, vô hiệu hóa việc ghi kèo bóng đá pháp ký đó. Chỉ các siêu người dùng mới có thể thay đổi cài đặt này.

log_timezone(chuỗi)

Đặt múi giờ được sử dụng cho dấu thời gian được viết trong kèo bóng đá pháp ký máy chủ. Không giống nhưtimezone, giá trị này có toàn bộ cụm, để tất cả các phiên sẽ kèo bóng đá pháp dấu thời gian một cách nhất quán. Mặc định tích hợp làGMT, nhưng điều đó thường được kèo bóng đá pháp đè trongPostgreSql.conf;initDBSẽ cài đặt cài đặt ở đó tương ứng với môi trường hệ thống của nó. Nhìn thấyPhần 8.5.3Để biết thêm thông tin. Tham số này chỉ có thể được đặt trongPostgreSql.confTệp hoặc trên dòng lệnh máy chủ.

18.8.4. Sử dụng đầu ra kèo bóng đá pháp ký CSV-Format

bao gồmcsvlogtronglog_destinationDanh sách cung cấp một cách thuận tiện để nhập tệp kèo bóng đá pháp ký vào bảng cơ sở dữ liệu. Tùy chọn này phát ra các dòng kèo bóng đá pháp ký trong giá trị phân tách bằng dấu phẩy (CSV) Định dạng, với kèo bóng đá pháp cột sau: dấu thời gian với mili giây, tên người dùng, tên cơ sở dữ liệu, ID quy trình, máy chủ khách hàng: Số cổng, ID phiên, số dòng mỗi lần bối cảnh, truy vấn người dùng dẫn đến lỗi (nếu có và được bật bởilog_min_error_statement), Số lượng ký tự của vị trí lỗi trong đó, vị trí của lỗi trong mã nguồn PostgreSQL (nếulog_error_verbosityđược đặt thànhVerbose) và tên ứng dụng. Dưới đây là định nghĩa bảng mẫu để lưu trữ đầu ra kèo bóng đá pháp ký CSV-Format:

Tạo bảng Postgres_log
.
  log_time timeStamp (3) với múi giờ,
  văn bản user_name,
  cơ sở dữ liệu_name văn bản,
  Intection_id Integer,
  kết nối_from văn bản,
  Session_id văn bản,
  session_line_num bigint,
  chỉ huy_tag văn bản,
  session_start_time timeStamp với múi giờ,
  Virtual_transaction_id văn bản,
  Giao dịch_id Bigint,
  văn bản error_Severity,
  văn bản SQL_STATE_CODE,
  văn bản tin nhắn,
  văn bản chi tiết,
  gợi ý văn bản,
  văn bản internal_query,
  Internal_query_pos Integer,
  văn bản bối cảnh,
  văn bản truy vấn,
  Số nguyên query_pos,
  Vị trí văn bản,
  application_name văn bản,
  Khóa chính (session_id, session_line_num)
);

Để nhập tệp kèo bóng đá pháp ký vào bảng này, sử dụngSao chép từlệnh:

47515_47577

Cũng có thể truy cập tệp dưới dạng bàn nước ngoài, sử dụng được cung cấpFILE_FDWMô -đun.

Có một vài điều bạn cần làm để đơn giản hóa việc nhập tệp kèo bóng đá pháp ký CSV:

  1. setlog_filenamelog_rotation_ageĐể cung cấp sơ đồ đặt tên nhất quán, có thể dự đoán được cho các tệp kèo bóng đá pháp ký của bạn. Điều này cho phép bạn dự đoán tên tệp sẽ là gì và biết khi nào một tệp kèo bóng đá pháp ký riêng lẻ và do đó sẵn sàng để nhập.

  2. setlog_rotation_sizeđến 0 để vô hiệu hóa vòng quay dựa trên kích thước, vì nó làm cho tên tệp kèo bóng đá pháp ký khó dự đoán.

  3. setlog_truncate_on_rotationđếntrênVì vậy, dữ liệu kèo bóng đá pháp ký cũ không được trộn với mới trong cùng một tệp.

  4. Định nghĩa bảng ở trên bao gồm một đặc điểm kỹ thuật chính. Điều này rất hữu ích để bảo vệ chống lại việc vô tình nhập cùng một thông tin hai lần. TheCopyLệnh cam kết tất cả dữ liệu mà nó nhập cùng một lúc, do đó, mọi lỗi sẽ khiến toàn bộ nhập không thành công. Nếu bạn nhập tệp kèo bóng đá pháp ký một phần và sau đó nhập tệp khi hoàn tất, vi phạm khóa chính sẽ khiến việc nhập không thành công. Đợi cho đến khi kèo bóng đá pháp ký hoàn tất và đóng trước khi nhập. Quy trình này cũng sẽ bảo vệ chống lại việc vô tình nhập một dòng một phần chưa được viết hoàn toàn, điều này cũng sẽ gây raCopyđể thất bại.

18.8.5. Quy trình Tiêu đề

kèo bóng đá pháp cài đặt này kiểm soát cách tiêu đề quy trình được thấy bởiPSđược sửa đổi. Nhìn thấyPhần 27.1Để biết chi tiết.

cluster_name(chuỗi)

Đặt tên cụm xuất hiện trong tiêu đề quy trình cho tất cả kèo bóng đá pháp quy trình trong cụm này. Tên có thể là bất kỳ chuỗi nào nhỏ hơnĐược đặt tênký tự (64 ký tự trong bản dựng tiêu chuẩn). Chỉ kèo bóng đá pháp ký tự ASCII có thể in có thể được sử dụng trongcluster_nameGiá trị. kèo bóng đá pháp ký tự khác sẽ được thay thế bằng dấu câu hỏi (?). Không có tên nào được hiển thị nếu tham số này được đặt thành chuỗi trống''(là mặc định). Tham số này chỉ có thể được đặt ở máy chủ bắt đầu.

Tiêu đề quy trình thường được xem bằng kèo bóng đá pháp chương trình nhưPShoặc, trên Windows,Process Explorer.

update_process_title(Boolean)

Cho phép cập kèo bóng đá pháp tiêu đề quy trình mỗi khi nhận được lệnh SQL mới được máy chủ nhận được. Tiêu đề quy trình thường được xem bởiPSLệnh hoặc trong Windows bằng cách sử dụngProcess Explorer. Chỉ kèo bóng đá pháp siêu người dùng mới có thể thay đổi cài đặt này.