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 menerapkan agen klien ringan yang hanya berjalan di image container AlloyDB Omni. Agen ini secara berkala mengumpulkan serangkaian metrik dasar yang bersifat pseudonim dan mengirimkannya ke endpoint yang dikelola Google.

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

Metrik yang dikumpulkan mencakup:

  • ID penginstalan unik (UUID yang dipseudonimkan)
  • Versi AlloyDB Omni dan versi utama PostgreSQL
  • Informasi sistem host seperti jumlah CPU, RAM, dan waktu aktif

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 menyetel flag telemetri di file postgresql.conf atau dengan menyetel flag saat runtime menggunakan ALTER SYSTEM.

Tetapkan tanda telemetri dalam file postgresql.conf

Untuk mengubah file konfigurasi PostgreSQL di direktori data persisten penampung, ikuti langkah-langkah berikut:

  1. Temukan file postgresql.conf di direktori data database Anda ($PGDATA).

  2. Menonaktifkan telemetri AlloyDB Omni.

    omni_enable_telemetry = off

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

Menetapkan flag telemetri saat runtime menggunakan ALTER SYSTEM

Untuk menyetel flag telemetri dan mempertahankan perubahan setelah dimulai ulang, ikuti langkah-langkah berikut:

  1. Hubungkan ke instance AlloyDB Omni menggunakan psql:

    psql -h HOST -U USER -d DATABASE

    Lakukan penggantian berikut:

    • HOST: nama host atau alamat IP instance AlloyDB Omni Anda—misalnya, 127.0.0.1.
    • USER: pengguna database yang ingin Anda gunakan untuk terhubung, misalnya, postgres.
    • DATABASE: database yang ingin Anda hubungkan—misalnya, postgres.

  2. Jalankan perintah berikut:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Muat ulang konfigurasi atau mulai ulang instance. Dalam beberapa penyiapan container, Anda mungkin perlu memulai ulang instance untuk memastikan perubahan sepenuhnya diambil oleh pekerja latar belakang.

    SELECT pg_reload_conf();

    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 menyetel flag omni_enable_telemetry ke on. Anda mengaktifkan agen telemetri dengan menyetel tanda di file postgresql.conf atau dengan menyetel tanda saat runtime menggunakan ALTER SYSTEM.

Tetapkan tanda telemetri dalam file postgresql.conf

  1. Temukan file postgresql.conf di direktori data database Anda ($PGDATA).

  2. Tetapkan baris berikut:

    omni_enable_telemetry = on

  3. Untuk menerapkan perubahan, mulai ulang container AlloyDB Omni Anda.

Menetapkan flag telemetri saat runtime menggunakan ALTER SYSTEM

  1. Hubungkan ke instance AlloyDB Omni menggunakan psql.

  2. Jalankan perintah berikut:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Untuk menerapkan perubahan, mulai ulang container AlloyDB Omni Anda.

    docker restart CONTAINER_NAME

    Lakukan penggantian berikut:

    • CONTAINER_NAME: Nama penampung AlloyDB Omni Anda—misalnya, my-omni-1.

Memeriksa status telemetri AlloyDB Omni

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

Memeriksa apakah agen telemetri diaktifkan atau dinonaktifkan

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

  1. Membuat koneksi ke instance.
  2. Jalankan perintah berikut:
SHOW omni_enable_telemetry;

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

Periksa apakah agen telemetri sedang berjalan

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

docker top CONTAINER_NAME

Lakukan penggantian berikut:

  • CONTAINER_NAME: Nama penampung AlloyDB Omni Anda—misalnya, my-omni-1.

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

docker logs CONTAINER_NAME 2>&1 | grep telemetry

Lakukan penggantian berikut:

  • CONTAINER_NAME: Nama penampung AlloyDB Omni Anda—misalnya, my-omni-1.

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.

Terhubung ke instance

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

Menghubungkan secara lokal

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Ganti variabel berikut:

  • CONTAINER_NAME: Nama penampung AlloyDB Omni Anda—misalnya, my-omni-1.

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 dapat dilihat di Ekstensi database yang didukung. Meskipun PostGIS dan Orafce tidak disertakan dengan AlloyDB Omni, keduanya dapat diinstal dengan mengikuti petunjuk:

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