Mengunduh PostgreSQL dan meningkatkan log

Anda dapat menggunakan log server PostgreSQL untuk mendiagnosis masalah tertentu yang dialami dalam instans server fleksibel Azure Database for PostgreSQL, dan untuk mendapatkan wawasan terperinci tentang aktivitas yang berjalan di server Anda. Anda dapat menggunakan log peningkatan versi utama untuk memecahkan masalah kesalahan yang mungkin terjadi selama upaya untuk meningkatkan server Anda ke versi utama PostgreSQL yang lebih tinggi.

Secara default, pengambilan log server yang dapat diunduh pada instans server fleksibel Azure Database untuk PostgreSQL dinonaktifkan. Namun, setelah Anda mengaktifkan fitur, instans server fleksibel Azure Database for PostgreSQL Anda mulai menangkap log server ke file, yang dapat Anda unduh untuk inspeksi terperinci. Anda dapat menggunakan portal Microsoft Azure atau perintah Azure CLI untuk mencantumkan dan mengunduh file-file ini yang dapat membantu Anda dengan upaya pemecahan masalah apa pun.

Artikel ini menjelaskan cara mengaktifkan dan menonaktifkan fitur. Ini juga menjelaskan bagaimana Anda dapat mencantumkan semua log server yang tersedia, dan bagaimana Anda dapat mengunduh salah satunya.

Langkah-langkah untuk mengaktifkan penangkapan log PostgreSQL dan memperbarui log untuk diunduh

Portal

Menggunakan portal Microsoft Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah bagian Pemantauan , pilih Log server.

   

3. Tandai kotak centang Menangkap log untuk diunduh.

   

4. Secara default, file log disimpan selama tiga hari, tetapi Anda dapat menyesuaikan periode retensi dari 1 hingga 7 hari. Gunakan pengatur Periode retensi log (dalam hari) untuk menyesuaikan dengan konfigurasi yang Anda inginkan.

   

5. Pilih tombol Simpan .

   

6. Pemberitahuan memberi tahu Anda bahwa layanan sedang mengonfigurasi proses pencatatan log untuk diunduh.

   

7. Setelah operasi berakhir, pemberitahuan memberi tahu Anda bahwa layanan menyelesaikan konfigurasi pengambilan log untuk diunduh.

   

CLI

Anda dapat mengaktifkan pengambilan log server PostgreSQL dan log peningkatan versi utama melalui perintah az postgres flexible-server parameter set .

Untuk mengaktifkan pengambilan log untuk diunduh, gunakan perintah ini:

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.download_enable \
  --value on

Untuk menyesuaikan periode retensi log yang diambil untuk diunduh, gunakan perintah ini:

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.retention_days \
  --value <retention_period_in_days>

Nilai yang diizinkan untuk parameter logfiles.retention_days server bisa antara 1 dan 7 hari. Jika Anda mencoba mengaturnya ke nilai yang berbeda, Anda mendapatkan kesalahan ini:

Code: ServerParameterToCMSUnAllowedParameterValue
Message: The value: [<value>] of Server Parameter: [logfiles.retention_days] is invalid, the allowed values are: [1-7]

Note

• Beberapa menit setelah mengaktifkan pengambilan log server untuk diunduh, log pertama akan tersedia untuk diunduh.

• Awalnya, dan selama sekitar satu jam, log server menempati ruang disk data. Kemudian, mereka dipindahkan ke penyimpanan cadangan dan disimpan di sana untuk periode retensi yang dikonfigurasi.

Langkah-langkah untuk menonaktifkan pengambilan PostgreSQL dan meningkatkan log untuk diunduh

Portal

Menggunakan portal Microsoft Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah bagian Pemantauan , pilih Log server.

   

3. Kosongkan kotak centang Tangkap log untuk diunduh.

   

4. Pilih tombol Simpan .

   

5. Pemberitahuan memberi tahu Anda bahwa layanan sedang mengonfigurasi proses pencatatan log untuk diunduh.

   

6. Setelah operasi berakhir, pemberitahuan memberi tahu Anda bahwa layanan menyelesaikan konfigurasi pengambilan log untuk diunduh.

   

CLI

Anda dapat menonaktifkan pengambilan log server PostgreSQL dan log peningkatan versi utama melalui perintah az postgres flexible-server parameter set .

Untuk menonaktifkan pengambilan log untuk diunduh, gunakan perintah ini:

az postgres flexible-server parameter \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.download_enable \
  --value off

Langkah-langkah untuk mencantumkan log yang diambil yang tersedia untuk diunduh

Portal

Menggunakan portal Microsoft Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah bagian Pemantauan , pilih Log server.

   

