Escolher e instalar ferramentas de monitoramento do AlloyDB Omni

Observação: O uso do AlloyDB Omni está sujeito ao contrato entre você e o Google que rege as Google Cloud ofertas. Se você não tiver uma Google Cloud conta ou não tiver celebrado um acordo com o Google que governe as Google Cloud ofertas, não prossiga nem faça o download deste software até que o faça. Para criar uma Google Cloud conta, consulte a Google Cloud página inicial.

Esta página lista as ferramentas que podem ser usadas para monitorar sua instância do AlloyDB Omni.

Ferramentas de monitoramento

A tabela a seguir lista as ferramentas que você pode usar para monitorar sua instância do AlloyDB Omni:

Para	Usar	Descrição
Monitorar a performance e a disponibilidade	Datadog	Monitore o desempenho, a disponibilidade e a integridade da sua instância do AlloyDB Omni.
Exportar dados de observabilidade da sua instância	Postgres Exporter (em inglês)	Exporte os resultados das consultas de observabilidade. Para instalar o Postgres Exporter
Extrair dados de observabilidade em um formato legível	Prometheus	Sistema de monitoramento para retornar os dados de observabilidade em um formato legível. Para instalar o Prometheus
Mostrar dados em um painel	Grafana	Crie um painel para mostrar as métricas. Para instalar o Grafana
Extrair dados de performance para análise	Relatórios de snapshot de performance	Extraia dados de desempenho para identificar a causa dos problemas.

Instalar o exportador do Postgres

O Postgres Exporter é uma ferramenta que exporta consultas de observabilidade em um formato que o Prometheus, um sistema de monitoramento, pode ler. O exportador tem muitas consultas padrão integradas, e você pode adicionar outras consultas e regras dependendo das suas necessidades. Outras opções de segurança, como SSL e autenticação do usuário, também podem ser configuradas. Neste exemplo, apenas as opções de configuração básicas são usadas.

Para instalar o Postgres Exporter, siga estas etapas:

1. Crie um diretório para o Postgres Exporter.

   sudo mkdir /opt/postgres_exporter
   sudo chown USER_ACCOUNT:USER_ACCOUNT /opt/postgres_exporter
   cd /opt/postgres_exporter

2. Faça o download do Postgres Exporter.

   wget https://github.com/prometheus-community/postgres_exporter/releases/download/v0.15.0/postgres_exporter-0.15.0.linux-amd64.tar.gz
   

3. Extraia o Postgres Exporter.

   tar -xzvf postgres_exporter-0.15.0.linux-amd64.tar.gz
   

4. Copie o Postgres Exporter para o diretório que você criou.

   cd postgres_exporter-0.15.0.linux-amd64
   sudo cp postgres_exporter /usr/local/bin

5. Crie um arquivo .env adequado para o Postgres Exporter.

   cd /opt/postgres_exporter
   sudo vi postgres_exporter.env

6. Adicione fontes de dados a /opt/postgres_exporter/postgres_exporter.env para monitorar um ou mais bancos de dados.

   Para monitorar um único banco de dados, adicione esta linha:

   DATA_SOURCE_NAME="postgresql://USERNAME:PASSWORD@POSTGRES_IP_ADDRESS:PORT/DATABASE_NAME?sslmode=disable"
   

   Para monitorar todos os bancos de dados, adicione esta linha:

   DATA_SOURCE_NAME="postgresql://USERNAME:PASSWORD@POSTGRES_IP_ADDRESS:PORT/?sslmode=disable"
   

   Substitua as seguintes variáveis:

   • USERNAME: nome de usuário para fazer login no banco de dados.
   • PASSWORD: senha da conta de usuário.
   • POSTGRES_IP_ADDRESS: endereço IP da instância do AlloyDB Omni.
   • PORT: porta em que o banco de dados está hospedado.
   • DATABASE_NAME: nome do banco de dados.

