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.
Cómo habilitar y, también, inhabilitar 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 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 son de información de identificación personal (IIP) 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.
Las métricas recopiladas incluyen lo siguiente:
- 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
Cómo 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 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.
Cómo establecer la marca de telemetría en el archivo postgresql.conf
Para modificar el archivo de configuración de PostgreSQL, sigue estos pasos:
- Ubica el archivo
postgresql.confen el directorio de datos de tu base de datos. De forma predeterminada, es/var/lib/postgresql/MAJOR_VERSION/data. Inhabilita la telemetría de AlloyDB Omni.
omni_enable_telemetry = off
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
Cómo establecer 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:
Conéctate a tu instancia de AlloyDB Omni con
psql:/usr/lib/postgresql/18/bin/psql -h localhost -U postgres
Ejecuta el siguiente comando:
ALTER SYSTEM SET omni_enable_telemetry = 'off';
Reinicia el servicio de base de datos para asegurarte de que el trabajador en segundo plano recoja el cambio por completo.
systemctl restart alloydbomni18
El agente de telemetría deja de recopilar y enviar métricas de uso a Google.
Cómo habilitar 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.
Cómo establecer la marca de telemetría en el archivo postgresql.conf
- Ubica el archivo
postgresql.confen el directorio de datos de tu base de datos. Establece la siguiente línea:
omni_enable_telemetry = on
Para aplicar el cambio, reinicia el servicio de AlloyDB Omni.
systemctl restart alloydbomni18
Cómo establecer la marca de telemetría en el tiempo de ejecución con ALTER SYSTEM
- Conéctate a tu instancia de AlloyDB Omni con
psql. Ejecuta el siguiente comando:
ALTER SYSTEM SET omni_enable_telemetry = 'on';
Para aplicar el cambio, reinicia el servicio de AlloyDB Omni.
systemctl restart alloydbomni18
Cómo verificar 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.
Cómo verificar si el agente de telemetría está habilitado o inhabilitado
Para verificar el estado de la configuración de telemetría, sigue estos pasos:
- Conectarte a la instancia
- 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.
Cómo verificar 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.
Cómo verificar 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.
Conectarte a la instancia
Según tu entorno, puedes conectarte a tu instancia de AlloyDB Omni de forma local o remota.
Cómo conectarte 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
Cómo conectarte 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.
Cómo habilitar 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 con 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.