- Amazon Aurora

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Anda dapat menyesuaikan perilaku logging untuk cluster RDS Aurora Postgre SQL DB Anda untuk instans Postgre DB dengan parameter. Dalam tabel berikut, Anda dapat menemukan parameter yang memengaruhi berapa lama log disimpan, kapan harus memutar log, dan apakah akan menampilkan log sebagai format CSV (nilai yang dipisahkan koma). Anda juga dapat menemukan output teks yang dikirim keSTDERR, di antara pengaturan lainnya. Untuk mengubah pengaturan parameter yang dapat dimodifikasi, gunakan grup parameter DB cluster DB kustom untuk cluster Aurora Postgre Anda. SQL Untuk mengetahui informasi selengkapnya, lihat . Seperti disebutkan dalam tabel, log_line_prefix tidak dapat diubah.

Parameter Default Deskripsi

log_destination

stderr

Menetapkan format output untuk log. Defaultnya adalah stderr tetapi Anda juga dapat menentukan nilai dipisahkan koma (CSV) dengan menambahkan csvlog ke pengaturan. Untuk informasi selengkapnya, silakan lihat Mengatur tujuan log (stderr, csvlog)

log_filename

postgresql.log.%Y-%m-%d-%H%M

Menentukan pola untuk nama file log. Selain default, parameter ini mendukung postgresql.log.%Y-%m-%d dan postgresql.log.%Y-%m-%d-%H untuk pola nama file.

log_line_prefix

%t:%r:%u@%d:[%p]:

Mendefinisikan awalan untuk setiap baris log yang akan ditulis ke stderr, untuk mencatat waktu (%t), host jarak jauh (%r), pengguna (%u), basis data (%d), dan ID proses (%p). Anda tidak dapat mengubah parameter ini.

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

SQLLog postgre yang lebih tua dari jumlah menit yang ditentukan akan 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, 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 .

Dalam topik berikut, Anda dapat menemukan informasi tentang cara mengatur berbagai parameter yang mengontrol detail dasar untuk log Postgre SQL Anda.

Mengatur periode retensi log

rds.log_retention_periodParameter menentukan berapa lama . 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 cluster Aurora Postgre SQL DB Anda memiliki penyimpanan yang cukup untuk menyimpan file log untuk jangka 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 Aurora Postgre DB Anda. SQL Untuk mengetahui informasi selengkapnya, lihat Menerbitkan log Aurora Postgre ke Amazon Logs SQL CloudWatch . Setelah Anda mengatur CloudWatch penerbitan, Aurora tidak menghapus log sampai setelah diterbitkan ke CloudWatch Log.

Amazon Aurora mengompres SQL log Postgre yang lebih lama saat 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 penyimpanan tidak cukup, Aurora mungkin menghapus SQL log Postgre 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). log_rotation_sizeDefaultnya adalah 100000 kB (kilobyte) untuk cluster Aurora Postgre SQL DB, tetapi Anda dapat mengatur nilai ini ke mana saja 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 informasi lebih lanjut, lihat log_rotation_agedan log_rotation_sizedi dokumentasi PostgreSQL.

Mengatur tujuan log (stderr, csvlog)

Secara default, Aurora Postgre SQL 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 informasi selengkapnya, lihat Memahami parameter log_line_prefix.

Aurora Postgre SQL juga SQL dapat menghasilkan log dalam format. csvlog csvlogHal ini berguna untuk menganalisis data log sebagai nilai dipisahkan koma (CSV) data. 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 log_destination parameter, Anda mendapatkan file log dalam CSV format 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 Amazon RDS Console lalu buka grup parameter DB cluster kustom untuk instans Anda. Pilih parameter log_destination, pilih Edit parameter, lalu pilih Atur ulang.

Untuk informasi selengkapnya tentang mengonfigurasi logging, lihat Bekerja dengan log Amazon RDS dan Aurora SQL Postgre: 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]:t

Anda 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