7. Adicione as seguintes informações a /etc/systemd/system/postgres_exporter.service para que o Postgres Exporter sobreviva a reinicializações.

   [Unit]
   Description=Prometheus exporter for Postgresql
   Wants=network-online.target
   After=network-online.target
   [Service]
   User=postgres
   Group=postgres
   WorkingDirectory=/opt/postgres_exporter
   EnvironmentFile=/opt/postgres_exporter/postgres_exporter.env
   ExecStart=/usr/local/bin/postgres_exporter --web.listen-address=:POSTGRES_EXPORTER_PORT --web.telemetry-path=/metrics
   Restart=always
   [Install]
   WantedBy=multi-user.target
   

   Substitua a seguinte variável:

   • POSTGRES_EXPORTER_PORT: a porta em que o exportador do Postgres está hospedado. Recomendamos o uso da porta 9187.

8. Recarregue o Postgres Exporter.

   sudo systemctl daemon-reload
   

9. Inicie o Postgres Exporter.

   sudo systemctl start postgres_exporter
   sudo systemctl enable postgres_exporter
   sudo systemctl status postgres_exporter

O Postgres Exporter agora está disponível no seguinte URL:

http://POSTGRES_EXPORTER_HOST_IP_ADDRESS:POSTGRES_EXPORTER_PORT/metrics

Substitua as seguintes variáveis:

• POSTGRES_EXPORTER_HOST_IP_ADDRESS: endereço IP da sua máquina.
• POSTGRES_EXPORTER_PORT: a porta usada na etapa 7.

Instalar o Prometheus

O Prometheus é um sistema de monitoramento que pode ser usado para consultar o Postgres Exporter e retornar os dados de observabilidade em um formato legível.

Para instalar o Prometheus, siga estas etapas:

1. Crie um usuário prometheus.

   sudo groupadd --system prometheus
   sudo useradd -s /sbin/nologin --system -g prometheus prometheus

2. Crie diretórios para o Prometheus.

   sudo mkdir /etc/prometheus
   sudo mkdir /var/lib/prometheus

3. Faça o download do Prometheus.

   wget https://github.com/prometheus/prometheus/releases/download/v2.52.0/prometheus-2.52.0.linux-amd64.tar.gz
   

4. Extraia o Prometheus.

   sudo tar xvf prometheus*.tar.gz
   cd prometheus*/
   sudo mv prometheus /usr/local/bin
   sudo mv promtool /usr/local/bin

5. Defina a propriedade do Prometheus como o usuário prometheus.

   sudo chown prometheus:prometheus /usr/local/bin/prometheus
   sudo chown prometheus:prometheus /usr/local/bin/promtool

6. Mova os arquivos de configuração para o local correto.

   sudo mv consoles /etc/prometheus
   sudo mv console_libraries /etc/prometheus
   sudo mv prometheus.yml /etc/prometheus

