Mengonfigurasi rotasi log AlloyDB Omni

Dokumen ini menjelaskan cara mengonfigurasi kapan log diagnostik operator Kubernetes AlloyDB Omni dirotasi. Ada dua file log yang terletak di direktori /obs/diagnostic/:

  • postgresql.audit: File log ini mengumpulkan log audit akses sesi dan objek. Untuk mengumpulkan log audit, Anda harus mengaktifkan log audit.

  • postgresql.log: File log ini mengumpulkan log server PostgreSQL. Log ini selalu dikumpulkan dan tidak perlu diaktifkan.

Saat file log dirotasi, hal berikut akan terjadi:

  1. File log disalin ke direktori /obs/diagnostic/archive/. Jika file log dengan nama yang sama ada di direktori tersebut, file tersebut akan ditimpa.

  2. Isi file log asli yang dirotasi akan dihapus sehingga file tersebut kosong.

  3. Informasi log akan segera mulai ditulis ke file log yang dirotasi dan kosong. Informasi log ditulis ke file log hingga file mencapai batas ukuran atau usia, pada saat file dirotasi lagi. Log dirotasi agar tidak terlalu besar.

Secara default, setelan rotasi adalah agar setiap file log dirotasi saat ukurannya mencapai 200 MB. Rotasi default tidak menyertakan setelan usia.

Mengaktifkan log audit

Agar log akses sesi dan objek dikumpulkan dalam file postgresql.audit, Anda perlu mengaktifkan parameter database pgaudit. Untuk mengaktifkan pgaudit, tambahkan baris berikut ke bagian parameters pada file v1_dbcluster_parameters.yaml di bagian Secret:

alloydb.enable_pgaudit: "on"

Berikut adalah contoh tampilannya: 

apiVersion: v1
kind: Secret
...
apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
   name: DB_CLUSTER_NAME
spec:
  databaseVersion: "15.7.0"
  primarySpec:
    ...
    parameters:
      ...
      alloydb.enable_pgaudit: "on"

Untuk informasi selengkapnya, lihat pgaudit di Ekstensi database yang didukung, dan Ekstensi Audit PostgreSQL. Log server PostgreSQL selalu dikumpulkan dalam file postgresql.log dan tidak memerlukan pengaktifan pgaudit.

Mengonfigurasi rotasi log

Jika Anda ingin memiliki lebih banyak kontrol atas waktu rotasi log, konfigurasikan ukuran file maksimum, durasi antara rotasi log, atau keduanya. Durasi antara rotasi log juga disebut usia log. Jika Anda menggunakan kedua setelan tersebut, setiap log akan dirotasi saat mencapai salah satu nilai minimum.

Untuk mengonfigurasi rotasi log, Anda menetapkan satu atau kedua parameter berikut di bagian parameters manifes DBCluster:

  • log_rotation_size: "SIZE_IN_KB"
  • log_rotation_age: "AGE_IN_MINUTES"

Untuk menonaktifkan salah satu setelan rotasi log, tetapkan ke nol ("0"). Untuk mempertahankan setelan default yang memutar log saat ukuran filenya mencapai 200 MB, jangan tetapkan salah satu parameter.

Contoh ukuran dan durasi log maksimum rotasi log

Contoh berikut menetapkan log untuk dirotasi saat ukuran filenya mencapai 400 MB atau saat waktu antara rotasi log mencapai satu hari, mana saja yang terjadi lebih dulu:

apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
...
  primarySpec:
  ...
    parameters:
      log_rotation_size: "400000" # 400 MB
      log_rotation_age: "1440" # 24 hours * 60 minutes = 1 day

Contoh ukuran log maksimum rotasi log

Contoh berikut menetapkan log untuk dirotasi saat ukuran filenya mencapai 400 MB:

apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
...
  primarySpec:
  ...
    parameters:
      log_rotation_size: "400000" # 400 MB
      log_rotation_age: "0" # Set to 0 to disable

Contoh durasi rotasi log

Contoh berikut menetapkan log untuk dirotasi setiap 24 jam sekali:

apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: DB_CLUSTER_NAME
spec:
...
  primarySpec:
  ...
    parameters:
      log_rotation_size: "0" # Set to 0 to disable
      log_rotation_age: "1440" # 24 hours * 60 minutes = 1 day

Langkah selanjutnya