Personaliza la instalación de AlloyDB Omni

Selecciona una versión de la documentación:

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

Habilita y inhabilita la telemetría de AlloyDB Omni

La telemetría de AlloyDB Omni implementa un agente cliente ligero que solo se ejecuta en la imagen de contenedor de AlloyDB Omni. Este agente recopila periódicamente un conjunto de métricas básicas y seudonimizadas, y las envía a un extremo administrado por Google.

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

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

Inhabilita los informes de telemetría

Para evitar que el agente de telemetría se ejecute y envíe 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 si estableces la marca de telemetría en el archivo postgresql.conf o si estableces la marca en el tiempo 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 en el directorio de datos persistentes de tu contenedor, sigue estos pasos:

  1. Ubica el archivo postgresql.conf en el directorio de datos de tu base de datos ($PGDATA).

  2. Inhabilita la telemetría de AlloyDB Omni.

    omni_enable_telemetry = off

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

Establece la marca de telemetría en el tiempo 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:

    psql -h HOST -U USER -d DATABASE

    Realiza los siguientes reemplazos:

    • HOST: Es el nombre de host o la dirección IP de tu instancia de AlloyDB Omni, por ejemplo, 127.0.0.1.
    • USER: Es el usuario de la base de datos al que deseas conectarte, por ejemplo, postgres.
    • DATABASE: Es la base de datos a la que deseas conectarte, por ejemplo, postgres.

  2. Ejecuta el siguiente comando:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Vuelve a cargar la configuración o reinicia la instancia. En algunas configuraciones de contenedores, es posible que debas reiniciar la instancia para asegurarte de que el trabajador en segundo plano detecte el cambio por completo.

    SELECT pg_reload_conf();

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

Habilita los informes de telemetría

Si inhabilitaste la telemetría de AlloyDB Omni, puedes volver a habilitarla si estableces la marca omni_enable_telemetry en on. Para habilitar el agente de telemetría, establece la marca en el archivo postgresql.conf o establece la marca en el tiempo 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 ($PGDATA).

  2. Establece la siguiente línea:

    omni_enable_telemetry = on

  3. Para aplicar el cambio, reinicia tu contenedor de AlloyDB Omni.

Establece la marca de telemetría en el tiempo de ejecución con ALTER SYSTEM

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

  2. Ejecuta el siguiente comando:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Para aplicar el cambio, reinicia tu contenedor de AlloyDB Omni.

    docker restart CONTAINER_NAME

    Realiza el siguiente reemplazo:

    • CONTAINER_NAME: Es el nombre de tu contenedor de AlloyDB Omni, por ejemplo, my-omni-1.

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 en ejecución. 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 de la configuración de telemetría, sigue estos pasos:

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

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

Verifica si el agente de telemetría está en ejecución

Para verificar si el agente de telemetría está en ejecución, ejecuta el siguiente comando en el host del contenedor:

docker top CONTAINER_NAME

Realiza el siguiente reemplazo:

  • CONTAINER_NAME: Es el nombre de tu contenedor de AlloyDB Omni, por ejemplo, my-omni-1.

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 del contenedor:

docker logs CONTAINER_NAME 2>&1 | grep telemetry

Realiza el siguiente reemplazo:

  • CONTAINER_NAME: Es el nombre de tu contenedor de AlloyDB Omni, por ejemplo, my-omni-1.

Si el agente de telemetría está en ejecución, 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

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

Reemplaza la siguiente variable:

  • CONTAINER_NAME: Es el nombre de tu contenedor de AlloyDB Omni, por ejemplo, my-omni-1.

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 extensiones

La lista de extensiones disponibles en AlloyDB Omni está disponible en Extensiones de base de datos compatibles. Aunque PostGIS y Orafce no se incluyen en AlloyDB Omni, se pueden instalar si sigues las instrucciones:

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