Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Anda dapat menyesuaikan perilaku pencatatan log untuk klaster DB Aurora PostgreSQL dengan mengubah berbagai parameter. Dalam tabel berikut, Anda dapat menemukan parameter yang memengaruhi durasi penyimpanan log, waktu untuk memutar log, dan apakah akan menampilkan log sebagai format CSV (nilai yang dipisahkan koma). Anda juga dapat menemukan output teks yang dikirim ke STDERR, di antara pengaturan lainnya. Untuk mengubah pengaturan parameter yang dapat diubah, gunakan grup parameter klaster DB kustom untuk klaster DB Aurora PostgreSQL. Untuk mengetahui informasi selengkapnya, lihat .
| Parameter | Default | Deskripsi |
|---|---|---|
log_destination |
stderr |
Menetapkan format output untuk log. Default-nya adalah |
log_filename |
postgresql.log.%Y-%m-%d-%H%M |
Menentukan pola untuk nama file log. Selain default, parameter ini mendukung |
log_line_prefix |
%t:%r:%u@%d:[%p]: |
Mendefinisikan awalan untuk setiap baris log yang akan ditulis ke |
log_rotation_age |
60 |
Menit setelah file log dirotasi secara otomatis. Anda dapat mengubah nilai ini dalam kisaran 1 dan 1440 menit. Untuk informasi selengkapnya, lihat Mengatur rotasi file log. |
log_rotation_size |
– |
Ukuran (kB) tempat log dirotasi secara otomatis. Anda dapat mengubah nilai ini dalam kisaran 50.000 hingga 1.000.000 kilobyte. Untuk mempelajari selengkapnya, lihat Mengatur rotasi file log. |
rds.log_retention_period |
4320 |
Log PostgreSQL yang lebih lama dari jumlah menit yang ditentukan dihapus. Nilai default 4320 menit menghapus file log setelah 3 hari. Untuk informasi selengkapnya, lihat Mengatur periode retensi log. |
Untuk mengidentifikasi masalah aplikasi, Anda dapat mencari kegagalan kueri, kegagalan masuk, kebuntuan, dan kesalahan server fatal di log. Misalnya, anggaplah Anda mengonversi aplikasi lama dari Oracle ke Aurora PostgreSQL, tetapi tidak semua kueri dikonversi dengan benar. Kueri yang salah format ini menghasilkan pesan kesalahan yang dapat Anda temukan di log untuk membantu mengidentifikasi masalah. Untuk mengetahui informasi selengkapnya tentang pencatatan log kueri, lihat Mengaktifkan pencatatan log kueri untuk klaster DB Aurora PostgreSQL.
Dalam topik berikut, Anda dapat menemukan informasi tentang cara mengatur berbagai parameter yang mengontrol detail dasar untuk log PostgreSQL Anda.
Topik
Mengatur periode retensi log
Parameter rds.log_retention_period menentukan berapa lama klaster DB Aurora PostgreSQL menyimpan file log-nya. Pengaturan default-nya adalah 3 hari (4.320 menit), tetapi Anda dapat mengatur nilai ini ke mana saja dari 1 hari (1.440 menit) hingga 7 hari (10.080 menit). Pastikan bahwa klaster DB Aurora PostgreSQL Anda memiliki penyimpanan yang cukup untuk menyimpan file log selama periode waktu tertentu.
Kami menyarankan agar log Anda dipublikasikan secara rutin ke Amazon CloudWatch Logs sehingga Anda dapat melihat dan menganalisis data sistem lama setelah log dihapus dari cluster DB PostgreSQL Aurora Anda. Untuk mengetahui informasi selengkapnya, lihat Menerbitkan log Aurora PostgreSQL ke Amazon Logs CloudWatch . Setelah Anda mengatur CloudWatch penerbitan, Aurora tidak menghapus log sampai setelah dipublikasikan ke CloudWatch Log.
Amazon Aurora mengompresi log PostgreSQL lama ketika penyimpanan untuk instans DB mencapai ambang batas. Aurora mengompresi file menggunakan utilitas kompresi gzip. Untuk mengetahui informasi selengkapnya, lihat situs web gzip
Saat penyimpanan instans DB rendah dan semua log yang tersedia dikompresi, Anda akan mendapatkan peringatan seperti berikut:
Warning: local storage for PostgreSQL log files is critically low for
this Aurora PostgreSQL instance, and could lead to a database outage.Jika tidak ada cukup penyimpanan, Aurora dapat menghapus log PostgreSQL yang terkompresi sebelum akhir periode retensi tertentu. Jika hal ini terjadi, Anda akan melihat pesan yang mirip dengan pesan berikut:
The oldest PostgreSQL log files were deleted due to local storage constraints.
Mengatur rotasi file log
Aurora membuat file log baru setiap jam secara default. Waktu dikontrol oleh parameter log_rotation_age. Parameter ini memiliki nilai default 60 (menit), tetapi Anda dapat mengaturnya ke mana saja dari 1 menit hingga 24 jam (1.440 menit). Ketika tiba waktunya rotasi, file log baru yang berbeda akan dibuat. File ini diberi nama sesuai dengan pola yang ditentukan oleh parameter log_filename.
File log juga dapat dirotasi sesuai dengan ukurannya, seperti yang ditentukan dalam parameter log_rotation_size. Parameter ini menentukan bahwa log harus dirotasi saat mencapai ukuran yang ditentukan (dalam kilobyte). Nilai default log_rotation_size adalah 100000 kB (kilobyte) untuk klaster DB Aurora PostgreSQL, tetapi Anda dapat mengatur nilai ini ke mana pun dari 50.000 hingga 1.000.000 kilobyte.
Nama file log didasarkan pada pola nama file yang ditentukan dalam parameter log_filename. Pengaturan yang tersedia untuk parameter ini adalah sebagai berikut:
-
postgresql.log.%Y-%m-%d– Format default untuk nama file log. Termasuk tahun, bulan, dan tanggal dalam nama file log. -
postgresql.log.%Y-%m-%d-%H– Termasuk jam dalam format nama file log. -
postgresql.log.%Y-%m-%d-%H%M– Termasuk jam:menit dalam format nama file log.
Jika Anda mengatur parameter log_rotation_age ke kurang dari 60 menit, atur parameter log_filename ke format menit.
Untuk mengetahui informasi selengkapnya, lihat log_rotation_agelog_rotation_size
Mengatur tujuan log (stderr, csvlog)
Secara default, Aurora PostgreSQL menghasilkan log dalam format kesalahan standar (stderr). Format ini adalah pengaturan default untuk parameter log_destination. Setiap pesan diawali menggunakan pola yang ditentukan dalam parameter log_line_prefix. Untuk mengetahui informasi selengkapnya, lihat Memahami parameter log_line_prefix.
Aurora PostgreSQL juga dapat menghasilkan log dalam format csvlog. csvlog berguna untuk menganalisis data log sebagai data nilai yang dipisahkan koma (CSV). Misalnya, anggaplah Anda menggunakan ekstensi log_fdw untuk bekerja dengan log Anda sebagai tabel asing. Tabel asing yang dibuat pada file log stderr berisi satu kolom dengan data peristiwa log. Dengan menambahkan csvlog ke parameter log_destination, Anda mendapatkan file log dalam format CSV dengan demarkasi untuk beberapa kolom tabel asing. Anda kini dapat mengurutkan dan menganalisis log dengan lebih mudah.
Jika Anda menentukan csvlog untuk parameter ini, perhatikan bahwa file stderr dan csvlog dihasilkan. Pastikan untuk memantau penyimpanan yang digunakan oleh log, dengan mempertimbangkan rds.log_retention_period dan pengaturan lain yang memengaruhi penyimpanan log dan omset. Menggunakan stderr dan csvlog lebih dari dua kali lipat penyimpanan yang digunakan oleh log.
Jika Anda menambahkan csvlog ke log_destination dan ingin kembali ke stderr sendiri, Anda perlu mengatur ulang parameter. Untuk melakukannya, buka Konsol Amazon RDS, lalu buka grup parameter klaster DB untuk instans Anda. Pilih parameter log_destination, pilih Edit parameter, lalu pilih Atur ulang.
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi pencatatan log, lihat Menggunakan log Amazon RDS dan Aurora PostgreSQL: Bagian 1
Memahami parameter log_line_prefix
Format log stderr mengawali setiap pesan log dengan detail yang ditentukan oleh parameter log_line_prefix, sebagai berikut.
%t:%r:%u@%d:[%p]:tAnda dapat mengubah pengaturan ini. Setiap entri log yang dikirim ke stderr berisi informasi berikut.
-
%t– Waktu entri log -
%r– Alamat host jarak jauh -
%u@%d– Nama pengguna @ nama basis data -
[%p]– ID Proses jika tersedia -
%l— Nomor baris log per sesi -
%e— Kode kesalahan SQL -
%s— Stempel waktu mulai proses -
%v— Id transaksi virtual -
%x— ID Transaksi -
%c— ID Sesi -
%q— Terminator non-sesi -
%a— Nama aplikasi