3. Tabel memperlihatkan semua file log yang diambil yang belum dihapus. File yang diambil pada beberapa titik, tetapi dihapus karena melebihi periode retensi yang dikonfigurasi, tidak terlihat atau dapat diakses lagi. Menggunakan kotak Cari file dengan nama yang berisi, Rentang waktu, dan Jenis log , Anda dapat menentukan kondisi pemfilteran untuk mengurangi log yang ditampilkan. Dengan memilih header kolom, Anda dapat mengurutkan daftar file log yang terlihat, dalam urutan naik atau menurun, berdasarkan nilai atribut yang diwakili oleh header yang dipilih. Di bawah setiap kolom yang tersedia, Anda dapat melihat atribut yang berbeda dari setiap file:

   • Nama: Nama file log. Layanan menetapkan setiap file log nama dengan pola postgresql_yyyy_mm_dd_hh_00_00.logini .
   • Waktu pembaruan terakhir: Tanda waktu terakhir kali setiap file log diunggah. File log diunggah, kira-kira, setiap 10 menit.
   • Ukuran: Ukuran dalam byte yang ditempati oleh file log.
   • Jenis log: Log server menunjukkan file sesuai dengan log server PostgreSQL. Log upgrade menandakan bahwa file merupakan log upgrade versi utama.

   

4. Konten tabel tidak diperbarui secara otomatis. Untuk melihat informasi terbaru, Anda dapat memilih Refresh.

   

CLI

Anda dapat mencantumkan log server PostgreSQL yang diambil dan log peningkatan versi utama melalui perintah az postgres flexible-server server-logs list .

Untuk mencantumkan semua log yang diambil yang tersedia untuk diunduh, yang diperbarui dalam 72 jam terakhir (nilai default), gunakan perintah ini:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server>

Untuk mencantumkan semua log yang diambil yang tersedia untuk diunduh, yang diperbarui dalam 10 jam terakhir, gunakan perintah ini:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --file-last-written 10

Untuk mencantumkan semua log yang diambil yang tersedia untuk diunduh, yang ukurannya di bawah 30 KiB, gunakan perintah ini:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --max-file-size 30

Untuk mencantumkan semua log yang diambil yang tersedia untuk diunduh, yang namanya berisi 01_07, gunakan perintah ini:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --filename-contains 01_07

Langkah-langkah untuk mengunduh log yang diambil

Portal

Menggunakan portal Microsoft Azure:

1. Pilih server fleksibel instans Azure Database untuk PostgreSQL Anda.

2. Di menu sumber daya, di bawah bagian Pemantauan , pilih Log server.

   

3. Tabel memperlihatkan semua file log yang diambil yang belum dihapus. File yang diambil pada beberapa titik, tetapi dihapus karena melebihi periode retensi yang dikonfigurasi, tidak terlihat atau dapat diakses lagi. Menggunakan kotak Cari file dengan nama yang berisi, Rentang waktu, dan Jenis log , Anda dapat menentukan kondisi pemfilteran untuk mengurangi log yang ditampilkan. Dengan memilih header kolom, Anda dapat mengurutkan daftar file log yang terlihat, dalam urutan naik atau menurun, berdasarkan nilai atribut yang diwakili oleh header yang dipilih. Identifikasi log yang ingin Anda unduh dan, di bawah kolom Tindakan , pilih Unduh.

   

4. Jika Anda ingin mengunduh beberapa file log sekaligus, pilih semua file yang ingin Anda unduh, dan pilih Unduh di toolbar.

   

5. Konten tabel tidak diperbarui secara otomatis. Untuk melihat informasi terbaru, Anda dapat memilih Refresh.

   

CLI

Anda dapat mengunduh log server PostgreSQL yang diambil dan log peningkatan versi utama melalui perintah az postgres flexible-server-logs download .

Untuk mengunduh satu log tertentu, gunakan perintah ini:

az postgres flexible-server server-logs download \
  --resource-group <resource_group> \
  --server-name <server> \
  --name <log_name>

Untuk mengunduh satu log tertentu, gunakan perintah ini:

az postgres flexible-server server-logs download \
  --resource-group <resource_group> \
  --server-name <server> \
  --name <log1_name log2_name ...logn_name>

Note

• Untuk nama file yang disediakan di mana ada file log dengan nama yang cocok yang tersedia untuk diunduh, file lokal dibuat dengan nama dan konten yang sama.

• Jika salah satu nama file yang disediakan tidak tersedia untuk diunduh, perintah tidak melaporkan kesalahan apa pun. Ini hanya tidak mengunduh file itu.

Konten terkait

• Mengonfigurasi ketersediaan yang tinggi.
• Mengonfigurasi pemeliharaan terjadwal.
• Buat pemberitahuan pada metrik menggunakan portal.