Personalizar a instalação do AlloyDB Omni

Selecione uma versão da documentação:

Esta página descreve como personalizar a instalação do AlloyDB Omni, que oferece suporte a diferentes formas de personalização. Esta página mostra algumas personalizações comuns.

Ativar e desativar a telemetria do AlloyDB Omni

A telemetria do AlloyDB Omni implementa um agente de cliente leve que coleta um conjunto de métricas básicas e pseudônimas e as envia para um endpoint gerenciado pelo Google.

Como o AlloyDB Omni é um produto para download oferecido sem custos financeiros, essa telemetria fornece ao Google métricas essenciais sem PII sobre a adoção genérica e os ambientes de implantação de instâncias em execução. Esses dados ajudam a informar o desenvolvimento de produtos e a priorização do suporte.

As métricas coletadas incluem o seguinte:

  • ID de instalação exclusivo (UUID pseudonimizado)
  • Versão principal do AlloyDB Omni e do PostgreSQL
  • Informações do sistema host, como contagem de CPU, RAM e tempo de atividade

Desativar a geração de relatórios de telemetria

Para impedir que o agente de telemetria execute e relate métricas de uso, defina o parâmetro de configuração do PostgreSQL omni_enable_telemetry como off. É possível desativar o agente de telemetria definindo a flag de telemetria no arquivo postgresql.conf ou definindo a flag no ambiente de execução usando ALTER SYSTEM.

Definir a flag de telemetria no arquivo postgresql.conf

Para modificar o arquivo de configuração do PostgreSQL, siga estas etapas:

  1. Localize o arquivo postgresql.conf no diretório de dados do banco de dados. Por padrão, ele é /var/lib/postgresql/MAJOR_VERSION/data.

  2. Desative a telemetria do AlloyDB Omni.

    omni_enable_telemetry = off

  3. Para aplicar a mudança, reinicie o serviço do AlloyDB Omni. O agente de telemetria para de coletar e enviar métricas de uso ao Google.

    systemctl restart alloydbomniMAJOR_VERSION

Definir a flag de telemetria no ambiente de execução usando ALTER SYSTEM

Para definir a flag de telemetria e manter a mudança nas reinicializações, siga estas etapas:

  1. Conecte-se à instância do AlloyDB Omni usando psql:

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

  2. Execute este comando:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. Reinicie o serviço de banco de dados para garantir que a mudança seja totalmente selecionada pelo worker em segundo plano.

    systemctl restart alloydbomni18

    O agente de telemetria para de coletar e enviar métricas de uso ao Google.

Ativar a geração de relatórios de telemetria

Se você desativou a telemetria do AlloyDB Omni, é possível reativá-la definindo a flag omni_enable_telemetry como on. Ative o agente de telemetria definindo a flag no arquivo postgresql.conf ou definindo a flag no ambiente de execução usando ALTER SYSTEM.

Definir a flag de telemetria no arquivo postgresql.conf

  1. Localize o arquivo postgresql.conf no diretório de dados do banco de dados.

  2. Defina a seguinte linha:

    omni_enable_telemetry = on

  3. Para aplicar a mudança, reinicie o serviço do AlloyDB Omni.

    systemctl restart alloydbomni18

Definir a flag de telemetria no ambiente de execução usando ALTER SYSTEM

  1. Conecte-se à instância do AlloyDB Omni usando psql.

  2. Execute este comando:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. Para aplicar a mudança, reinicie o serviço do AlloyDB Omni.

    systemctl restart alloydbomni18

Verificar o status da telemetria do AlloyDB Omni

É possível verificar o status do agente de telemetria do AlloyDB Omni, incluindo se ele está ativado ou desativado. Também é possível verificar a atividade do agente de telemetria.

Verificar se o agente de telemetria está ativado ou desativado

Para verificar o status da configuração de telemetria, siga estas etapas:

  1. Conecte-se à instância.
  2. Execute o comando a seguir:
SHOW omni_enable_telemetry;

A saída retorna on ou off, dependendo se você desativou ou ativou a telemetria do AlloyDB Omni.

Verificar se o agente de telemetria está em execução

Para verificar se o agente de telemetria está em execução, execute o seguinte comando no host:

ps -ef | grep "omni telemetry worker"

Se a telemetria estiver ativada e em execução, a saída vai conter uma linha com o texto postgres: omni telemetry worker.

Verificar a atividade do agente de telemetria

Para verificar a atividade do agente de telemetria, execute o seguinte comando no host:

journalctl -u alloydbomni18 | grep telemetry

Se o agente de telemetria estiver em execução, os registros vão conter mensagens semelhantes a estas:

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.

Conectar-se à instância

Dependendo do seu ambiente, é possível se conectar à sua instância do AlloyDB Omni local ou remotamente.

Conectar-se localmente

Para se conectar à instância do AlloyDB Omni localmente, execute o seguinte comando:

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

Conectar-se remotamente

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

Substitua as seguintes variáveis:

  • HOST_PORT: porta TCP usada durante a instalação.
  • IP_ADDRESS_OR_FQDN: endereço IP ou nome de domínio totalmente qualificado do host em que o AlloyDB Omni está em execução.

Ativar extensões

A lista de extensões disponíveis no AlloyDB Omni está disponível em Extensões de banco de dados compatíveis. Embora o PostGIS e o Orafce não estejam incluídos no AlloyDB Omni, eles podem ser instalados seguindo as instruções:

As extensões instaladas são ativadas usando instruções CREATE EXTENSION padrão do PostgreSQL, conforme detalhado em Ativar uma extensão.