7. Defina a propriedade dos diretórios do Prometheus como o usuário prometheus.

   sudo chown prometheus:prometheus /etc/prometheus
   sudo chown prometheus:prometheus /etc/prometheus/*
   sudo chown -R prometheus:prometheus /etc/prometheus/consoles
   sudo chown -R prometheus:prometheus /etc/prometheus/console_libraries
   sudo chown -R prometheus:prometheus /var/lib/prometheus

8. Adicione as informações a seguir a /etc/prometheus/prometheus.yml para que o Prometheus possa consultar o Postgres Exporter.

   global:
     scrape_interval: 15s
   
   scrape_configs:
   - job_name: postgres
     static_configs:
     - targets: ['POSTGRES_EXPORTER_MACHINE_IP_ADDRESS:9187']
   

9. Adicione as seguintes informações a /etc/systemd/system/prometheus.service para que o Prometheus sobreviva a reinicializações.

   [Unit]
   Description=Prometheus
   Wants=network-online.target
   After=network-online.target
   
   [Service]
   User=prometheus
   Group=prometheus
   Type=simple
   ExecStart=/usr/local/bin/prometheus \
       --config.file /etc/prometheus/prometheus.yml \
       --storage.tsdb.path /var/lib/prometheus/ \
       --web.console.templates=/etc/prometheus/consoles \
       --web.console.libraries=/etc/prometheus/console_libraries
   
   [Install]
   WantedBy=multi-user.target
   

10. Recarregue o Prometheus.

    sudo systemctl daemon-reload
    

11. Inicie o Prometheus.

    sudo systemctl start prometheus
    sudo systemctl enable prometheus
    sudo systemctl status prometheus

O Prometheus agora está disponível no seguinte URL:

http://PROMETHEUS_HOST_IP_ADDRESS:9090

Substitua a seguinte variável:

• PROMETHEUS_HOST_IP_ADDRESS: endereço IP da sua máquina.

Instalar o Grafana

O Grafana é uma ferramenta de painel que expõe as métricas do Prometheus a um usuário final por meio de um painel. Vários painéis padrão estão disponíveis para o Postgres Exporter, e este exemplo de observabilidade aproveita esses painéis. O Grafana está disponível nos repositórios apt e yum normais, que usamos para instalar o produto.

Para instalar o Grafana, siga estas etapas:

1. Instale o Grafana.

   Para sistemas Ubuntu e Debian, execute os seguintes comandos:

   sudo apt-get update
   sudo apt-get install grafana

   Para sistemas RHEL, CentOS ou Rocky Linux, conclua as seguintes tarefas:

   1. Importe a chave GPG.

      wget -q -O gpg.key https://rpm.grafana.com/gpg.key
      sudo rpm --import gpg.key

   2. Crie o arquivo /etc/yum.repos.d/grafana.repo com o seguinte conteúdo:

      [grafana]
      name=grafana
      baseurl=https://rpm.grafana.com
      repo_gpgcheck=1
      enabled=1
      gpgcheck=1
      gpgkey=https://rpm.grafana.com/gpg.key
      sslverify=1
      sslcacert=/etc/pki/tls/certs/ca-bundle.crt
      

   3. Instale o Grafana.

      sudo dnf install grafana
      

2. Recarregue o Grafana.

   sudo systemctl daemon-reload
   

3. Inicie o Grafana.

   sudo systemctl start grafana-server
   sudo systemctl enable grafana-server
   sudo systemctl status grafana-server

O Grafana agora está disponível no seguinte URL:

http://GRAFANA_HOST_IP_ADDRESS:9090

Substitua a seguinte variável:

• GRAFANA_HOST_IP_ADDRESS: endereço IP da sua máquina.

Carregar um painel

Confira instruções gerais sobre como configurar e operar o Grafana em Configurar o Grafana. Há muitos painéis públicos disponíveis, mas recomendamos o painel de estatísticas do PostgreSQL.

Para carregar um painel, siga estas etapas:

1. Configure o Grafana.

   1. Abra o console do Grafana usando o endereço do URL da seção Install. O nome de usuário e a senha padrão são admin.

   2. Mude a senha padrão.

   3. Se a fonte de dados do Prometheus não for adicionada, acesse Início > Fontes de dados.

   4. Clique em Adicionar nova fonte de dados.

   5. Selecione Prometheus.

   6. No campo URL do servidor do Prometheus, insira o endereço do URL da seção Instalação do Prometheus.

   7. Mude as seguintes configurações:

      • Tipo Prometheus: selecione Prometheus.
      • Versão do Prometheus: selecione > 2.5.x.

   8. Clique em Salvar e testar.

2. Crie um novo painel.

   1. Acesse Início > Painéis.

   2. Clique em Novo.

   3. Selecione Novo painel.

   4. Clique em Importar painel.

   5. Digite o seguinte URL: https://grafana.com/grafana/dashboards/13494-postgresql-statistics/.

   6. Clique em Carregar.

   7. Mude o Nome do painel para PRODUCT_NAME PostgreSQL statistics.

      Substitua PRODUCT_NAME pelo nome do seu produto.

   8. Selecione sua fonte de dados no campo Prometheus.

   9. Clique em Importar.

Relatórios de resumo de performance

Os relatórios de resumo de desempenho são uma ferramenta integrada do AlloyDB Omni que captura e analisa dados de desempenho para ajudar a identificar a causa de problemas de desempenho. Essa ferramenta complementa outros recursos de observabilidade do AlloyDB Omni, como insights de sistemas, insights de consulta e o Metrics Explorer, que fornecem métricas em tempo real sobre sua instância.

Para mais informações, consulte Otimizar o desempenho do banco de dados comparando snapshots de desempenho.