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
5420_553112 / 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ại9217_9298

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

19.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 19.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 cho11940_11957. 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 18.11Để biết chi tiết.

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.

14898_14913(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.conf15260_15314pg_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àstrftime15679_15694%-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 lên 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).)

17844_178740600, 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à064018032_18163log_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ủ.

23248_23273(Boolean)

Khi đăng nhập kèo bóng đá pháposyslogVà đây là (mặc định), sau đó mỗi tin nhắn sẽ được tiền tố bởi một số trình tự tăng (chẳng hạn như[2]). Điều này bao quanh"--- tin nhắn cuối cùng được lặp lại n lần ---"triệt tiêu mà nhiều triển khai syslog thực hiện theo mặc định. Trong kèo bóng đá pháp triển khai syslog hiện đại hơn, có thể cấu hình việc triệt tiêu tin nhắn lặp đi lặp lại (ví dụ:$ lặp lạiSgreductioninrsyslog), vì vậy điều này có thể không cần thiết. Ngoài ra, bạn có thể tắt điều này nếu bạn thực sự muốn đàn áp kèo bóng đá pháp tin nhắn được lặp lại.

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

syslog_split_messages(Boolean)

Khi đăng nhập kèo bóng đá pháposyslogđược bật, tham số này xác định cách gửi tin nhắn cho syslog. Khi bật (mặc định), các thông báo được chia theo các dòng và các dòng dài được chia để chúng phù hợp với 1024 byte, đây là giới hạn kích thước điển hình cho các triển khai syslog truyền thống. Khi tắt, các thông báo kèo bóng đá pháp ký máy chủ PostgreSQL được gửi đến dịch vụ Syslog như hiện tại và tùy thuộc vào dịch vụ Syslog để đối phó với các thông báo có khả năng cồng kềnh.

Nếu syslog cuối cùng đăng nhập kèo bóng đá phápo tệp văn bản, thì hiệu ứng sẽ giống nhau, và tốt nhất là để lại cài đặt, vì hầu hết các triển khai syslog không thể xử lý các tin nhắn lớn hoặc cần được cấu hình đặc biệt để xử lý chúng. Nhưng nếu Syslog cuối cùng được viết kèo bóng đá phápo một số phương tiện khác, có thể cần thiết hoặc hữu ích hơn để giữ các tin nhắn một cách hợp lý với nhau.

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ủ.

19.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, 27768_27777, 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, liên kết 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ủa 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ụngSyslog29407_29470log_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 19-2Giả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.

30167_30204

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 kèo bóng đá pháp Cung cấp các 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 cáo 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 cáo thông tin quan tâm cho quản trị viên, ví dụ: hoạt động điểm kiểm tra. thông tin Thông tin
Fatal kèo bóng đá pháp cáo lỗi khiến phiên hiện tại bị hủy bỏ. err ERROR
Panic kèo bóng đá pháp cáo lỗi khiến tất cả các phiên cơ sở dữ liệu bị hủy bỏ. crit ERROR

19.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 phát ra đầu ra gỡ lỗi khác nhau. 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(Boolean34219_34222

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)

34766_34998PostgreSql.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, liên kết 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àprintf39146_39212%Nhân vật bắt đầu"Trình tự thoát"39299_39977PostgreSql.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
%N tem thời gian với mili giây (như một epoch unix) 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 dừng lại 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 số nhận dạng 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:
42697_42815

Tip:Nếu bạn đặt giá trị không trống cholog_line_prefix42950_43109

Tip: syslog43230_43364syslog.

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),44179_44184, modtất cả(tất cả kèo bóng đá pháp câu lệnh).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 tất cảDDLCâ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ích44859_45132

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 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 ghi lại 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)

Làm cho 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 51.346161_46233TẮ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)

46458_46915

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 cáo 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ủ.

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

bao gồmCSVLOGtronglog_destination48021_48153CSV48189_48671log_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:

49036_49644

Để 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:

Sao chép Postgres_log từ '/full/path/to/logfile.csv' với CSV;

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ênsao cho 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 thông số 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 bị lỗi. 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.

19.8.5. Quy trình Tiêu đề

kèo bóng đá pháp cài đặt này kiểm soát cách kèo bóng đá pháp tiêu đề quy trình của kèo bóng đá pháp quy trình máy chủ được sửa đổi. kèo bóng đá pháp 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. Nhìn thấyPhần 28.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 máy chủ 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''52475_52549

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. Cài đặt này mặc định làtrênTrên hầu hết kèo bóng đá pháp nền tảng, nhưng nó mặc định làTẮTTrên Windows do chi phí lớn hơn của nền tảng đó để cập kèo bóng đá pháp tiêu đề quy trình. Chỉ các siêu người dùng mới có thể thay đổi cài đặt này.