Mengonfigurasi rotasi log AlloyDB Omni
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Dokumen ini menjelaskan cara mengonfigurasi rotasi log diagnostik AlloyDB Omni saat Anda menggunakan operator AlloyDB Omni Kubernetes.

File log berikut berada 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:

File log disalin ke direktori /obs/diagnostic/archive/. Jika file log dengan nama yang sama ada di direktori tersebut, file tersebut akan ditimpa.
Isi file log asli yang dirotasi akan dihapus sehingga file tersebut kosong.
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.

Setiap file yang diarsipkan dikompresi satu per satu menggunakan format file Gzip (.gz).

File yang diarsipkan akan disimpan selama 7 hari. File yang diarsipkan dan sudah lebih dari 7 hari akan otomatis dihapus, kecuali file yang diarsipkan selama rotasi sebelumnya. Misalnya, jika log_rotation_age lebih lama dari 7 hari, file yang diarsipkan akan mencapai nilai minimum 7 hari sebelum rotasi file saat ini. Dalam hal ini, file yang diarsipkan ini tidak akan dihapus hingga rotasi berikutnya menghasilkan file yang diarsipkan baru.

Setiap nama file log yang diarsipkan mengikuti format ini: postgresql-%Y-%m-%d_%H%M%S.log.gz. Stempel waktu ditentukan pada saat rotasi log dan dinyatakan dalam Coordinated Universal Time (UTC). Misalnya, jika log dirotasi pada 13.01.02 20/12/2024 UTC, nama file yang diarsipkan adalah postgresql-2024-12-20_130102.log.gz.

Untuk menyimpan file yang diarsipkan secara permanen, Anda dapat menyalinnya dari penampung database ke direktori lokal menggunakan kubectl cp.

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 perlu mengaktifkan pgaudit.

Mengonfigurasi rotasi log

Jika Anda ingin lebih mengontrol kapan log dirotasi, 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

Mengonfigurasi rotasi log AlloyDB Omni Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.