Parameter untuk masuk RDS SQL - Layanan Basis Data Relasional Amazon

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

Parameter untuk masuk RDS SQL

Anda dapat menyesuaikan perilaku logging untuk dengan memodifikasi berbagai SQL 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 Postgre Anda. SQL RDSuntuk contoh PostgreSQL. Untuk mengetahui informasi selengkapnya, lihat Grup parameter DB untuk instans RDSAmazon DB Amazon. 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

Menentukan pola untuk nama file log. Selain default, parameter ini mendukung postgresql.log.%Y-%m-%d 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. Secara default, parameter ini tidak digunakan karena log diputar berdasarkan log_rotation_age parameter. 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 Mengaktifkan pencatatan kueri untuk SQL.

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 RDScluster menyimpan SQL file lognya. 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 Anda RDSuntuk instans Postgre SQL DB 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 Postgre DB Anda. SQL RDSuntuk contoh Postgre SQL DB. Untuk mengetahui informasi selengkapnya, lihat Menerbitkan log Postgre ke Amazon SQL Logs CloudWatch . .

Mengatur rotasi file log

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). Untuk instance RDS untuk Postgre SQL DB, tidak log_rotation_size disetel, yaitu, tidak ada nilai yang ditentukan. Namun, Anda dapat mengatur parameter dari 0-2097151 kB (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.

Untuk informasi lebih lanjut, lihat log_rotation_agedan log_rotation_sizedi dokumentasi PostgreSQL.

Mengatur tujuan log (stderr, csvlog)

Secara default, 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.

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. Untuk mempelajari cara menggunakan log_fdw dengan csvlog, lihat Menggunakan ekstensi log_fdw untuk mengakses log DB menggunakan SQL.

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