Personaliza la instalación de AlloyDB Omni

Selecciona una versión de la documentación:

En esta página, se describe cómo personalizar la instalación de AlloyDB Omni, que admite diferentes formas de personalización. En esta página, se muestran algunas personalizaciones comunes.

Habilita e inhabilita la telemetría de AlloyDB Omni

La telemetría de AlloyDB Omni implementa un agente cliente ligero que recopila un conjunto de métricas básicas con seudónimos y las envía a un extremo administrado por Google.

Debido a que AlloyDB Omni es un producto descargable que se ofrece sin cargo, esta telemetría proporciona a Google métricas esenciales de información que no permite la identificación personal (no PII) sobre los entornos de adopción e implementación genéricos de las instancias en ejecución. Estos datos ayudan a fundamentar el desarrollo de productos y respaldar la priorización.

Entre las métricas recopiladas, se incluyen las siguientes:

  • ID de instalación único (UUID seudonimizado)
  • Versión de AlloyDB Omni y versión principal de PostgreSQL
  • Información del sistema host, como la cantidad de CPU, la RAM y el tiempo de actividad
  • Información de uso y configuración de la base de datos, incluidas las marcas de base de datos, los parámetros de configuración unificada general o GUC, y las estadísticas agregadas relacionadas con el uso de las funciones de AlloyDB Omni y las capacidades de la base de datos

Inhabilitar los informes de telemetría

Para evitar que el agente de telemetría se ejecute y genere informes de métricas de uso, establece el parámetro de configuración de PostgreSQL omni_enable_telemetry en off. Puedes inhabilitar el agente de telemetría configurando la marca de telemetría en el archivo postgresql.conf o configurando la marca en el entorno de ejecución con ALTER SYSTEM.

Establece la marca de telemetría en el archivo postgresql.conf

Para modificar el archivo de configuración de PostgreSQL, sigue estos pasos:

  1. Ubica el archivo postgresql.conf en el directorio de datos de tu base de datos. El valor predeterminado es /var/lib/postgresql/MAJOR_VERSION/data.

  2. Inhabilitar la telemetría de AlloyDB Omni

    omni_enable_telemetry = off

  3. Para aplicar el cambio, reinicia el servicio de AlloyDB Omni. El agente de telemetría deja de recopilar y enviar métricas de uso a Google.

    systemctl restart alloydbomniMAJOR_VERSION

Configura la marca de telemetría en el entorno de ejecución con ALTER SYSTEM

Para establecer la marca de telemetría y conservar el cambio en los reinicios, sigue estos pasos:

  1. Conéctate a tu instancia de AlloyDB Omni con psql:

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

  2. Ejecuta el comando siguiente:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Reinicia el servicio de la base de datos para asegurarte de que el trabajador en segundo plano detecte el cambio por completo.

    systemctl restart alloydbomni18

    El agente de telemetría deja de recopilar y enviar métricas de uso a Google.

Habilita los informes de telemetría

Si anteriormente inhabilitaste la telemetría de AlloyDB Omni, puedes volver a habilitarla configurando la marca omni_enable_telemetry como on. Para habilitar el agente de telemetría, configura la marca en el archivo postgresql.conf o en el entorno de ejecución con ALTER SYSTEM.

Establece la marca de telemetría en el archivo postgresql.conf

  1. Ubica el archivo postgresql.conf en el directorio de datos de tu base de datos.

  2. Establece la siguiente línea:

    omni_enable_telemetry = on

  3. Para aplicar el cambio, reinicia el servicio de AlloyDB Omni.

    systemctl restart alloydbomni18

Configura la marca de telemetría en el entorno de ejecución con ALTER SYSTEM

  1. Conéctate a tu instancia de AlloyDB Omni con psql.

  2. Ejecuta el comando siguiente:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Para aplicar el cambio, reinicia el servicio de AlloyDB Omni.

    systemctl restart alloydbomni18

Verifica el estado de la telemetría de AlloyDB Omni

Puedes verificar el estado del agente de telemetría de AlloyDB Omni, incluido si está habilitado o inhabilitado. También puedes verificar la actividad del agente de telemetría.

Verifica si el agente de telemetría está habilitado o inhabilitado

Para verificar el estado del parámetro de configuración de telemetría, sigue estos pasos:

  1. Conectarte a la instancia
  2. Ejecuta lo siguiente:
SHOW omni_enable_telemetry;

El resultado devuelve on o off, según si inhabilitaste o habilitaste la telemetría de AlloyDB Omni.

Verifica si el agente de telemetría se está ejecutando

Para verificar si el agente de telemetría se está ejecutando, ejecuta el siguiente comando en el host:

ps -ef | grep "omni telemetry worker"

Si la telemetría está habilitada y en ejecución, el resultado contiene una línea con el texto postgres: omni telemetry worker.

Verifica la actividad del agente de telemetría

Para verificar la actividad del agente de telemetría, ejecuta el siguiente comando en el host:

journalctl -u alloydbomni18 | grep telemetry

Si el agente de telemetría se está ejecutando, los registros contienen mensajes similares a los siguientes:

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.

Conéctate a la instancia

Según tu entorno, puedes conectarte a tu instancia de AlloyDB Omni de forma local o remota.

Conéctate de forma local

Para conectarte a tu instancia de AlloyDB Omni de forma local, ejecuta el siguiente comando:

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

Conéctate de forma remota

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

Reemplaza las siguientes variables:

  • HOST_PORT: Es el puerto TCP que usaste durante la instalación.
  • IP_ADDRESS_OR_FQDN: Es la dirección IP o el nombre de dominio completamente calificado del host en el que se ejecuta AlloyDB Omni.

Habilita las extensiones

La lista de extensiones disponibles en AlloyDB Omni se encuentra en Extensiones de base de datos compatibles. Aunque PostGIS y Orafce no se incluyen en AlloyDB Omni, ambos se pueden instalar siguiendo las instrucciones que se indican a continuación:

Las extensiones instaladas se habilitan con las declaraciones CREATE EXTENSION estándar de PostgreSQL, como se detalla en Habilita una extensión.