Usar as ferramentas de monitoramento do AlloyDB Omni

Selecione uma versão da documentação:

Nesta página, listamos 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 escolher e instalar 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) Exportar os resultados das consultas de observabilidade. Para instalar o Postgres Exporter
Recuperar 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
Recuperar dados de performance para análise Relatórios de visão geral da performance Recupere dados de performance 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 vem com muitas consultas padrão integradas, e você pode adicionar outras consultas e regras de acordo com suas necessidades. Outras opções de segurança, como SSL e autenticação de usuário, também podem ser configuradas. Neste exemplo, apenas as opções básicas de configuração são usadas.

Instalar

  1. Crie um diretório para o exportador do Postgres.

    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 ao /opt/postgres_exporter/postgres_exporter.env para monitorar um ou mais bancos de dados.

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

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

    Para monitorar todos os bancos de dados, adicione a seguinte 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: porta em que o exportador do Postgres está hospedado. Recomendamos usar a porta 9187.
  8. Recarregue o exportador do Postgres.

    sudo systemctl daemon-reload
    
  9. Inicie o exportador do Postgres.

    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: porta usada na etapa 7.

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.

Instalar

  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 para 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 para 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 seguintes informações 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 às 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.

Grafana

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

Instalar

  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 seguinte painel de estatísticas do PostgreSQL.

Para carregar um painel, conclua as seguintes tarefas:

  1. Configure o Grafana.

    1. Abra o console do Grafana usando o endereço URL da seção Instalar do Grafana. 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 Página inicial > Fontes de dados.

    4. Clique em Adicionar nova fonte de dados.

    5. Selecione Prometheus.

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

    7. Mude as seguintes configurações:

      • Tipo do Prometheus: selecione Prometheus.
      • Versão do Prometheus: selecione > 2.5.x.
    8. Clique em Salvar e testar.

  2. Crie um painel.

    1. Acesse Início > Painéis.

    2. Clique em Novo.

    3. Selecione Novo painel.

    4. Clique em Importar painel.

    5. Insira 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 produto.

    8. Selecione sua fonte de dados no campo Prometheus.

    9. Clique em Importar.

Relatórios de resumo da performance

Os relatórios de visão geral de desempenho são uma ferramenta integrada do AlloyDB Omni que captura e analisa dados de desempenho para ajudar você a identificar a causa dos problemas de desempenho. Essa ferramenta complementa outros recursos de observabilidade do AlloyDB Omni, como insights do sistema, insights de consultas 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.