Usar as ferramentas de monitoramento do AlloyDB Omni

Selecione uma versão da documentação:

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 podem ser escolhidas e instaladas para monitorar sua instância do AlloyDB Omni:

Para Usar Descrição
Monitorar a performance e a disponibilidade Datadog Monitore a performance, a disponibilidade e a integridade da sua instância do AlloyDB Omni.
Exportar dados de observabilidade da instância Postgres Exporter Exporte 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 métricas. Para instalar o Grafana
Recuperar dados de performance para análise Relatórios de snapshot de performance Recupere dados de performance para identificar a causa dos problemas de performance.

Instalar o Postgres Exporter

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 dependendo das suas necessidades. Outras opções de segurança, como SSL e autenticação do usuário, também podem ser configuradas. Para este exemplo, apenas as opções de configuração básicas são usadas.

Instalar

  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 criado.

    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 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 às 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 Postgres Exporter está hospedado. Recomendamos o uso da porta 9187.
  8. Atualize 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 estará 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. Atualize a configuração do gerenciador systemd.

    sudo systemctl daemon-reload
    
  11. Inicie o Prometheus.

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

O Prometheus agora estará 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 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 disponíveis. O Grafana está disponível nos repositórios apt e yum normais, e usamos esses repositórios 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. Atualize 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 estará 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

Instruções gerais sobre como configurar e operar o Grafana estão disponíveis 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 de instalação do Grafana . O nome de usuário e a senha padrão são admin.

    2. Altere a senha padrão.

    3. Se a fonte de dados do Prometheus não for adicionada, navegue até Home > Data sources.

    4. Clique em Add new data source.

    5. Selecione Prometheus.

    6. No campo Prometheus server URL, insira o endereço URL da seção de instalação do Prometheus' Install.

    7. Altere as seguintes configurações:

      • Prometheus type: selecione Prometheus.
      • Versão do Prometheus: selecione > 2.5.x.
    8. Clique em Save &test.

  2. Crie um novo painel.

    1. Navegue até Home > Dashboards.

    2. Clique em New.

    3. Selecione New dashboard.

    4. Clique em Import dashboard.

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

    6. Clique em Load.

    7. Mude o Name 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 Import.

Relatórios de snapshot de performance

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

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