Esta página documenta a versão 18.1.0 do AlloyDB Omni usando a opção de implantação do Linux. Escolha outra opção de implantação.

Gerenciar e monitorar o AlloyDB Omni

Selecione uma versão da documentação:

Nesta página, descrevemos como gerenciar 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.
Todas as outras funções de usuário predefinidas não têm privilégios. Elas são reservadas 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:

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.
Crie novas funções de usuário que tenham o nível correto de acesso às tabelas do aplicativo, novamente usando a função do usuário postgres.
Configure o aplicativo para se conectar ao banco de dados usando essas novas funções de acesso limitado.

É possível criar e definir quantas novas funções de usuário forem necessárias. Não modifique nem exclua nenhuma das funções de usuário que acompanham 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:

Instale o pacote do monitor:
```
 sudo dnf install alloydbomni_monitor
```

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.

Verifique a configuração padrão em /usr/lib/systemd/system/alloydbomni_monitor.service:
- OMNI_SERVICE_NAME: o nome do serviço do systemd do AlloyDB Omni (por exemplo, alloydbomni18).
- PG_DATA_DIR: o caminho para o diretório de dados do banco de dados.
Se você precisar substituir esses valores, crie um override.conf arquivo no /etc/systemd/system/alloydbomni_monitor.service.d diretório.
Adicione o conteúdo a seguir ao arquivo override.conf, substituindo os valores pela configuração personalizada:
```
 [Service]
 Environment="OMNI_SERVICE_NAME=alloydbomni18"
 Environment="PG_DATA_DIR=/data/18/db"
```
Atualize o daemon do systemd:
```
 sudo systemctl daemon-reload
```

Reinicie o serviço de monitoramento:

 sudo systemctl restart alloydbomni_monitor

Verificar o monitor do AlloyDB Omni

Verifique se o serviço de monitoramento está em execução:
```
 sudo systemctl status alloydbomni_monitor
```
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 do monitor

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 do systemd alloydbomni18. As métricas afetadas são:

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 Trabalhar com arquivos de unidade do systemd.

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

Crie um arquivo override.conf no /etc/systemd/system/alloydbomni18.service.d diretório.
Adicione o conteúdo a seguir ao arquivo override.conf:
```
 [Service]
 CPUQuota=90%
 MemoryMax=90%
```
Atualize o daemon do systemd:
```
 sudo systemctl daemon-reload
```
Reinicie o serviço do AlloyDB Omni:
```
 sudo systemctl restart alloydbomni18
```

Monitorar o AlloyDB Omni

O monitoramento da instalação do AlloyDB Omni inclui a busca e a análise de 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