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 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 y seudónimas, y las envía a un extremo administrado por Google.
Dado que AlloyDB Omni es un producto descargable que se ofrece sin cargo, esta telemetría proporciona a Google métricas esenciales de información no personal (no PII) sobre los entornos genéricos de adopción y de implementación de las instancias en ejecución. Estos datos ayudan a fundamentar 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 genere informes sobre las 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 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 comando siguiente:
ALTER SYSTEM SET omni_enable_telemetry = 'off';
Reinicia el servicio de la base de datos para asegurarte de que el trabajador en segundo plano capte 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 en on. Para habilitar el agente de telemetría, configura la marca en el archivo postgresql.conf o 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 comando siguiente:
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 del parámetro de 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.
Comprueba si el agente de telemetría está en ejecución
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.
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: Dirección IP o nombre de dominio completamente calificado del host en el que se ejecuta AlloyDB Omni.
Habilitar extensiones
La lista de extensiones disponibles en AlloyDB Omni se encuentra en Extensiones de bases de datos compatibles. Si bien 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 instrucciones CREATE EXTENSION estándar de PostgreSQL, como se detalla en Cómo habilitar una extensión.