Gerenciar e monitorar o AlloyDB Omni

Selecione uma versão da documentação:

Nesta página, descrevemos como gerenciar as funções de usuário do AlloyDB Omni, monitorar a atividade do servidor do AlloyDB Omni e atualizar ou remover a instalação do AlloyDB Omni.

Gerenciar funções do usuário

O AlloyDB Omni usa as seguintes funções:

  • O AlloyDB Omni inclui uma função de superusuário chamada alloydbadmin e uma função de não superusuário chamada alloydbmetadata.

  • O usuário postgres padrão tem uma função de superusuário.

  • Todos os outros papéis de usuário predefinidos não têm privilégios. Eles são reservados para possíveis usos no futuro.

Configurar um banco de dados do AlloyDB Omni

Recomendamos seguir estas etapas ao configurar um banco de dados do AlloyDB Omni:

  1. Defina ou importe seus bancos de dados usando a função do usuário postgres. Em uma nova instalação, essa função tem privilégios de superusuário.

  2. Crie novas funções de usuário com o nível correto de acesso às tabelas do aplicativo, usando novamente a função do usuário postgres.

  3. Configure o aplicativo para se conectar ao banco de dados usando essas novas funções de acesso limitado.

Você pode criar e definir quantas funções de usuário forem necessárias. Não modifique nem exclua nenhuma das funções de usuário que vêm com o AlloyDB Omni.

Para mais informações, consulte Gerenciar usuários e papéis do AlloyDB Omni.

Instalar e iniciar o monitor do AlloyDB Omni

O monitor do AlloyDB Omni é um componente opcional que expõe métricas em um endpoint. É possível configurar servidores de monitoramento para buscar amostras de métricas desse endpoint e integrá-las à sua pilha de monitoramento.

Para instalar e iniciar o monitor, siga estas etapas em cada host que executa o serviço do AlloyDB Omni:

  1. Instale o pacote do monitor:

     sudo dnf install alloydbomni_monitor

  2. Ative e inicie o serviço de monitoramento:

     sudo systemctl enable alloydbomni_monitor
 sudo systemctl start alloydbomni_monitor

Configurar o monitor do AlloyDB Omni

Por padrão, o monitor é configurado para funcionar com o nome do serviço e o diretório de dados padrão do AlloyDB Omni. Se a instalação usar valores personalizados, configure o monitor usando um arquivo de substituição do systemd.

  1. Verifique a configuração padrão em /usr/lib/systemd/system/alloydbomni_monitor.service:

    • OMNI_SERVICE_NAME: o nome do serviço systemd do AlloyDB Omni (por exemplo, alloydbomni18).
    • PG_DATA_DIR: o caminho para o diretório de dados do banco de dados.

  2. Se você precisar substituir esses valores, crie um arquivo override.conf no diretório /etc/systemd/system/alloydbomni_monitor.service.d.

  3. Adicione o seguinte conteúdo ao arquivo override.conf, substituindo os valores pela sua configuração personalizada:

     [Service]
 Environment="OMNI_SERVICE_NAME=alloydbomni18"
 Environment="PG_DATA_DIR=/data/18/db"

  4. Atualize o daemon systemd:

     sudo systemctl daemon-reload

  5. Reinicie o serviço de monitoramento:

     sudo systemctl restart alloydbomni_monitor

Verificar o monitor do AlloyDB Omni

  1. Verifique se o serviço de monitoramento está em execução:

     sudo systemctl status alloydbomni_monitor

  2. Verifique se o monitor está expondo métricas fazendo uma chamada HTTP para o endpoint de métricas:

    curl http://localhost:9187/metrics

Limitações de monitoramento

As métricas relacionadas aos limites de CPU e memória do AlloyDB Omni só ficam visíveis se o ambiente tiver definido limites de CPU e memória para o serviço alloydbomni18 do systemd. As seguintes métricas são afetadas:

  • alloydb_omni_memory_limit_byte
  • alloydb_omni_memory_available_byte
  • alloydb_omni_node_cpu_mcpu

Se você quiser definir limites de CPU e memória, configure um arquivo de unidade do systemd. O exemplo a seguir configura CPUQuota como 90% e MemoryMax como 90%. Para mais informações sobre arquivos de unidade do systemd, consulte Como trabalhar com arquivos de unidade do systemd.

  1. Crie um arquivo de configuração de substituição do systemd.

    Crie um arquivo override.conf no diretório /etc/systemd/system/alloydbomni18.service.d.

  2. Adicione o seguinte conteúdo ao arquivo override.conf:

     [Service]
 CPUQuota=90%
 MemoryMax=90%

  3. Atualize o daemon systemd:

     sudo systemctl daemon-reload

  4. Reinicie o serviço do AlloyDB Omni:

     sudo systemctl restart alloydbomni18

Monitorar o AlloyDB Omni

O monitoramento da instalação do AlloyDB Omni inclui buscar e analisar métricas do AlloyDB Omni.

Para recuperar os registros do AlloyDB Omni, execute:

  sudo journalctl -u alloydbomni18

Desinstalar o AlloyDB Omni

Para desinstalar o AlloyDB Omni, execute:

  sudo dnf remove alloydbomni_monitor