Menyesuaikan penginstalan AlloyDB Omni

Pilih versi dokumentasi:

Halaman ini menjelaskan cara menyesuaikan penginstalan AlloyDB Omni, yang mendukung berbagai bentuk penyesuaian. Halaman ini menampilkan beberapa penyesuaian umum.

Mengaktifkan dan menonaktifkan telemetri AlloyDB Omni

Telemetri AlloyDB Omni mengimplementasikan agen klien ringan yang mengumpulkan sekumpulan metrik dasar dan pseudonim serta mengirimkannya ke endpoint yang dikelola Google.

Karena AlloyDB Omni adalah produk yang dapat didownload dan ditawarkan tanpa biaya, telemetri ini memberi Google metrik informasi non-identitas pribadi (non-PII) penting terkait lingkungan adopsi dan deployment generik dari instance yang berjalan. Data ini membantu menginformasikan pengembangan produk dan prioritas dukungan.

Metrik yang dikumpulkan mencakup hal berikut:

  • ID penginstalan unik (UUID yang dipseudonimkan)
  • Versi AlloyDB Omni dan versi utama PostgreSQL
  • Informasi sistem host seperti jumlah CPU, RAM, dan waktu aktif
  • Informasi konfigurasi database dan penggunaan fitur termasuk flag database, parameter Grand Unified Configuration atau GUC, dan statistik gabungan terkait penggunaan fitur AlloyDB Omni dan kemampuan database

Menonaktifkan pelaporan telemetri

Untuk mencegah agen telemetri berjalan dan melaporkan metrik penggunaan, tetapkan parameter konfigurasi PostgreSQL omni_enable_telemetry ke off. Anda dapat menonaktifkan agen telemetri dengan menetapkan flag telemetri dalam file postgresql.conf atau dengan menetapkan flag saat runtime menggunakan ALTER SYSTEM.

Menetapkan flag telemetri dalam file postgresql.conf

Untuk mengubah file konfigurasi PostgreSQL, ikuti langkah-langkah berikut:

  1. Temukan file postgresql.conf di direktori data database Anda. Secara default, ini adalah /var/lib/postgresql/MAJOR_VERSION/data.

  2. Nonaktifkan telemetri AlloyDB Omni.

    omni_enable_telemetry = off

  3. Untuk menerapkan perubahan, mulai ulang layanan AlloyDB Omni. Agen telemetri berhenti mengumpulkan dan mengirim metrik penggunaan ke Google.

    systemctl restart alloydbomniMAJOR_VERSION

Menetapkan flag telemetri saat runtime menggunakan ALTER SYSTEM

Untuk menetapkan flag telemetri dan mempertahankan perubahan di seluruh proses memulai ulang, ikuti langkah-langkah berikut:

  1. Hubungkan ke instance AlloyDB Omni Anda menggunakan psql:

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

  2. Jalankan perintah berikut:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Mulai ulang layanan database untuk memastikan perubahan sepenuhnya diambil oleh pekerja latar belakang.

    systemctl restart alloydbomni18

    Agen telemetri berhenti mengumpulkan dan mengirim metrik penggunaan ke Google.

Mengaktifkan pelaporan telemetri

Jika sebelumnya Anda menonaktifkan telemetri AlloyDB Omni, Anda dapat mengaktifkannya kembali dengan menetapkan flag omni_enable_telemetry ke on. Anda mengaktifkan agen telemetri dengan menetapkan flag dalam file postgresql.conf atau dengan menetapkan flag saat runtime menggunakan ALTER SYSTEM.

Menetapkan flag telemetri dalam file postgresql.conf

  1. Temukan file postgresql.conf di direktori data database Anda.

  2. Tetapkan baris berikut:

    omni_enable_telemetry = on

  3. Untuk menerapkan perubahan, mulai ulang layanan AlloyDB Omni.

    systemctl restart alloydbomni18

Menetapkan flag telemetri saat runtime menggunakan ALTER SYSTEM

  1. Hubungkan ke instance AlloyDB Omni Anda menggunakan psql.

  2. Jalankan perintah berikut:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Untuk menerapkan perubahan, mulai ulang layanan AlloyDB Omni.

    systemctl restart alloydbomni18

Memeriksa status telemetri AlloyDB Omni

Anda dapat memeriksa status agen telemetri AlloyDB Omni, termasuk apakah agen tersebut diaktifkan atau dinonaktifkan. Anda juga dapat memeriksa aktivitas agen telemetri.

Memeriksa apakah agen telemetri diaktifkan atau dinonaktifkan

Untuk memeriksa status setelan telemetri, ikuti langkah-langkah berikut:

  1. Hubungkan ke instance Anda.
  2. Jalankan perintah berikut:
SHOW omni_enable_telemetry;

Output menampilkan on atau off, bergantung pada apakah Anda menonaktifkan atau mengaktifkan telemetri AlloyDB Omni.

Memeriksa apakah agen telemetri berjalan

Untuk memeriksa apakah agen telemetri berjalan, jalankan perintah berikut di host:

ps -ef | grep "omni telemetry worker"

Jika telemetri diaktifkan dan berjalan, output akan berisi baris dengan teks postgres: omni telemetry worker.

Memeriksa aktivitas agen telemetri

Untuk memeriksa aktivitas agen telemetri, jalankan perintah berikut di host:

journalctl -u alloydbomni18 | grep telemetry

Jika agen telemetri berjalan, log akan berisi pesan yang mirip dengan berikut ini:

LOG:  [telemetry_agent_worker.cc:143]  Started telemetry worker
LOG:  [telemetry_agent_worker.cc:161]  Running telemetry reporting agent
telemetry_agent: Uploading telemetry data to https://cloud.google.com/log.

Menghubungkan ke instance

Bergantung pada lingkungan Anda, Anda dapat menghubungkan ke instance AlloyDB Omni secara lokal atau jarak jauh.

Menghubungkan secara lokal

Untuk menghubungkan ke instance AlloyDB Omni Anda secara lokal, jalankan perintah berikut:

/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h localhost

Menghubungkan dari jarak jauh

/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN

Ganti variabel berikut:

  • HOST_PORT: Port TCP yang Anda gunakan selama penginstalan.
  • IP_ADDRESS_OR_FQDN: Alamat IP atau nama domain yang sepenuhnya memenuhi syarat untuk host tempat AlloyDB Omni berjalan.

Mengaktifkan ekstensi

Daftar ekstensi yang tersedia di AlloyDB Omni tersedia di Ekstensi database yang didukung. Meskipun PostGIS dan Orafce tidak disertakan dengan AlloyDB Omni, keduanya dapat diinstal dengan mengikuti petunjuk berikut:

Ekstensi yang diinstal diaktifkan menggunakan CREATE EXTENSION pernyataan PostgreSQL standar seperti yang dijelaskan dalam Mengaktifkan ekstensi.